Sorun giderme

Genel sorunlar

S: Docker tabanlı sunucuyu yerel sunucuma kurmak istiyorum. Bunu nasıl yapabilirim?

C: Docker tabanlı çevrimiçi ofis sunucusunun en son sürümü Docker Hub'da bulunur. Kurmak istediğiniz çözümü seçin: ONLYOFFICE Docs, ONLYOFFICE Workspace veya ONLYOFFICE Mail ve ilgili sayfadaki yönergeleri izleyin.

S: Portalı oluşturup giriş yaptıktan sonra İnsanlar modülünde 'fake user' adlı bilinmeyen bir kullanıcı görüyorum. Hizmet listesinde de OnlyofficeHealthCheck adlı bir hizmet var. Bunlar neden var ve bir şey yapmam gerekir mi?

C: Kullanıcı ve hizmet, portallarda gelecek sürümlerde sunulacak olan Health Check işlevinin bir parçasıdır. Şu anda işlevsel değildir, bu nedenle olduğu gibi bırakabilir veya OnlyofficeHealthCheck hizmetini devre dışı bırakıp hizmetlerin otomatik başlatma listesinden kaldırabilirsiniz.

S: Sunucu çözümünü kurmak ve sorunsuz kullanmak için nasıl bir sisteme ihtiyacım var?

C: Sistem gereksinimleri şunlardır:

• CPU: çift çekirdekli 2 GHz veya daha hızlı
• RAM: 4 GB veya daha fazla
• HDD: en az 20 GB boş alan
• SWAP: en az 4 GB, ancak ana bilgisayarın işletim sistemine bağlıdır. Daha fazlası daha iyidir
• İşletim sistemi: çekirdek sürümü 3.10 veya üzeri olan amd64 Linux dağıtımı
• Ek gereksinimler
  • Docker: Docker ekibi tarafından desteklenen herhangi bir sürüm

S: Sunucu sürümlerinden birini Docker hizmetiyle kurdum, ancak DNS sunucusu veya ad çözümlemeyle ilgili sorunlar yaşıyorum. Sorun ne olabilir?

C: Docker varsayılan olarak Google DNS sunucularını belirtir ve sunucu her ağ isteği yaptığında bunlara erişmeye çalışır. ONLYOFFICE Workspace, ONLYOFFICE Docs veya ONLYOFFICE Mail çözümünüzün internete erişimi olmayacaksa, varsayılan Docker DNS adresini yerel DNS sunucunuzun adresiyle değiştirmenizi öneririz. Bunun için /etc/default/docker dosyasına gidin ve aşağıdaki satırdaki IP adresini yerel ağınızdaki bir DNS sunucusunun IP adresiyle değiştirin:

docker_OPTS="--dns 8.8.8.8"

CentOS gibi RPM tabanlı işletim sistemlerinde yapılandırma dosyası şu konumda olabilir: /etc/docker/daemon.json

S: Belge düzenleyicileri açılıyor ve arayüz görünüyor, ancak belgenin kendisi yüklenmiyor ve yükleme ilerlemesi sürekli gösteriliyor. Ne yapılabilir?

C: Bunun nedeni, bilgisayarın internet geri döngü erişimini kullanarak kendi kendine erişebilmesi gerekmesi, yani kendisine dışarıdan erişilebilir olması olabilir. iptables kurallarını aşağıdaki gibi yönlendirmeler içerecek şekilde düzenleyerek buna izin verebilirsiniz:

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 ve local_ip adreslerini gerçek IP adresleriyle değiştirmeyi unutmayın.

S: Özel bir arayüz teması ekledim veya editör dil dosyalarını güncelledim (bazı çevirileri düzelttim), ancak sunucu doğru değerler yerine hâlâ eski değerleri gösteriyor. Önbelleği tüm kullanıcılar için aynı anda nasıl sıfırlayabilirim?

C: Önbelleği sıfırlamak için aşağıdaki adımları izleyin: /etc/nginx/includes/ds-docservice.conf ve /etc/nginx/includes/ds-spellchecker.conf dosyalarını bulun. Bu dosyalarda derleme tarihi ve saati değeri bulunur. Bu değerleri başka bir değerle değiştirin (herhangi bir değer olabilir, önemli olan tüm yerlerde aynı olmasıdır) ve NGINX'i yeniden başlatın:

sudo service nginx reload

Önbellek tüm sunucu kullanıcıları için sıfırlanır.

not

Docker kurulumunda tüm işlemlerin kapsayıcı içinde yapılması gerektiğini unutmayın.

HTTPS sorunları

S: Kendinden imzalı bir SSL sertifikası ekledim ve şimdi SSO meta veri sayfasını açarken, WebDAV ve diğer node.js hizmetleriyle çalışırken hata alıyorum. Bunu düzeltmek için ne yapılabilir?

C: Kendinden imzalı SSL sertifikaları kullanırken SSO meta verilerini, WebDAV'ı ve diğer node.js hizmetlerini alma konusunda sorun yaşıyorsanız, sorunu çözmek için aşağıdaki seçeneklerden birini deneyebilirsiniz:

Seçenek 1: Hizmetin başlatılması için parametre ekleyin.

1. onlyofficeSsoAuth.service dosyasını açın (CommunityServer kapsayıcısı içinde):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Kök sertifikanın yolunu belirten aşağıdaki satırı [Service] bloğunun sonuna ekleyin:

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. Hizmetleri yeniden başlatın:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Seçenek 2: Sistemin sertifika paketini kullanın.

1. onlyofficeSsoAuth.service dosyasını açın (CommunityServer kapsayıcısı içinde):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. [Service] bloğunda aşağıdaki satırı bulun:

   ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

   Bunu aşağıdaki satırla değiştirin:

   ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

3. CentOS için ek olarak, sertifika paketinin yolunu belirten aşağıdaki satırı [Service] bloğunun sonuna ekleyin:

   Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

4. Hizmetleri yeniden başlatın:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Docker sorunları

S: Sunucuyu Docker kapsayıcısını docker stop id komutuyla durdurmadan yeniden başlattım ve şimdi sunucumda ERR_TOO_MANY_REDIRECTS hatası alıyorum. Bunu düzeltmek için ne yapılabilir?

C: /var/www/onlyoffice/WebStudio/web.appsettings.config dosyasını düzenleyin ve en son satırı silin:

<add key="web.warmup.type" value="basic" />

Ardından monoserve'ü aşağıdaki komutla yeniden başlatın:

sudo service monoserve restart

S: Fedora Linux kullanıyorum ve Docker kapsayıcısında işlemler başlamıyor. Bu sorunun bir çözümü var mı?

C: Fedora ve RHEL/CentOS kullanıcıları SELinux'u setenforce 0 komutuyla devre dışı bırakmayı denemelidir. Bu sorunu çözerse, SELinux'u devre dışı bırakılmış halde bırakabilirsiniz (Red Hat bunu önermez) veya Ubuntu kullanmaya geçebilirsiniz.

ONLYOFFICE Docs kullanımı sorunları

S: ONLYOFFICE Docs durdurulurken veri kaybı yaşandı. Veri kaybı nasıl önlenir?

C: Çalışma özelliği gereği ONLYOFFICE Docs, bir belgeyi yalnızca o belgeyi düzenleyen tüm kullanıcılar belgeyi kapattıktan sonra kaydeder. Veri kaybını önlemek için, uygulama güncellemeleri, sunucu yeniden başlatmaları gibi durumlarda ONLYOFFICE Docs'u durdurmanız gerektiğinde ONLYOFFICE Docs kullanıcılarının bağlantısını zorla kesmeniz gerekir. Bunun için ONLYOFFICE Docs'un kurulu olduğu sunucuda aşağıdaki betiği çalıştırın:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh

not

Betiğin çalışması uzun sürebilir (5 dakikaya kadar).

not

Kullanıcıların bağlantısının kesilmesi uzun sürebilir (5 dakikaya kadar).