Методики
02.06.2022
Чек-лист для проверки настроек сервера "1С:Шины"
Данная статья не является методикой по расследованию ошибок "1С:Шины", а представляет собой чек-лист, по которому следует проверить настройки "1С:Шины" при возникновении таких ситуаций, когда:
- не запускается сервер или приложение "1С:Шины";
- не открывается консоль администрирования или среда разработки "1С:Шины".
Причины, которые привели к подобным проблемам, могут не отражаться в технологическом журнале платформы "1С:Предприятие" или журнале событий "1С:Шины".
Поэтому перед тем как приступить к анализу событий журнала сервера "1С:Шины", необходимо удостовериться в том, что настройки "1С:Шины" выполнены корректно.
1. Проверить права пользователя, под которым выполняется запуск сервера "1С:Шины".
Пользователь операционной системы, от имени которого запускается экземпляр сервера "1С:Шины", должен иметь полные права на каталог экземпляра сервера и все его подкаталоги.
Кроме этого он должен иметь права чтения и записи в стандартный каталог временных файлов операционной системы.
Каталог экземпляра сервера представляет собой каталог в локальной файловой системе, в котором находится набор вложенных папок и файлов. По умолчанию он находится:
- ОС Windows: C:\ProgramData\1C\1CE\instances\1c-enterprise-esb-with-ide
- ОС Linux: /var/opt/1C/1CE/instances/1c-enterprise-esb-with-ide/
Более подробно про состав вложенных каталогов и и назначение настроечных файлов можно прочитать в документации к "1С:Шине".
2. Проверить доступность портов на сервере "1С:Шины".
Если оставить настройки шины по умолчанию, то "1С:Шина" при работе будет использовать следующие порты:
- Порт 6698 используется брокером сообщений.
- Порт 8080 используется для отладки.
- Порты 9700 и 9701, используются для работы с сервером через JMX (Java Management Extensions).
- Порт 9090.
При организации доступа к "1С:Шине" с других компьютеров требуется обеспечить, чтобы доступ по этим портам был разрешен.
Для проверки доступности портов:
-
в ОС Windows в строке поиска необходимо ввести "PowerShell" и запустить приложение "Windows PowerShell";
Далее ввести команду:
Test-NetConnection "адрес для проверки" -Port "порт для проверки"
Если в результате выполнения команды параметр "TcpTestSucceeded" будет "True", значит порт открыт:
-
в ОС Linux нужно запустить терминал, ввести команду:
netstat -tnlp | grep "порт для проверки"
Если порт открыт, то на экране отобразится таблица, в которой он будет отображен в состоянии прослушивания (Listen):
3. Проверить доступность оборудования на сервере "1С:Шины".
Минимальные требования для сервера "1С:Шины":
- Жесткий диск - не менее 1 Гб свободного места.
Если при работе сервера "1С:Шины" размер свободного пространства на диске станет меньше указанного, то сервер "1С:Шины" будет остановлен.
- Оперативная память - не менее 4 Гб.
Реальная потребность определяется исходя из количества информационных систем, интенсивности обмена,
использования обработки сообщений в "1С:Шине", например трансформации или маршрутизации.
4. Проверить версию Java, установленную на сервере "1С:Шины".
Для работы "1С:Шины" необходимо, чтобы на компьютере была установлена 64-разрядная Java Runtime Environment (JRE) 11 версии 11.0.12 и выше.
При использовании Java других версий (например, Java 8, 12, 13…) работоспособность "1С:Шины" не обеспечивается.
Для работы сервера "1С:Шины" рекомендуется использовать дистрибутив Liberica JDK.
Чтобы проверить версию Java, установленную на компьютере, необходимо выполнить следующие действия:
- В ОС Windows — в строке поиска ввести "командная" и запустить приложение "Командная строка";
- В OC Linux — запустить терминал.
Выполнить следующую команду:
Если Java установлена, то появится информация об установленной версии (например, в ОС Windows):
openjdk version "11.0.9" 2020-10-20 LTS
OpenJDK Runtime Environment (build 11.0.9+12-LTS)
OpenJDK 64-Bit Server VM (build 11.0.9+12-LTS, mixed mode)
Для установки Java можно воспользоваться руководством по установке Liberica JDK.
Если проверка указанных выше пунктов не принесла результата, то необходимо перейти к анализу событий журнала "1С:Шины".
Анализ событий журнала сервера "1С:Шины".
Журнал событий сервера помогает расследовать ошибки, возникающие в процессе работы "1С:Шины".
Все журналы сервера настраиваются в файле logging.yml. Журнал событий стандартно размещается в следующих каталогах:
- ОС Windows: C:\ProgramData\1C\1CE\instances\1c-enterprise-esb-with-ide\logs\server.log;
- ОС Linux: /var/opt/1C/1CE/instances/1c-enterprise-esb-with-ide/logs/server.log.
При анализе событий в журнале особое внимание требуется обратить на события, в которых указано «E!» и «W!», таким образом обозначаются ошибки и предупреждения.
В описании ошибки или предупреждения может быть указана причина, по которой сервер "1С:Шины" не может запуститься.
Ниже приведен пример ошибки и предупреждения:
Нужно искать проблему в подключении сервера "1С:Шины" к СУБД: проверить настройки подключения, а также доступность портов и сервера, на котором расположена СУБД.
- Такое сообщение можно встретить в журнале событий "1С:Шины", когда свободного места на диске сервера "1С:Шины" остается менее 1Гб. В этом случае, сервер "1С:Шины" будет принудительно остановлен:
2022/05/20-15:05:32.565 [Thread-21 (ActiveMQ-server-esb)](143) W! msgbroker.ArtemisEmbeddedServer - You are running out of disk space. Required free space is 1000000000 bytes
Необходимо обеспечить сервер "1С:Шины" достаточным количеством дискового пространства и выполнить его запуск.