トラブルシューティング

Q:Dockerベースのサーバーをローカルサーバーにインストールしたいのですが、どうすればいいですか？

A:最新のDockerベースのオンラインオフィスサーバーはDocker hubで入手可能です。インストールしたいものを選択してください：ONLYOFFICE Docs、ONLYOFFICE Workspace、またはONLYOFFICE Mail、そして適切なページの指示に従ってください。

Q:ポータルを作成して入ると、「偽ユーザー」という名前の不明なユーザーがPeopleモジュールに表示されます。また、サービスリストにOnlyofficeHealthCheckというサービスもあります。これはなぜですか？何か対処が必要ですか？

A:このユーザーとサービスは、将来のリリースでポータル向けに提供される予定のHealth Check機能の一部です。現時点では機能していないため、そのままにしておくか、OnlyofficeHealthCheckサービスを無効にしてサービスの自動起動リストから削除することができます。

Q:サーバーソリューションをインストールして正常に使用するために必要なシステムは何ですか？

A:システム要件は以下の通りです：

• CPU
  デュアルコア2 GHz以上
• RAM
  4 GB以上
• HDD
  少なくとも20 GBの空き容量
• SWAP
  少なくとも4 GB、ただしホストOSによります。多いほど良いです。
• OS
  amd64 Linuxディストリビューションでカーネルバージョン3.10以降
• 追加要件
  • Docker：Dockerチームがサポートするバージョン

Q:Dockerサービスを使用してサーバーバージョンの1つをインストールしましたが、DNSサーバーや独自の名前解決に関連する問題があります。何が問題でしょうか？

A:DockerはデフォルトでGoogle DNSサーバーを指定しており、サーバーはネットワーク要求を行うたびにそれらに接続しようとします。ONLYOFFICE Workspace、ONLYOFFICE Docs、またはONLYOFFICE Mailがインターネットにアクセスしない場合は、デフォルトのDocker DNSアドレスをローカルDNSサーバーのアドレスに変更することをお勧めします。これを行うには、/etc/default/dockerファイルに移動し、次の行のIPアドレスをローカルネットワーク内のDNSサーバーのIPアドレスに変更してください：

docker_OPTS="--dns 8.8.8.8"

CentOSのようなRPMベースのオペレーティングシステムの場合、設定ファイルはここにあります：/etc/docker/daemon.json

Q:ドキュメントエディターが開き、インターフェースが表示されますが、ドキュメント自体が読み込まれず、読み込み進行が表示され続けます。どうすればいいですか？

A:原因は、コンピューターがインターネットループバックアクセスを使用して自分自身にアクセスできる必要があることです。つまり、外部から自分自身にアクセス可能でなければなりません。これを許可するには、iptablesを編集して次のようなリダイレクトを設定します：

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <piblic_ip>

public_ipとlocal_ipのアドレスを実際のIPアドレスに置き換えることを忘れないでください。

Q:カスタムインターフェーステーマを追加したり、エディターの言語ファイルを更新したりしましたが、サーバーは依然として以前の値を表示します。すべてのユーザーのキャッシュを同時にリセットするにはどうすればいいですか？

A:キャッシュをリセットする手順は次のとおりです：
/etc/nginx/includes/ds-docservice.confと/etc/nginx/includes/ds-spellchecker.confファイルを見つけます。そこにビルドの日付と時刻の値があります。これらの値を他の値に変更します（どの値でも構いませんが、すべての場所で同じである必要があります）、そしてNGINXを再起動します：

sudo service nginx reload

サーバーのすべてのユーザーのキャッシュがリセットされるはずです。

Q:自己署名SSL証明書を追加した後、SSOメタデータページを開く際やWebDAVおよび他のnode.jsサービスを使用する際にエラーが発生します。これを解決するにはどうすればいいですか？

A:自己署名SSL証明書を使用してSSOメタデータ、WebDAV、および他のnode.jsサービスに問題が発生した場合、この問題を解決するために次のオプションのいずれかを試すことができます：

オプション1 - サービス起動のためのパラメータを追加します。

1. onlyofficeSsoAuth.serviceファイルを開きます（CommunityServerコンテナ内）：

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. [Service]ブロックの末尾にルート証明書のパスを指定する次の文字列を追加します：

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. サービスを再起動します：

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

オプション2 - システムの証明書バンドルを使用します。

1. onlyofficeSsoAuth.serviceファイルを開きます（CommunityServerコンテナ内）：

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. [Service]ブロック内で次の文字列を見つけます：

   ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

   それを次のものに置き換えます：

   ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

3. CentOSの場合、さらに次の文字列を追加して、証明書バンドルのパスを指定します：

   Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

4. サービスを再起動します：

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Q：docker stop idコマンドでDockerコンテナを停止せずにサーバーを再起動したところ、サーバーにERR_TOO_MANY_REDIRECTSエラーが発生しました。これを修正するにはどうすればよいですか？

A：/var/www/onlyoffice/WebStudio/web.appsettings.configファイルを編集し、最終行を削除してください：

<add key="web.warmup.type" value="basic" />

そして、以下のコマンドでmonoserveを再起動してください：

sudo service monoserve restart

Q：Fedora Linuxを使用しており、Dockerコンテナ内でプロセスが起動しません。この問題を解決する方法はありますか？

A：FedoraおよびRHEL/CentOSのユーザーは、setenforce 0コマンドでSELinuxを無効にしてみてください。これで問題が解決する場合は、SELinuxを無効にしたままにするか（RedHatでは推奨されていません）、Ubuntuを使用することを検討してください。

Q：ONLYOFFICE Docsを停止した際にデータが失われました。データ損失を防ぐにはどうすればよいですか？

A：運用上の特性により、ONLYOFFICE Docsは、編集したすべてのユーザーがドキュメントを閉じた後にのみドキュメントを保存します。データ損失を避けるためには、アプリケーションの更新やサーバーの再起動などでONLYOFFICE Docsを停止する必要がある場合、ONLYOFFICE Docsのユーザーを強制的に切断する必要があります。そのためには、ONLYOFFICE Docsがインストールされているサーバーで以下のスクリプトを実行してください：

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh