トラブルシューティング
一般的な問題
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 <public_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
サーバーのすべてのユーザーのキャッシュがリセットされるはずです。
Dockerインストールの場合、すべての操作はコンテナ内で実行する必要があることに注意してください。
HTTPSの問題
Q: 自己署名SSL証明書を追加したところ、SSOメタデータページを開く際や、WebDAVおよび他のnode.jsサービスを使用する際にエラーが発生します。これを修正するにはどうすればいいですか?
A: 自己署名SSL証明書を使用する際にSSOメタデータ、WebDAV、および他のnode.jsサービスで問題が発生した場合、この問題を解決するために次のオプションのいずれかを試すことができます:
オプション1 - サービス起動のためのパラメータを追加します。
-
onlyofficeSsoAuth.serviceファイルを開きます(CommunityServerコンテナ内):nano /lib/systemd/system/onlyofficeSsoAuth.service -
[Service]ブロックの末尾に、ルート証明書のパスを指定する次の文字列を追加します:Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem -
サービスを再起動します:
systemctl daemon-reloadsystemctl restart onlyofficeSsoAuth
オプション2 - システムの証明書バンドルを使用します。
-
onlyofficeSsoAuth.serviceファイルを開きます(CommunityServerコンテナ内):nano /lib/systemd/system/onlyofficeSsoAuth.service -
[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 -
CentOSの場合、さらに次の文字列を追加して、証明書バンドルのパスを
[Service]ブロックの末尾に指定します:Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt -
サービスを再起動します:
systemctl daemon-reloadsystemctl restart onlyofficeSsoAuth
Dockerの問題
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を使用することを検討してください。
ONLYOFFICE Docsの使用に関する問題
Q: ONLYOFFICE Docs を停止した際にデータが失われました。データ損失を防ぐにはどうすればよいですか?
A: 運用上の特性により、ONLYOFFICE Docs は、編集したすべてのユーザーがドキュメントを閉じた後にのみドキュメントを保存します。データ損失を防ぐためには、アプリケーションの更新やサーバーの再起動などで ONLYOFFICE Docs を停止する必要がある場合、ONLYOFFICE Docs のユーザーを強制的に切断する必要があります。これを行うには、ONLYOFFICE Docs がインストールされているサーバーで次のスクリプトを実行してください:
sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh
スクリプトの実行には時間がかかる場合があります(最大5分)。
ユーザーの切断には時間がかかる場合があります(最大5分)。