Ana içeriğe geç

ONLYOFFICE Docs'u CentOS veya RHEL çalıştıran ARM64 sistemlere kurma

Giriş​

Developer Edition, ONLYOFFICE Docs'u yerel sunucunuza kurmanıza ve çevrimiçi editörleri web uygulamanızla entegre etmenize olanak tanır (özelliklerin ayrıntılı listesine bakın). Bu kılavuz, ONLYOFFICE Docs Developer Edition 7.1 ve üzeri sürümlerini 64 bit ARM mimarisine sahip CentOS Stream 9, RHEL 8 ve RHEL 9 üzerine nasıl kuracağınızı gösterir.

Sistem gereksinimleri​

  • CPU: 64 bit ARM işlemciler
  • RAM: en az 2 GB, ancak ana işletim sistemine bağlıdır. Daha fazlası daha iyidir
  • HDD: en az 40 GB boş alan
  • SWAP: en az 4 GB, ancak ana işletim sistemine bağlıdır. Daha fazlası daha iyidir
  • OS: arm64 için CentOS Stream 9, RHEL 8 veya RHEL 9
  • Ek gereksinimler:
    • PostgreSQL: 12.9 veya üzeri sürüm
    • NGINX: 1.3.13 veya üzeri sürüm
    • Redis: 5 veya üzeri sürüm
    • RabbitMQ

Bağımlılıkları kurma​

NGINX paketinin güncel sürümünü kurma​

RHEL/CentOS için yum deposunu ayarlamak üzere aşağıdaki içerikle /etc/yum.repos.d/nginx.repo adlı dosyayı oluşturun:

[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'i kurun:

sudo yum install nginx

Aşağıdaki dosyayı kaldırın:

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

Resmi talimat

Ardından /etc/nginx/nginx.conf NGINX yapılandırma dosyasını aşağıdaki gibi görünecek şekilde düzenleyin:

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;
}
Önemli

ONLYOFFICE Docs'u 80 numaralı bağlantı noktasında çalıştırmayı planlıyorsanız, varsayılan NGINX web sitesini şimdi devre dışı bırakın. Aksi takdirde ONLYOFFICE Docs düzgün çalışmayabilir. Bunun için aşağıdaki komutları çalıştırın:

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'in nasıl kurulduğuna bağlı olarak ilk iki komuttan biri dosyanın bulunmadığını bildirebilir. Bu iletiyi güvenle yok sayabilirsiniz.

EPEL deposunu kurma​

sudo yum install epel-release

CentOS 9'a EPEL kurmak için aşağıdaki komutları kullanın:

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

RHEL'e EPEL kurmak için aşağıdaki komutları kullanın:

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 değerini işletim sisteminizin sürümüne göre elle değiştirin (8.x sürümleri için 8, 9.x sürümleri için 9 vb.).

PostgreSQL'i kurma ve yapılandırma​

CentOS sürümünüzle birlikte gelen PostgreSQL sürümünü kurun:

sudo yum install postgresql postgresql-server
not

PostgreSQL Deposu'ndan başka bir PostgreSQL sürümü kurmak istiyorsanız ayrıntılar için resmi PostgreSQL belgelerine bakın.

PostgreSQL veritabanını başlatın

sudo service postgresql initdb
sudo chkconfig postgresql on

IPv4 ve IPv6 localhost için 'scram-sha-256' kimlik doğrulama yöntemini etkinleştirin

/var/lib/pgsql/data/pg_hba.conf dosyasını bir metin düzenleyicide açın.

host all all 127.0.0.1/32 ident satırını bulun ve aşağıdaki satırla değiştirin:

host    all             all             127.0.0.1/32            scram-sha-256

Ardından host all all ::1/128 ident satırını bulun ve aşağıdaki satırla değiştirin:

host    all             all             ::1/128                 scram-sha-256

Değişiklikleri kaydedin.

/var/lib/pgsql/data/postgresql.conf dosyasını bir metin düzenleyicide açın.

'password_encryption' satırını bulun, yorum işaretini kaldırın ve değerini 'scram-sha-256' olarak değiştirin:

password_encryption = 'scram-sha-256'

Değişiklikleri kaydedin.

PostgreSQL hizmetini yeniden başlatın:

sudo service postgresql restart

PostgreSQL veritabanını ve kullanıcısını oluşturun:

not

İstediğiniz kullanıcı adını ve parolayı belirleyebilirsiniz.

root olarak çalıştırıyorsanız could not change directory to "/root" uyarısını önlemek için önce şu komutu çalıştırın:

cd /tmp

Ardından veritabanını ve kullanıcıyı oluşturun:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Redis'i kurma​

Aşağıdaki komutu çalıştırın:

sudo yum -y install redis

Redis hizmetini başlatın ve açılışta başlamasını etkinleştirin:

sudo systemctl enable --now redis

RabbitMQ'yu kurma​

sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.rpm.sh | sudo bash
ERLANG_LATEST_VERSION=$(curl -s https://api.github.com/repos/rabbitmq/erlang-rpm/releases | sed -n 's/.*"tag_name":\s*"v\([^"]*\)".*/\1/p' | head -1)
sudo rpm -ivh https://github.com/rabbitmq/erlang-rpm/releases/latest/download/erlang-${ERLANG_LATEST_VERSION}-1.el${REV}.aarch64.rpm

$REV değerini işletim sisteminizin sürümüne göre elle değiştirin (8.x sürümleri için 8, 9.x sürümleri için 9 vb.).

sudo yum install rabbitmq-server

Alternatif olarak RabbitMQ'yu CentOS 8 veya CentOS 9'a resmi siteden kurabilirsiniz.

RabbitMQ hizmetini başlatın ve açılışta başlamasını etkinleştirin:

sudo systemctl enable --now rabbitmq-server

ONLYOFFICE Docs'u kurma​

ONLYOFFICE Docs deposunu ekleme​

ONLYOFFICE Docs yum deposunu aşağıdaki komutla ekleyin:

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

ONLYOFFICE Docs'u kurma​

Aşağıdaki komutu çalıştırın:

sudo yum install onlyoffice-documentserver-de

nginx hizmetini başlatın ve açılışta başlamasını etkinleştirin:

sudo service nginx start
sudo systemctl enable nginx

Bundan sonra ONLYOFFICE Docs bir işlem olarak çalışır. Paket, diğer rpm paketleri gibi güncellenir.

ONLYOFFICE Docs'u güncelleme​

ONLYOFFICE Docs'u güncellemek için aşağıdaki komutu çalıştırın:

sudo yum update onlyoffice-documentserver-de
Önemli

RHEL 8 ve türevlerinde, ONLYOFFICE deposu etkinken yum update komutunu çalıştırmak bağımlılık hatasıyla başarısız olabilir.

Bunu önlemek için, bu paketleri ONLYOFFICE deposundan hariç tutun; böylece paketler sistemin AppStream deposundan alınır:

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

Bu komutun yalnızca bir kez çalıştırılması yeterlidir. Bundan sonra yum update beklendiği gibi çalışır.

ONLYOFFICE Docs'u OneClick Install ile kurduysanız bu hariç tutma işlemi zaten otomatik olarak uygulanmıştır.

ONLYOFFICE Docs varsayılan bağlantı noktasını değiştirme​

ONLYOFFICE Docs, varsayılan olarak gelen bağlantıları 8083 numaralı bağlantı noktasından dinler. 4.3 sürümünden itibaren, varsayılan yerine başka bir bağlantı noktası kullanmayı planlıyorsanız ONLYOFFICE Docs bağlantı noktasını değiştirebilirsiniz.

not

Varsayılan bağlantı noktasını değiştirecekseniz, yeni bağlantı noktasının gelen/giden bağlantılara açık olduğundan emin olun. ONLYOFFICE Docs tarafından kullanılan bağlantı noktalarının tam listesine bakın.

Bunun için DS_PORT ortam değişkenini aşağıdaki komutla düzenlemeniz gerekir:

export DS_PORT=<PORT_NUMBER>

Yukarıdaki komutta <PORT_NUMBER> yerine bağlantı noktası numarasını yazın.

not

Bağlantı noktasını 80 olarak ayarlarsanız, varsayılan NGINX web sitesini NGINX paketinin güncel sürümünü kurma bölümünde açıklandığı gibi devre dışı bıraktığınızdan emin olun.

Uyarı

ONLYOFFICE Docs protokolünü HTTPS olarak değiştirmek istiyorsanız bağlantı noktasını 443 yapmayın, bunun yerine bu talimatı kullanın.

Bundan sonra ONLYOFFICE Docs yapılandırmasına devam edebilirsiniz.

ONLYOFFICE Docs'u yapılandırma​

Yapılandırma betiğini çalıştırma​

Not

Varsayılan olarak veritabanı olarak PostgreSQL kullanılır. PostgreSQL yerine MySQL kullanmak istiyorsanız, documentserver-configure.sh betiğini çalıştırmadan önce veritabanı türünü ve bağlantı noktasını tanımlayan iki ortam değişkeni ekleyin:

export DB_TYPE=mysql
export DB_PORT=3306

Bu iki değişkeni ekledikten sonra veritabanını betikle değiştirebilirsiniz.

documentserver-configure.sh betiğini çalıştırın:

bash documentserver-configure.sh

PostgreSQL, Redis ve RabbitMQ bağlantı parametrelerini belirtmeniz istenir. Aşağıdaki verileri kullanın:

PostgreSQL için:

  • Host: localhost
  • Database: onlyoffice
  • User: onlyoffice
  • Password: onlyoffice

Redis için:

  • Host: localhost

RabbitMQ için:

  • Host: localhost
  • User: guest
  • Password: guest

Güvenlik duvarı istisnası ekleme​

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

SELinux'u devre dışı bırakma​

not

v.5.0'dan itibaren kullanımdan kaldırılmıştır

/etc/selinux/config dosyasını herhangi bir metin düzenleyiciyle açın, SELINUX=enforcing veya SELINUX=permissive satırını SELINUX=disabled ile değiştirin ve değişiklikleri kaydedin.

Değişikliklerin etkili olması için sunucunuzu yeniden başlatın.

Not

Güvenlik nedeniyle v8.1 sürümünden itibaren, documentserver-configure.sh betiği çalıştırıldığında local.json dosyasında yeni WOPI anahtarları oluşturulur. WOPI bağlantısı kullanıyorsanız, ONLYOFFICE Docs'u güncelledikten sonra betiği çalıştırmanız gerekir:

documentserver-configure.sh --wopienabled true

ONLYOFFICE Docs'u tarayıcıda başlatma​

Yapılandırma tamamlandıktan sonra tarayıcınızın adres çubuğuna http://localhost:8083 yazarak ONLYOFFICE Docs karşılama sayfasını açabilirsiniz. Bu sayfada, belge örneklerini etkinleştirme veya çevrimiçi editörleri sağlanan API ile web uygulamanıza entegre etme konusunda daha fazla talimat bulabilirsiniz.

Developer Edition sürümünüzü kaydetme​

Developer Edition satın aldıysanız ve license.lic dosyasını aldıysanız, yazılımın tam sürümünü elde etmek için bu dosyayı kurulumunuza yerleştirebilirsiniz.

Red Hat tabanlı bir Linux dağıtımı kullanıyorsanız license.lic dosyası aşağıdaki klasöre yerleştirilir:

/var/www/onlyoffice/Data/license.lic

Bundan sonra Developer Edition sürümünüz kaydedilmiş ve tam işlevli olur.