トラブルシューティング

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

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

Q:ポータルを作成して入ると、Peopleモジュールに「fake user」という名前の未知のユーザーが表示されます。また、サービスリストに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の場合、さらに次の文字列を追加して、証明書バンドルのパスを[Service]ブロックの末尾に指定します：

   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を無効にしてみてください。それで問題が解決する場合は、RedHatが推奨していないためSELinuxを無効にしたままにするか、Ubuntuを使用することを検討してください。

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

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

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh