Ana içeriğe geç

Linux'ta ONLYOFFICE Docs için sorun giderme

Destekle iletişime geçmeden önce: tanılama bilgilerini toplama​

Aşağıda ele alınmayan bir sorunla karşılaşırsanız, ONLYOFFICE destek ekibiyle iletişime geçmeden önce şu bilgileri toplayın:

  • Günlük dizini: /var/log/onlyoffice/documentserver/
  • Paket sürümü: dpkg -l | grep onlyoffice (Debian/Ubuntu) veya rpm -qa | grep onlyoffice (CentOS)
  • İşletim sistemi sürümü: cat /etc/os-release

Derleme sorunları​

S: Kodu klonladım, ancak yalnızca boş klasörler görüyorum, kaynak kodu yok.

C: Depo alt modüller içerir. Depoyu aşağıdaki komutla klonlamanız önerilir:

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

Depoyu şu komutla klonladıysanız:

git clone https://github.com/ONLYOFFICE/DocumentServer.git

alt modülleri şu şekilde güncelleyebilirsiniz:

  1. DocumentServer dizinine gidin:

    cd DocumentServer

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

    git submodule update --init --recursive

Kullanım sorunları​

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

C: Çalışma özelliği gereği ONLYOFFICE Docs, bir belgeyi yalnızca onu düzenleyen tüm kullanıcılar belgeyi kapattıktan sonra kaydeder. Veri kaybını önlemek için, uygulama güncellemesi, sunucunun yeniden başlatılması gibi 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 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).

S: Özel bir arayüz teması ekledim veya düzenleyici dil dosyalarını güncelledim (bazı çevirileri düzelttim), ancak sunucu hâlâ doğru değerler yerine ö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 şu 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 bulunmalıdır. 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ırlanmış olmalıdır.

S: ONLYOFFICE Docs hizmetleri başlamıyor. Ne yapmalıyım?

C: Hizmetlerin durumunu kontrol edin ve hata çıktısını inceleyin:

sudo systemctl status ds-docservice
sudo systemctl status ds-converter

Hizmetlerden biri durmuşsa, yeniden başlatmayı deneyin:

sudo systemctl restart ds-docservice

Yaygın nedenler şunlardır:

  • Yetersiz bellek (en az 4 GB RAM önerilir).
  • 80 numaralı bağlantı noktası başka bir uygulama tarafından kullanılıyor. Çakışan işlemi sudo ss -tlnp | grep :80 ile belirleyip durdurun veya ONLYOFFICE Docs'u farklı bir bağlantı noktasını kullanacak şekilde yeniden yapılandırın.
  • Daha ayrıntılı hata iletileri için günlükleri kontrol edin: /var/log/onlyoffice/documentserver/

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

C: ONLYOFFICE Docs'ta yapılandırılan JWT gizli anahtarının, platformunuzun bağlayıcı ayarlarında yapılandırılan anahtarla tamamen aynı olduğunu doğrulayın. JWT üst bilgisi adının da eşleştiğini kontrol edin (varsayılan "Authorization"). Mevcut gizli anahtarı görmek için yapılandırma dosyasını doğrudan okuyun:

cat /etc/onlyoffice/documentserver/local.json

Değere services.CoAuthoring.secret.session.string konumunda bakın. Yaygın hatalar:

  • Gizli anahtar değerinin başında veya sonunda boşluk bulunması.
  • Özel bir anahtar ayarlamak yerine varsayılan rastgele anahtarın kullanılması.

S: Belge dönüştürme başarısız oluyor (örneğin DOC, XLS veya PPT dosyalarını açarken hata görünüyor). Ne yapabilirim?

C: Dönüştürücü günlüğünde hata olup olmadığını kontrol edin:

cat /var/log/onlyoffice/documentserver/converter/out.log

Yaygın nedenler arasında yetersiz disk alanı ve eksik yazı tipleri bulunur.

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 şekilde yüksekse, /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/ dizininde takılı kalmış veya unutulmuş belgeler olup olmadığını kontrol edin.

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 ile iletişime geçin. Yeni dosyayı aldıktan sonra, veri dizinindeki eski license.lic dosyasını yenisiyle değiştirin ve ONLYOFFICE Docs'u yeniden başlatın.

S: Admin Panel'e erişemiyorum. Ne yapmalıyım?

C: Admin Panel'i henüz kurmadıysanız Admin Panel kurulum kılavuzunu izleyin. Yönetici parolanızı unuttuysanız, runtime.json dosyasındaki passwordHash girdisini silin ve yeniden başlatın. Yeni bir önyükleme kodu oluşturulacaktır.