メインコンテンツまでスキップ

CentOSまたはRHELにおけるarm64向けONLYOFFICE Docsのインストール

はじめに​

このガイドでは、arm64向けのCentOS Stream 9および10、ならびにRHEL 8、9、10にONLYOFFICE Docs コミュニティ版 Linuxバージョン7.1以降をインストールする方法を示します。利用可能な機能の完全なリストについては、ONLYOFFICE Docsのエディションの概要をご覧ください。ONLYOFFICE Workspaceを使用している場合、Docsをインストールすると、ファイルの共有、アクセス権の管理、ドキュメントの埋め込み、接続されたクラウドストレージのファイルの編集も可能になります。

システム要件​

  • CPU：64ビットARMプロセッサ
  • RAM：最低2 GB、ただしホストOSに依存。多いほど良い
  • HDD：最低40 GBの空き容量
  • SWAP：最低4 GB、ただしホストOSに依存。多いほど良い
  • OS：arm64向けのCentOS Stream 9または10、RHEL 8、RHEL 9、またはRHEL 10
  • 追加要件
    • NGINX：バージョン1.30以上

依存関係のインストール​

最新のNGINXパッケージバージョンのインストール​

RHEL/CentOS用のyumリポジトリを設定するには、/etc/yum.repos.d/nginx.repoという名前のファイルを作成し、次の内容を記述します：

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

NGINXをインストールします：

sudo yum install nginx

以下のファイルを削除します：

sudo rm /etc/nginx/conf.d/default.conf

公式インストラクション

その後、/etc/nginx/nginx.confのNGINX設定ファイルを編集し、次のようにします：

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}
重要

ONLYOFFICE Docsをポート80で実行する予定の場合は、ここでNGINXのデフォルトWebサイトを無効にしてください。無効にしないと、ONLYOFFICE Docsが正しく動作しない可能性があります。そのためには、次のコマンドを実行します：

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

NGINXのインストール方法によっては、最初の2つのコマンドのいずれかでファイルが存在しないと表示される場合があります。このメッセージは無視してかまいません。

EPELリポジトリのインストール​

sudo yum install epel-release

CentOS 9にEPELをインストールするには、次のコマンドを使用します：

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

RHELにEPELをインストールするには、次のコマンドを使用します：

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

$REVを手動でOSバージョンに変更します（バージョン8.xの場合は8、9.xの場合は9など）。

ONLYOFFICE Docsのインストール​

ONLYOFFICE Docsリポジトリの追加​

次のコマンドでyum ONLYOFFICE Docsリポジトリを追加します：

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

ONLYOFFICE Docsのインストールコマンド​

コミュニティ版のために次のコマンドを実行します：

sudo yum install onlyoffice-documentserver

nginxサービスを開始し、起動時に自動的に開始するように設定します：

sudo service nginx start
sudo systemctl enable nginx

その後、ONLYOFFICE Docsはプロセスとして実行されます。パッケージは他のrpmパッケージと同様に更新されます。

ONLYOFFICE Docsの更新​

ONLYOFFICE Docsを更新するには、次のコマンドを実行します：

sudo yum update onlyoffice-documentserver
重要

RHEL 8およびその派生版では、ONLYOFFICEリポジトリが有効な状態でyum updateを実行すると、依存関係エラーで失敗する場合があります。

これを防ぐには、これらのパッケージをONLYOFFICEリポジトリから除外し、代わりにシステムのAppStreamリポジトリから取得されるようにします：

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

このコマンドは一度だけ実行する必要があります。その後、yum updateは正常に動作します。

OneClick InstallでONLYOFFICE Docsをインストールした場合、この除外はすでに自動的に適用されています。

デフォルトのONLYOFFICE Docsポートを変更する​

デフォルトでは、ONLYOFFICE Docsはポート8083を使用して受信接続をリッスンします。バージョン4.3以降、デフォルトのポートの代わりに使用する予定がある場合は、ONLYOFFICE Docsのポートを変更できます。

注記

デフォルトのポートを変更する場合は、受信/送信接続のためにポートが開いていることを確認してください。ONLYOFFICE Docsで使用されるポートの完全なリストを参照してください。

そのためには、次のコマンドを実行してDS_PORT環境変数を編集する必要があります：

export DS_PORT=<PORT_NUMBER>

上記のコマンドで<PORT_NUMBER>の代わりにポート番号を記入してください。

注記

ポートを80に設定する場合は、最新のNGINXパッケージバージョンのインストールセクションの説明に従ってNGINXのデフォルトWebサイトを無効にしていることを確認してください。

警告

ONLYOFFICE DocsのプロトコルをHTTPSに変更したい場合、ポートを443に変更せず、代わりにこの手順を使用してください。

その後、ONLYOFFICE Docsの設定を続行できます。

ONLYOFFICE Docsの設定​

設定スクリプトを実行する​

documentserver-configureスクリプトを実行します：

bash documentserver-configure

ファイアウォール例外を追加する​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

SELinuxを無効にする​

注記

v.5.0以降非推奨

任意のテキストエディタを使用して/etc/selinux/configファイルを開き、SELINUX=enforcingまたはSELINUX=permissiveの文字列をSELINUX=disabledに置き換え、変更を保存します。

変更を有効にするためにサーバーを再起動してください。

ブラウザでONLYOFFICE Docsを起動する​

設定が完了したら、ブラウザのアドレスバーにhttp://localhost:8083を入力してONLYOFFICE Docsのウェルカムページを開き、ドキュメントのサンプルを有効にする方法や、提供されたAPIを使用してオンラインエディターをウェブアプリケーションに統合する方法についてのさらなる指示を見つけてください。