Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Решение распространенных проблем

В разделе представлены инструкции по устранению проблем, возникающих при настройке компонентов Alpha.Domain, при редактировании конфигурационных файлов alpha.domain.agent.xml и alpha.net.agent.xml, и в процессе работы с Alpha.DevStudio. Раздел находится в разработке и будет дополняться. Подзаголовки раздела совпадают с текстами ошибок:

  • в журнале приложений Windows;
  • в приложении EventLogViewer;
  • в журнале ошибок приложения Alpha.DevStudio.

Ошибки в системных журналах или в EventLogViewer

Сервисы Alpha.Domain не запущены

Если сервисы alpha.domain.service и alpha.net.service не запускаются сразу после установки, необходимо сменить язык операционной системы с помощью команды sudo local-gen X.Y, где Х – язык операционной системы, а Y – формат кодировки. Например: sudo local-gen ru_RU.UTF-8.

Служба "ADA"/"DOMAINAGENT" не зарегистрирована

Разные версии Alpha.DevStudio обращаются к службам Alpha.Domain.Agent и Alpha.Net.Agent по разным именам. Старые версии обращаются по сокращённому имени – ADA или DOMAINAGENT. Новые версии обращаются по полному имени – Alpha.Domain.Agent. Из-за этого при использовании не совместимых между собой версий Alpha.DevStudio, Alpha.Server и Alpha.Domain возникает эта ошибка. Необходимо обновить Alpha.DevStudio, Alpha.Domain и Alpha.Server до версий, которые совместимы между собой.

Также проверьте, запущена ли служба Alpha.Domain.Agent. Иногда после перезапуска службы или компьютера она останавливается.

Ошибки в журнале приложения Alpha.DevStudio

Не удалось подключиться к агенту домена

Эта ошибка означает, что в конфигурационном файле alpha.net.agent.xml есть ошибки.

Проверьте, указаны ли необходимые параметры при конфигурировании. Убедитесь, что отсутствуют структурные ошибки (например, может быть не закрыт какой-либо из xml–элементов).

<ChildAgents>
 <ChildAgent Name="AstraNode" Port="1020">
  <Address value="199.99.145.144"/>
 </ChildAgent>
</ChildAgents>

Здесь:

  • </ChildAgent> – это закрывающий тег элемента ChildAgent, вложенного в элемент ChildAgents. Таких элементов может быть несколько.
  • </ChildAgents> – это закрывающий тег элемента ChildAgents. Такой элемент должен быть только один.

Обратите внимание, разница между названиями элементов состоит в последней букве – "s".

Также нужно проверить, совпадает ли номер порта, указанный в качестве значения атрибута NetEnterPort элемента Alpha.Net.Agent, и в настройках среды исполнения в Alpha.DevStudio. Чтобы проверить порт в настройках среды исполнения, перейдите к меню Файл -> Параметры -> раздел Среда исполнения -> поле Порт.

Не установлена связь с узлом сети 'Центральный узел сети'

В первую очередь необходимо проверить, что на центральном узле и на АРМ, на который вы хотите развернуть конфигурацию, стоят одинаковые версии Alpha.Domain и Alpha.Server.

Также стоит проверить связь между компьютерами с помощью команды ping ip_адрес_машины.

Проверьте, что брандмауэр в ОС Windows и файрвол в ОС Linux отключены.

Иногда при перезагрузке компьютера или сервиса список процессов не очищается полностью. Возникает ситуация, при которой создается новый процесс сервиса, а старый процесс не остановлен и не удален. Тогда центральный узел сети пытается соединиться со старым процессом. Проверьте, не "накопилось" ли в ОС Linux процессов сервисов Alpha.Domain с помощью команды ps ax | grep alpha. Если у alpha.domain.service и alpha.net.service больше, чем по 2 процесса на сервис (с идентификаторами SS SI), нужно завершить все процессы командной kill -9 id_процесса и перезагрузить компьютер.

Получатель запроса для маршрута '*имя_вашего_маршрута*' отсутствует

Эта ошибка означает, что Alpha.DevStudio не может связаться с тем АРМ, на который вы пытаетесь развернуть конфигурацию. Так происходит, когда в конфигурационном файле alpha.net.agent.xml на компьютере, являющемся центральным узлом сети Alpha.Net, неверно указано или вообще не указано значение атрибута Port элемента ChildAgent.

<ChildAgents>
 <ChildAgent Name="AstraNode" Port="1027" Address="199.99.145.139"/>
</ChildAgents>

Указанное здесь значение должно совпадать со значением атрибута ParentAgentPort элемента Alpha.Net.Agent в файле alpha.net.agent.xml на АРМ, на который вы разворачиваете конфигурацию.

Не забудьте перезагрузить сервисы alpha.domain.service, alpha.net.service и alpha.server.service после внесения изменений в файлы alpha.domain.agent.xml и alpha.net.agent.xml.

Ответ не получен за отведённое время

Это происходит из-за того, что в файле alpha.net.agent.xml на компьютере, который является центральным узлом, в качестве значения атрибута Port элемента ChildAgent был указан порт, который уже используется для передачи конфигурации. Нужно изменить значение, например, вместо 1020 указать 1021.

Новое значение нужно указать:

  • в качестве значения атрибута ParentAgentPort элемента Alpha.Net.Agent в файле alpha.net.agent.xml на АРМ, на который вы разворачиваете конфигурацию.
  • в качестве значения атрибута Port в элементе ChildNode в файле alpha.net.agent.xml на компьютере, который является центральным узлом.