Alpha.Community

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

Подготовка среды исполнения и хранилища состояния

Прежде чем перейти к разработке проекта, выполните подготовку среды исполнения и выберите тип хранилища состояния.

  • Настройки среды исполнения указывают на домен, в котором будет исполняться проект.
  • От выбранного типа хранилища состояний зависит, где будут храниться идентификаторы элементов. Подробнее об этом – ниже.

Чтобы перейти к настройкам, откройте окно параметров: в меню Файл → Параметры....

Откроется окно параметров приложения.

Настройка среды исполнения

При подготовке можно описать сразу несколько сред исполнения. Все они появятся в выпадающем списке на панели инструментов. Переключение между средами исполнения используется при выборе домена, в котором должно выполниться развёртывание.

Эти настройки хранятся в программе и не зависят от проекта, открытого в среде разработки. Это позволяет развёртывать один и тот же проект в разные домены, например, на рабочий и тестовый.

Настроить существующую среду исполнения или добавить новую можно в области Среда исполнения. Выберите среду из выпадающего списка или добавьте новую, затем укажите её параметры.

Параметры среды исполнения:

  1. В поле Описание укажите любое название.
  2. В области Точка входа укажите параметры подключения к любому компьютеру домена, на котором установлен Alpha.Net.Agent (входит в дистрибутив Alpha.Domain):

    • Адрес – IP-адрес компьютера, на котором функционирует Alpha.Net.Agent;
    • Порт – значение атрибута NetEnterPort в конфигурации Alpha.Net.Agent;
    • Таймаут запроса, сек – время ожидания ответа между попытками подключения.
  3. Если при создании среды исполнения вы установите галочку в поле Тестовая среда исполнения, то среда будет считаться тестовой, и в мастере развертывания:

    • заголовок окрасится в светло-оранжевый цвет;
    • в правом верхнем углу отображается значок предупреждения с подсказкой "В режиме тестирования развертывание выполняется без дополнительных подтверждений";
    • если хранилище или исполняющий компонент отличается, отображается предупреждение об этом, но вводить имя компьютера как при обычном развертывании не требуется.

После этого нажмите кнопку Закрыть – изменения будут сохранены.

Чтобы вернуться к значениям параметров по умолчанию, нажмите в правом верхнем углу окна Параметры.

Все описанные среды появятся в выпадающем списке на панели инструментов. Теперь перед развёртыванием решения можно будет выбрать нужную среду исполнения.

Выбор типа хранилища состояния

Под хранилищем состояния подразумевается локальная папка или папка в удалённом репозитории SysEvo, предназначенная для хранения внутренних идентификаторов элементов (сигналов, приложений и пр.). Внутренние идентификаторы используются для обращения к определенным сигналам, например, при запросе исторических значений. Идентификаторы присваиваются сигналам в момент создания параметров, описывающих их.

Хранилище имеет следующую структуру:

При создании хранилища состояний в файл info.json в папке SysEvo записывается id – уникальный идентификатор хранилища.

Обратите внимание, что удаление этой папки может привести к проблемам с доступом к истории значений.

Если необходимо сменить хранилище, или перенести проект на другой АРМ, обратитесь к инструкции Смена используемого хранилища состояния

Рекомендуется хранить все идентификаторы проекта в одном хранилище, например, в удаленном репозитории.

При работе с проектом на разных АРМ разными пользователями нужно обязательно использовать одно и то же хранилище. Так, например:

  • Если переименовать или переместить параметр, он будет считаться новым элементом, и ему будет присвоен новый идентификатор, хотя он по-прежнему будет описывать ту же сущность, что и ранее.
  • Если применить конфигурацию, а затем перенести проект на другой АРМ без папки SysEvo и применить конфигурацию заново, папка SysEvo также будет создана заново, элементы получат новые идентификаторы, и исторические значения сигналов, описанных в проекте, не будут связаны с новыми сигналами.
  • Если перенести содержимое одного приложения в другое, идентификаторы будут изменены, и исторические значения сигналов, описанных в проекте, не будут связаны с новыми сигналами.

Использование единого хранилища позволяет избежать проблем, связанных с подобными действиями.

Как настроить работу над проектом несколькими пользователями с помощью системы контроля версий SVN, описано в разделе Совместная разработка проекта несколькими пользователями.

Выбрать тип хранилища состояния можно из выпадающего списка в области Хранилище состояния.

При выборе типа хранилища отобразятся поля параметров для хранилища выбранного типа.

Тип хранилища Описание
Вместе с проектом Папка с идентификаторами SysEvo будет создаваться (или перезаписываться) в той же папке, где хранится проект.
Файловая система При выборе этого типа хранилища появится поле для указания полного пути к папке в файловой системе текущего компьютера, где должна храниться папка с идентификаторами SysEvo.
Локальный репозиторий

При выборе этого типа хранилища появятся поля:

  • Репозиторий – здесь следует указать папку основного хранилища идентификаторов элементов;
  • Рабочая копия – папка для хранения идентификаторов, находящуюся под контролем версий SVN.

Рабочая копия предназначена для сохранения идентификаторов элементов при разработке конфигураций. После построения решения идентификаторы элементов сохраняются в репозиторий.

Удаленный репозиторий

При выборе этого типа хранилища появятся поля:

  • Репозиторий – здесь следует указать адрес репозитория для хранения внутренних идентификаторов элементов;
  • Пользователь – логин учетной записи пользователя, имеющего доступ к указанному репозиторию;
  • Пароль – пароль учетной записи пользователя, имеющего доступ к указанному репозиторию;
  • Рабочая копия – адрес локальной папки для хранения идентификаторов.

О том, как работать с удалённым репозиторием, читайте в разделе Совместная разработка проекта несколькими пользователями.

Чтобы вернуться к значениям параметров по умолчанию, нажмите в правом верхнем углу окна Параметры.

Смена используемого хранилища состояния

Если по какой-либо причине необходимо сменить используемое хранилище, сохранив при этом идентификаторы, то нужно перенести содержимое используемого хранилища в новое место.

Хранилище содержит идентификаторы всех приложений, которые когда-либо строились в рамках текущей среды исполнения. Для переноса нужных файлов необходимо определить идентификаторы доменов и приложений, которые нужны в новом хранилище. Определить идентификатор каждого домена и приложения по названию можно, открыв файл *.omx (файл с исходным текстом в формате XML).

Здесь приведена часть файла *.omx, в котором можно определить идентификатор любого элемента по его названию.

<dp:domain-node name="Domain" uuid="xxx111ab-9974-43f9-a57a-864e5f56ca78">
 <srv:io-server name="Server" uuid="xxx11183-d806-4fa8-842d-5ab83905ba54" debug-output="true">
  <dp:application-object name="Application" uuid="xxx11120-85a9-419a-bae0-1d52c4e658ff">
   <ct:object name="Messages" uuid="xxx11179-be48-4208-bf12-5bf2d9e32a90">
    <ct:parameter name="Message" direction="none" type="string" uuid="xxx111a3-14cc-494e-ae56-bce141a23472">
    </ct:parameter>
   </ct:object>
  </dp:application-object>
 </srv:io-server>
</dp:domain-node>

Чтобы понять, куда именно требуется перенести содержимое хранилища, можно построить решение для среды исполнения с новым хранилищем. В процессе построения будут созданы папки, соответствующие доменам и приложениям данного решения.

Пусть необходимо перенести идентификаторы из удаленного репозитория SVN в хранилище (папку) рядом с проектом. Для этого:

  1. В окне Параметры в настройках среды исполнения выберите тип нового хранилища – Вместе с проектом. Постройте решение. В процессе построения рядом с папкой каждого проекта будет создана папка SysEvo, содержащая папки хранилища в соответствии с описанной выше структурой.
  2. Извлеките из удаленного репозитория рабочую копию хранилища. Если репозиторий не удаленный, а локальный, то для него достаточно открыть папку рабочей копии, указанную в настройках среды исполнения, поскольку извлечение выполняется при каждом построении (по умолчанию это C:\ProgramData\Automiq\SysEvo\WorkingCopy).
  3. Найдите в рабочей копии репозитория папки с идентификаторами всех доменов и приложений, которые нужно перенести в новое хранилище. Перенесите файлы tagid-key-index.lmap из этих папок в соответствующие папки нового хранилища рядом с проектом.

Наличие папки SysEvo рядом с проектом не означает, что при построении будут использоваться идентификаторы из этой папки. Они будут использоваться только тогда, когда в настройках среды указан тип хранилища Вместе с проектом.

О причинах возникновения ошибки "Не удалось начать транзакцию обновления индекса. В настоящее время активна другая транзакция"

Иногда при компиляции решения может возникать ошибка с текстом Не удалось начать транзакцию обновления индекса. В настоящее время активна другая транзакция. Причиной ошибки является блокировка хранилища состояния, которая не была снята по окончанию компиляции. Блокировка может происходить из-за какой-либо нештатной ситуации, произошедшей во время компиляции решения.

Снять блокировку хранилища можно вручную. Для этого удобнее всего воспользоваться клиентским приложением SVN – TortoiseSVN. Установите его, а затем выполните следующие шаги.

  1. Определите, где находится рабочая копия хранилища. Для этого откройте меню Файл → Параметры.... Путь к рабочей копии указан в поле Рабочая копия в области Хранилище состояния.
  2. Откройте указанную папку в проводнике. Через контекстное меню вызовите команду TortoiseSVN → Repo-browser.
  3. Найдите в открывшемся окне файл index.lock. Откройте контекстное меню файла и выберите команду Break lock.