Docker üzerinde ONLYOFFICE Docs için sorun giderme

Destek ekibine başvurmadan önce: tanılama bilgilerini toplama

Aşağıda ele alınmayan bir sorunla karşılaşıyorsanız ONLYOFFICE destek ekibine başvurmadan önce şu bilgileri toplayın:

• Kapsayıcı günlükleri:

  sudo docker logs <CONTAINER_ID>

• Kapsayıcı sürümü:

  sudo docker inspect --format='{{.Config.Image}}' <CONTAINER_ID>

• Bağlanan birimlerin listesi:

  sudo docker inspect --format='{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' <CONTAINER_ID>

• Ana bilgisayar işletim sistemi ve Docker sürümü:

  uname -a && docker --version

Kurulum ve sistem gereksinimleri

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

C: En son Docker tabanlı çevrimiçi ofis sunucusu Docker hub üzerinde bulunur. ONLYOFFICE Docs imajını seçin ve kurulum yönergelerini izleyin.

S: Sunucu çözümünü kurmak ve başarıyla kullanmak için nasıl bir sisteme sahip olmam gerekir?

C: Sistem gereksinimleri şunlardır:

• CPU: çift çekirdekli 2 GHz veya daha iyi
• RAM: 4 GB veya daha fazla
• HDD: en az 20 GB boş alan
• SWAP: en az 4 GB, ancak ana bilgisayar işletim sistemine bağlıdır. Daha fazlası daha iyidir
• OS: Docker ekibi tarafından desteklenen herhangi bir sürüm ile amd64/arm64

Ağ ve DNS

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

C: Docker varsayılan olarak Google DNS sunucularını belirtir ve sunucu her ağ isteği yaptığında bunlarla iletişim kurmaya çalışır. ONLYOFFICE Docs sunucunuzun İnternet erişimi olmayacaksa, varsayılan Docker DNS adresini yerel DNS sunucunuzun adresiyle değiştirmenizi öneririz. Bunun için /etc/default/docker dosyasını açın 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 arabirim görünüyor, ancak belgenin kendisi yüklenmiyor ve sürekli yükleme ilerlemesi gösteriliyor. Ne yapabilirim?

C: Bunun nedeni, bilgisayarın İnternet geri döngü erişimiyle kendi kendine adres verebilmesinin gerekmesi, yani kendisi için dışarıdan erişilebilir olması olabilir. Bunu sağlamak için iptables kurallarını şu şekilde yönlendirmeler içerecek biçimde düzenleyin:

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.

Kimlik doğrulama ve güvenlik

S: ONLYOFFICE Docs'u platformumla entegre ettikten sonra JWT kimlik doğrulaması başarısız oluyor. Bunu nasıl düzeltirim?

C: ONLYOFFICE Docs'ta yapılandırılan JWT sırrının, platformunuzun bağlayıcı ayarlarında yapılandırılan sırla tam olarak eşleştiğini doğrulayın. JWT üstbilgisi adının da eşleştiğini kontrol edin (varsayılan değer "Authorization"). Sık yapılan hatalar:

• Sır değerinin başında veya sonunda boşluk bulunması.

• Özel bir sır belirlemek yerine varsayılan rastgele sırrın kullanılması. Sırrınızı şu komutla kontrol edin:

  sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Performans ve kaynak kullanımı

S: ONLYOFFICE Docs çok fazla bellek kullanıyor. Bu normal mi?

C: Bellek kullanımı açık belge sayısı ve eşzamanlı kullanıcı sayısıyla birlikte artar. Birkaç düzine etkin kullanıcısı olan bir sunucuda 2-4 GB RAM kullanımı normaldir. Bellek kullanımı beklenmedik biçimde yüksekse /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/ klasöründe takılı kalmış veya unutulmuş belge olup olmadığını kontrol edin.

S: Kapsayıcı sürekli yeniden başlıyor. Ne yapmalıyım?

C: Belirli hatayı görmek için kapsayıcı günlüklerini kontrol edin:

sudo docker logs <CONTAINER_ID>

Sık görülen nedenler:

• Yetersiz bellek (kapsayıcı için en az 4 GB RAM gerekir).
• 80 numaralı bağlantı noktası başka bir uygulama tarafından kullanılıyor. Ya diğer uygulamayı durdurun ya da ONLYOFFICE Docs bağlantı noktasını değiştirin.
• Veritabanı başlatma hatası. Harici bir veritabanı kullanıyorsanız bağlantı parametrelerinin doğru olduğunu doğrulayın.

Belge işleme

S: Belge dönüştürme başarısız oluyor (ör. DOC, XLS veya PPT dosyaları açılırken hata görüntüleniyor). Ne yapabilirim?

C: Aşağıdaki komutu çalıştırarak dönüştürücü günlüğünde hata olup olmadığını kontrol edin:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

Sık görülen nedenler yetersiz disk alanı ve eksik yazı tipleridir.

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 kapattıktan sonra kaydeder. Veri kaybını önlemek için, uygulamayı güncelleme, sunucuyu yeniden başlatma vb. durumlarda ONLYOFFICE Docs'u durdurmanız gerektiğinde kullanıcıları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ı, tüm kullanıcıların bağlantısının kesilmesini beklediği için uzun sürebilir (5 dakikaya kadar).

Önbellek ve özelleştirme

S: Özel bir arabirim teması ekledim veya düzenleyici dil dosyalarımı 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: Aşağıdaki komutu çalıştırarak önbelleği zorla temizleyin:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

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

not

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

Enterprise ve Developer Edition sorunları

S: "License expired" uyarısı görüyorum. Ne yapmalıyım?

C: license.lic dosyanızın süresi dolmuş. Lisansınızı yenilemek için sales@onlyoffice.com adresiyle iletişime geçin. Yeni dosyayı aldıktan sonra veri dizinindeki eski license.lic dosyasını değiştirin ve ONLYOFFICE Docs'u yeniden başlatın.

S: Yönetim Paneli'ne erişemiyorum. Ne yapmalıyım?

C: Yönetim Paneli'ni henüz kurmadıysanız Yönetim Paneli kurulum kılavuzunu izleyin. Yönetici parolanızı unuttuysanız runtime.json dosyasındaki passwordHash girdisini silip yeniden başlatın; yeni bir önyükleme kodu oluşturulur.