Ana içeriğe geç

ONLYOFFICE Docs Enterprise Edition'ı CentOS'a kurma

Giriş​

Enterprise Edition, ONLYOFFICE Docs'u yerel sunucunuza kurmanızı ve çevrimiçi düzenleyicileri ONLYOFFICE ortak çalışma platformuyla veya diğer popüler sistemlerle entegre etmenizi sağlar (özelliklerin ayrıntılı listesine bakın). Bu kılavuz, ONLYOFFICE Docs Enterprise Edition'ın Linux sürümünü makinenize nasıl kuracağınızı gösterir.

Sistem gereksinimleri​

  • CPU: çift çekirdekli 2 GHz veya daha iyi
  • 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: 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
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Resmi talimat

NGINX'i kurun:

sudo yum install nginx

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 (7.x sürümleri için 7, 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

CentOS 9'da chkconfig varsayılan olarak kurulu değildir. Aşağıdaki komutla kurun:

sudo yum install chkconfig

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 | os=centos dist=$REV sudo bash
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/erlang/script.rpm.sh | os=centos dist=$REV sudo bash

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

mscorefonts'u kurma​

cabextract ve xorg-x11-font-utils paketlerini kurun:

sudo yum install cabextract xorg-x11-font-utils

CentOS 7.8(2003) için fontconfig de gereklidir:

sudo yum install fontconfig

msttcore yazı tipleri paketini kurun:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

ONLYOFFICE Docs'u kurma​

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

sudo yum install onlyoffice-documentserver-ee

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-ee
Ö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 düzenleyicileri sağlanan API ile web uygulamanıza entegre etme konusunda daha fazla talimat bulabilirsiniz.

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

Enterprise 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 Enterprise Edition sürümünüz kaydedilmiş ve tam işlevli olur.