Ana içeriğe geç

Sorun giderme

Genel sorunlar​

S: Sunucu çözümünü yerel sunucuma kurmak istiyorum. En son sürümü nereden indirebilirim?

C: En son sunucu çözümü GitHub ve SourceForge'da bulunur.

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: en az 2 GB, ancak ana işletim sistemine bağlıdır. Daha fazlası daha iyidir
  • HDD: en az 20 GB boş alan
  • İşletim sistemi: Microsoft Windows Server 2016 veya üzeri

S: Sunucu çözümünü sunucuma kurdum, ancak hangi sürümü kullandığımdan emin değilim. Bunu nasıl kontrol edebilirim?

C: Tam sürüm numarasını şu şekilde kontrol edebilirsiniz:

  1. web.studio/web.appsettings.config dosyasını açın
  2. <add key="web.install-url" value="http://service.onlyoffice.com/install/email.ashx?v=77" /> parametresine bakın; özellikle v= değerinden sonra gelen numaraya dikkat edin

S: Community Server'ı Control Panel ve Docs ile birlikte kurdum, ardından Docs'u kaldırdım ve şimdi Control Panel çalışmıyor.

C: Docs bağlantı yollarını sıfırlamanız ve Community Server'ı IIS'de yeniden başlatmanız gerekir. Şu adımları izleyin:

  1. C:\Program Files (x86)\Ascensio System SIA\CommunityServer\WebStudio\ klasörüne gidin ve web.appsettings.config dosyasını bir metin düzenleyiciyle açın.

    Aşağıdaki anahtarların değerlerini temizleyin ve değişiklikleri kaydedin.

    <add key="files.docservice.url.public" value="" />
    <add key="files.docservice.url.internal" value="" />
    <add key="files.docservice.url.portal" value="" />

  2. Portal ayarlarında editör bağlantı ayarlarını sıfırlayın:

    http://127.0.0.1/Management.aspx?type=17 sayfasına gidin ve Reset düğmesine basın.

  3. IIS'de ONLYOFFICE Server web sitesini yeniden başlatın:

    Start > Windows Administrative Tools yolunu izleyip Internet Information Services (IIS) Manager'ı çalıştırın. IIS Manager'da Connections panelinde Sites bölümünü genişletin. Listedeki ONLYOFFICE Server web sitesine sağ tıklayın ve Manage Website > Restart seçeneğini seçin.

Kurulum sorunları​

S: Kurulum yönergelerine ihtiyacım var. Bunları nerede bulabilirim?

C: Kurulum yönergelerini Yardım Merkezimizin Kurulum bölümünde bulabilirsiniz.

S: Sunucu çözümünü Windows Server 2012'ye kurmak istiyorum. Bu mümkün mü?

C: Evet, sunucu çözümünü Windows Server 2012'ye kurabilirsiniz, ancak çalışması için ayarlarında bazı değişiklikler yapmanız gerekir:

  1. C:\Windows\System32\inetsrv\config\applicationHost.config dosyasına gidin
  2. <sectionGroup name="system.webServer"> bölümünü bulun
  3. <section name="handlers" overrideModeDefault="Deny" /> satırını <section name="handlers" overrideModeDefault="Allow" /> olarak değiştirin
  4. <section name="modules" overrideModeDefault="Deny" /> satırını <section name="modules" overrideModeDefault="Allow" /> olarak değiştirin

S: Eski bir sunucu çözümü kullanıyorum. En son sürüme nasıl geçebilirim?

C: ONLYOFFICE Workspace'i en son sürüme yükseltmeyle ilgili ayrıntılı yönergeler bu makalede bulunabilir.

Geçiş işlemine başlamadan önce portal verilerinizi yedeklemeyi unutmayın.

S: Şu hatayı alıyorum: "Server Error in ‘/’ Application. Index was out of range. Must be non-negative and less than the size of the collection". Bu sorunu nasıl çözebilirim?

C: web.appsettings.config dosyasındaki core.machinekey anahtarının 8 veya daha fazla karakter içermesi için ona karakter eklemeyi deneyin.

S: Şu hatayı alıyorum: "{SQL_ERROR}: {SQL_STATE: HY000} Specified key was too long; max key length is 1000 bytes". Bu sorunu nasıl çözebilirim?

C: mysql-essential-5.1.58-win32 kurmanızı veya veritabanı sunucunuzun ayarlarını uzun anahtarların kullanılmasına izin verecek şekilde değiştirmenizi öneririz.

S: Sunucu çözümünü bilgisayarıma yeni kurdum, ancak klasörlerini bulamıyorum. Nerede olduklarını söyleyebilir misiniz?

C: Varsayılan olarak 7.5'ten eski sürümler C:\ProgramData\TeamLab dizinine, 7.5 sürümü C:\Program Files (x86)\TeamLab Server dizinine, 7.7 sürümü ise C:\Program Files\Ascensio System SIA\ONLYOFFICE dizinine kurulur.

S: Kaynak kodunu indirdim, ancak Visual Studio 2010 ile nasıl kullanmaya başlayacağımı bilmiyorum. Neyi yanlış yapıyorum?

C: Sunucu çözümü, Visual Studio ile açılabilecek tek bir proje değil, çok sayıda küçük projeden oluşur. Bu projeler şu .bat dosyasıyla derlenir: redistributable\asc\BuildAndDeploy.bat. Biz Visual Studio 2012 kullanıyoruz.

Yapılandırma sorunları​

S: ONLYOFFICE Workspace'i ilk kez başlatmaya çalıştığımda localhost erişilemiyor ve ONLYOFFICE web sitesi çalışmayarak The process cannot access the file because it's being used by another process. (Exception from HRESULT: 0x80070020) hatasını veriyor. Bu nasıl düzeltilebilir?

C: Hata iki şekilde düzeltilebilir:

  1. ONLYOFFICE web sitesini Internet Information Services (IIS)'de başka bir bağlantı noktasına geçirin;
  2. veya IIS'deki diğer tüm web sitelerini (varsa) 80 numaralı bağlantı noktasından kaldırın.

Çalışıyorsa Skype'ı devre dışı bırakmayı da deneyebilirsiniz.

S: Portalımı HTTP'den HTTPS'e geçirmek istiyorum. Bunu nasıl yapabilirim?

C: PEM biçimindeki sertifikanızı sunucu çözümünün kurulu olduğu bilgisayara yerleştirin. Bu dosyanın tam yolunu, sunucu çözümünün config.js dosyasında eğik çizgi (/) kullanarak belirtin. Ardından OnlyOfficeRouter hizmetini yeniden başlatın.

S: Portalımın alan adını değiştirmek istiyorum. Bunu nasıl yapabilirim?

C: Alan adını, Ayarlar > Genel sekmesindeki DNS Settings > Custom domain name alanında veya tenants_tenants tablosunun mappeddomain alanında atayabilirsiniz.

S: ONLYOFFICE Workspace ile tam metin aramasını kullanamıyorum. Bunu nasıl ayarlayabilirim?

C: ONLYOFFICE Workspace'te tam metin aramasını ayarlamak için şunları yapmanız gerekir:

  1. sphinx 2.2.10 sürümünü resmi web sitesinden indirin

  2. İndirilen arşiv dosyasını bir klasöre çıkarın, ör. C:\Program Files\Sphinx-2.2.10

  3. Sphinx bin dizininin yolunu (ör. C:\Program Files\Sphinx-2.2.10\bin) sistem (kullanıcı DEĞİL) PATH ortam değişkenine ekleyin.

    Bunu şu şekilde yapabilirsiniz: Control Panel > System > Advanced system settings yolunu izleyin. Açılan iletişim penceresinde Environment Variables... düğmesine tıklayın, PATH değişkenini seçin ve Edit düğmesine tıklayın. Açılan pencerede New seçeneğini seçin, yeni değişken için bir ad girin (ör. sphinx) ve ilgili düğmeyi kullanarak yolunu seçin. Ardından sonuçları kaydedin.

  4. OnlyofficeIndex başlatma türünü disabled değerinden automatic değerine değiştirin ve hizmeti çalıştırın.

    Control Panel > Administrative Tools > Services yolunu izleyin, OnlyofficeIndex hizmetini bulun, sağ tıklayın ve Properties seçeneğini seçin. Açılan iletişim penceresinde açılır menüden Automatic başlangıç türünü seçin, OK düğmesine tıklayın ve hizmeti başlatın.

Lisans kısıtlamaları nedeniyle Windows için otomatik kurulum desteklenmez.

S: E-posta bildirimlerinin gönderilmesiyle ilgili bir sorunum var. Eklediğim özel DNS adı yerine sunucu çözümünün barındırıldığı sunucunun adını (PC adı) içeren iletiler alıyorum. Bunu nasıl çözebilirim?

C: <add key="web.host" value="<YOUR_DOMAIN>"/> satırını web.appsettings.config dosyasına ekleyin.

S: Alan adını web.appsettings.config dosyasına ekledim. Bir web sitesini 80 numaralı bağlantı noktasında çalıştırırsam çalışıyor. Bunu farklı bir bağlantı noktası için nasıl tanımlayabilirim?

C: web.appsettings.config dosyasına şu satırı ekleyebilirsiniz: <add key="web.host" value="http://<DOMAIN>:<PORT>"/>.

S: SMTP ayarlarını başarıyla yapılandırıp test ettim, ancak e-posta bildirimi çalışmıyor. Bunun nedeni nedir?

C: Büyük olasılıkla ağınızda sorunlar var. Bunu kontrol etmek için Start > Run yolunu izleyin ve cmd komutunu girin. Ardından açılan komut satırı penceresine ping notify.onlyoffice.com veya ping mail.onlyoffice.org yazın ve Enter tuşuna basın. Bundan sonra IP adresiniz görüntülenmiyorsa ağınızda bir sorun vardır.

S: Talk çalışmıyor. Bu sorunu nasıl çözebilirim?

C: OnlyofficeJabber hizmetinin çalıştığından ve güvenlik duvarı ile antivirüs istisnalarına eklendiğinden emin olun. 5222 ve 5280 numaralı bağlantı noktaları açık olmalıdır.

S: Posta kutusu Mail modülüne bağlanamıyor veya bağlı posta kutusuna e-posta gelmiyor. Bu sorunu nasıl çözebilirim?

C: OnlyofficeMailAggregator hizmetinin çalıştığından ve güvenlik duvarı ile antivirüs istisnalarına eklendiğinden emin olun. Ayrıca giden istekler için şu bağlantı noktalarının açık olduğundan emin olun:

  • SMTP: 25, 465
  • IMAP: 143, 993
  • POP3: 110, 995

S: Portal olaylarına ilişkin bildirimler e-posta adresime gelmiyor. Bu sorunu nasıl çözebilirim?

C: OnlyofficeNotify hizmetinin çalıştığından ve güvenlik duvarı ile antivirüs istisnalarına eklendiğinden emin olun. Giden istekler için 25 numaralı bağlantı noktasının açık olduğundan emin olun.

S: OnlyofficeAutoreplay hizmeti çalışmıyor. Bu sorunu nasıl çözebilirim?

C: Gelen istekler için 25 numaralı bağlantı noktasının açık olduğundan emin olun. Ayrıca DNS MX kaydınızı doğru ayarladığınızdan emin olun.

S: Sunucu çözümünün kodunda istediğim gibi görünmesi için bir şeyi güncellemek istiyorum. Düzenli bir proje görmek için bir çözüm dosyası olmalı. Bu çözüm dosyasını nerede bulabilirim?

C: Çözüm dosyası yoktur, ancak kendiniz oluşturup projeleri elle ekleyebilirsiniz. Projelerin derleme sırasını şurada bulabilirsiniz: _ci\projects\build.proj.

Kullanım sorunları​

S: Portal verilerimi yedeklemem gerekiyor. Bunu nasıl yapabilirim?

C: MySQL aracılığıyla bir veritabanı yedeği oluşturabilirsiniz. Veya verilerinizi şu dizinlerden kopyalayarak elle veri yedeği oluşturabilirsiniz:

  • Data\Files\
  • Data\Mail\
  • web.studio\addons\mail\Data
  • web.studio\data\
  • web.studio\Products\Community\Modules\Blogs\Data\
  • web.studio\Products\Community\Modules\Bookmarking\Data\
  • web.studio\Products\Community\Modules\Forum\Data\
  • web.studio\Products\Community\Modules\News\Data\
  • web.studio\Products\Community\Modules\PhotoManager\Data\
  • web.studio\Products\Community\Modules\Wiki\Data\
  • web.studio\Products\CRM\Data\
  • web.studio\Products\Projects\Data\

S: Portala Android telefonumdan erişmeye çalıştım, ancak başaramadım. Neden?

C: Sunucu çözümünün mobil erişimi yoktur; bu nedenle portalınıza Android telefonlardan ve iOS cihazlardan erişemezsiniz. SaaS çözümünü kullansaydınız bu mümkün olurdu.

S: Projeler modülü, 6.0'dan 6.5'e geçişten sonra yükleme simgesinde takılı kalıyor. Sorunu nasıl çözebilirim?

C: Önce tarayıcı önbelleğinizi temizlemeyi deneyin: 6.5 sürümünde bazı Java betikleri güncellenmiştir ve önceki sürümün betikleri önbellekte kaydedilmişse bu soruna neden olabilir.

S: Sunucu çözümünü kullanırken burada belirtilmeyen bir sorunla karşılaştım. Ne yapmalıyım?

C: Sorularınızın yanıtlarını bulmak için geliştiriciler forumumuzu ziyaret edebilirsiniz. Sorununuzu GitHub Issues bölümünde de anlatabilirsiniz; topluluk üyeleri yardımcı olmaya çalışacaktır.