Sorun giderme

Genel sorunlar

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

C: Docker tabanlı en son çevrimiçi ofis sunucusu 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 girdikten sonra İnsanlar modülünde 'fake user' adlı bilinmeyen bir kullanıcı görüyorum. Hizmetler listesinde de OnlyofficeHealthCheck adlı bir hizmet var. Bunun nedeni nedir ve bu konuda bir şey yapmam gerekir mi?

C: Kullanıcı ve hizmet, portallar için gelecek sürümlerde sunulacak olan Health Check işlevinin bir parçasıdır. Şu an çalışmadığı için 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 başarıyla kullanmak için nasıl bir sisteme ihtiyacım var?

C: Sistem gereksinimleri şunlardır:

• CPU: çift çekirdekli 2 GHz veya daha iyisi
• RAM: 4 GB veya daha fazla
• HDD: en az 20 GB boş alan
• SWAP: en az 4 GB, ancak ana 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 kendi ad çözümlememle ilgili sorunlar yaşıyorum. Sorun ne olabilir?

C: Docker varsayılan olarak Google DNS sunucularını kullanır ve sunucu her ağ isteği yaptığında bunlarla iletişim kurmaya çalışır. ONLYOFFICE Workspace, ONLYOFFICE Docs veya ONLYOFFICE Mail internet erişimine sahip 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ı şurada bulunabilir: /etc/docker/daemon.json

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

C: Bunun nedeni, bilgisayarın internet geri döngü erişimini kullanarak kendisine adres verebilmesi, yani kendisi için dışarıdan erişilebilir olması gerekmesi olabilir. Bunu, iptables kurallarını şu şekilde yönlendirmeler içerecek biçimde düzenleyerek sağlayabilirsiniz:

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 düzenleyici dil dosyalarını güncelledim (bazı çevirileri düzelttim), ancak sunucu doğru değerler yerine hâlâ önceki 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, ancak her yerde aynı olması gerekir) ve NGINX'i yeniden başlatın:

sudo service nginx reload

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

not

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

HTTPS sorunları

S: Otomatik olarak imzalanan (self-signed) 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: Otomatik imzalı SSL sertifikaları kullanırken SSO meta verilerini, WebDAV'ı ve diğer node.js hizmetlerini almada sorun yaşıyorsanız bu sorunu çözmek için aşağıdaki seçeneklerden birini deneyebilirsiniz:

Seçenek 1: Hizmeti başlatırken parametreler 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 sunucum için 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ı kaldırın:

<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ı içinde işlemler başlamıyor. Soruna bir çözüm var mı?

C: Fedora ve RHEL/CentOS kullanıcıları SELinux'u setenforce 0 komutuyla devre dışı bırakmayı denemelidir. Sorun düzelirse SELinux'u devre dışı bırakılmış halde bırakabilirsiniz (Red Hat bunu önermez) ya da 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 nedeniyle ONLYOFFICE Docs, bir belgeyi yalnızca belgeyi düzenleyen tüm kullanıcılar 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).