トラブルシューティング
一般的な問題
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 <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を無効にしてみてください。これで問題が解決する場合は、SELinuxを無効にしたままにするか(RedHatでは推奨されていません)、Ubuntuを使用することを検討してください。
ONLYOFFICE Docsの使用に関する問題
Q: ONLYOFFICE Docs を停止した際にデータが失われました。データ損失を防ぐにはどうすればよいですか?
A: 運用上の特性により、ONLYOFFICE Docs は、編集したすべてのユーザーがドキュメントを閉じた後にのみドキュメントを保存します。データ損失を避けるためには、アプリケーションの更新やサーバーの再起動などで ONLYOFFICE Docs を停止する必要がある場合、ONLYOFFICE Docs のユーザーを強制的に切断する必要があります。そのためには、ONLYOFFICE Docs がインストールされているサーバーで以下のスクリプトを実行してください:
sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh
スクリプトの実行には時間がかかる場合があります(最大5分)。
ユーザーの切断には時間がかかる場合があります(最大5分)。