Устранение возможных неполадок на Windows. ONLYOFFICE Docs
Перед обращением в службу поддержки: сбор диагностической информации
Если вы столкнулись с проблемой, которая не описана ниже, соберите следующие сведения, прежде чем обращаться в службу поддержки ONLYOFFICE:
Windows:
- Каталог журналов:
%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\ - Установленная версия: см. раздел «Программы и компоненты» в панели управления
Проблемы при использовании
Вопрос: При остановке ONLYOFFICE Docs произошла потеря данных. Как избежать потери данных?
Ответ: Из-за особенности работы ONLYOFFICE Docs сохраняет документ только после того, как все пользователи, редактирующие его, закрыли документ. Чтобы избежать потери данных, при необходимости остановить ONLYOFFICE Docs в случаях обновления приложения, перезагрузки сервера и т.п. необходимо принудительно отключить пользователей ONLYOFFICE Docs. Для этого на сервере, где установлен ONLYOFFICE Docs, выполните следующий скрипт:
%ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-prepare4shutdown.bat
Выполнение скрипта может занять продолжительное время (до 5 минут).
Вопрос: Службы ONLYOFFICE Docs не запускаются. Что делать?
Ответ: Откройте оснастку «Службы» (services.msc) и проверьте состояние служб ds-docservice и ds-converter. Если какая-либо из служб остановлена, попробуйте запустить ее вручную. Распространенные причины:
-
Недостаточно памяти (рекомендуется не менее 4 ГБ оперативной памяти).
-
Порт 80 уже занят другим приложением. Остановите другое приложение или переустановите ONLYOFFICE Docs с другим портом:
onlyoffice-documentserver.exe /DS_PORT=<PORT_NUMBER> -
Более подробные сообщения об ошибках смотрите в журналах в папке
%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\.
Вопрос: После интеграции ONLYOFFICE Docs с моей платформой не проходит JWT-аутентификация. Как это исправить?
Ответ: Убедитесь, что секретный ключ JWT, заданный в ONLYOFFICE Docs, в точности совпадает с секретным ключом, указанным в настройках коннектора вашей платформы. Также проверьте, совпадает ли имя заголовка JWT (по умолчанию «Authorization»). Чтобы узнать текущий секретный ключ, откройте следующий файл в текстовом редакторе:
%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
Найдите значение параметра services.CoAuthoring.secret.session.string. Распространенные ошибки:
- Пробелы в начале или в конце значения секретного ключа.
- Использование случайного секретного ключа по умолчанию вместо собственного.
Вопрос: Не удается преобразовать документ (например, при открытии файлов DOC, XLS или PPT появляется ошибка). Что можно сделать?
Ответ: Проверьте журнал конвертера на наличие ошибок:
%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\
Распространенные причины — нехватка места на диске и отсутствие нужных шрифтов.
Вопрос: ONLYOFFICE Docs использует много памяти. Это нормально?
Ответ: Объем используемой памяти растет с числом открытых документов и одновременно работающих пользователей. Для сервера с несколькими десятками активных пользователей нормальным считается использование 2–4 ГБ оперативной памяти. Если потребление памяти неожиданно высокое, проверьте, нет ли зависших или забытых документов в папке:
%ProgramData%\ONLYOFFICE\DocumentServer\App_Data\cache\files\forgotten\
Проблемы в Enterprise Edition и Developer Edition
Вопрос: Появляется предупреждение «License expired». Что делать?
Ответ: Срок действия вашего файла license.lic истек. Чтобы продлить лицензию, напишите на адрес sales@onlyoffice.com. Получив новый файл, замените им старый файл license.lic в каталоге данных и перезапустите ONLYOFFICE Docs.
Вопрос: Не удается открыть Admin Panel. Что делать?
Ответ: Если вы еще не настроили Admin Panel, следуйте руководству по настройке Admin Panel. Если вы забыли пароль администратора, удалите запись passwordHash из файла runtime.json и выполните перезапуск — будет сгенерирован новый код начальной настройки (bootstrap code).