Alpha.Community

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

Создание простого проекта

В этом разделе вы научитесь:

  • Создавать проекты и решения.
  • Описывать в них Alpha.Server.
  • Выполнять развертывание: строить конфигурацию и применять её к Alpha.Server.

Подготовка: создание домена

Домен – это среда исполнения, в которой исполняется проект, описанный в Alpha.DevStudio. Домен состоит из исполняющих компонентов – экземпляров Alpha.Server и Alpha.AccessPoint.

В описываемом примере в домене будет один исполняющий компонент – Alpha.Server.

  1. Установите Alpha.Server.

    Alpha.Server должен быть установлен на компьютере, где установлена Alpha.DevStudio, или на компьютере, к которому есть доступ по сети.

  2. Установите Alpha.Domain на компьютере, на котором установлен Alpha.Server.

    Alpha.Domain – это надстройка над исполняющими компонентами, которая объединяет их в домен и позволяет Alpha.DevStudio их конфигурировать.

Настройка связи Alpha.DevStudio с доменом

Укажите приложению Alpha.DevStudio, в каком домене будет развернут проект конфигурации. Для этого:

  1. Запустите Alpha.DevStudio:

    • В меню Пуск: Пуск → Automiq → Alpha.DevStudio
    • В файловой системе: C:\Program Files\Automiq\Alpha.DevStudio\DevStudio.exe
  2. Откройте окно параметров: меню Файл → Параметры....

  3. В узле Среда исполнения укажите:

    • IP-адрес компьютера, на котором установлен Alpha.Domain.
    • Порт доступа к Alpha.Domain – 1010.

  4. Нажмите кнопку Закрыть: изменения будут сохранены.

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

Создание проекта

В данном примере проект создается вместе с решением, в которое входит. Чтобы создать проект:

  1. В меню на панели инструментов выберите: Файл → Создать проект....

  2. В открывшемся окне:

    1. Выберите шаблон Пустой проект и нажмите Далее.

      С описанием всех шаблонов проектов можно ознакомиться в разделе Решения и проекты.

    2. Укажите произвольные имя проекта, папки размещения и имя решения.

В результате:

  • Решение и проект будут созданы.
  • Будут созданы папки для хранения файлов решения и проекта (набор папок зависит от того, какие флаги были установлены).
  • Решение откроется в среде разработки.

Проект создан. Теперь нужно описать в нём Alpha.Server.

Описание Alpha.Server в проекте

Чтобы описать Alpha.Server, для которого нужно создать конфигурацию, в проекте, выполните следующее:

  1. Добавьте в проект элемент Alpha.Domain.

    Чтобы добавить элемент, перетащите его из панели элементов в рабочую область.

    Элемент Alpha.Domain предназначен для описания среды исполнения, т.е. домена:

    • Компоненты верхнего уровня АСУ ТП: серверные компьютеры, выполняющие сбор, обработку и хранение данных, и АРМы операторов.
    • Системы, с которыми они взаимодействуют: компоненты среднего уровня и сторонние системы.
  2. Выберите добавленный элемент, и в свойстве Адрес укажите local – это будет имя домена. Такое имя по умолчанию указано в настройках службы Alpha.Domain.

    Свойство Адрес предназначено для указания имени домена в конфигурации Alpha.Domain, а свойство Имя – для указания имени элемента в Alpha.DevStudio.
  3. Перейдите в добавленный Alpha.Domain.

    Чтобы перейти в элемент, кликните по его имени или дважды кликните по нему в обозревателе решений.

  4. Добавьте элемент Узел Alpha.Domain.

    Элемент Узел Alpha.Domain предназначен для описания компьютера, на котором есть серверные компоненты Альфа платформы: Alpha.Server и/или Alpha.Historian.

    Здесь следует указать значения для следующих свойств:

    • Имя – сетевое имя компьютера, на котором установлен Alpha.Server;
    • Семейство операционной системы – ОС компьютера, на котором установлен Alpha.Server.

    Обратите внимание, что по умолчанию значение свойства Семейство операционной системы – linux.

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

  5. Перейдите в добавленный Узел Alpha.Domain.
  6. Укажите у Ethernet-адаптера локальный адрес 127.0.0.1 в качестве значения свойства Адрес.

  7. Добавьте элемент Alpha.Server. В качестве имени элемента укажите Server – в дальнейшем это имя описываемого экземпляра Alpha.Server будет использовано в настройках службы Alpha.Domain для того, чтобы служба "поняла", для какого экземпляра предназначена создаваемая конфигурация.

  8. Перейдите в добавленный Alpha.Server.

    Здесь уже описан начальный набор модулей. Этих модулей для описываемого примера будет достаточно. Теперь надо описать данные сервера.

  9. Добавьте Приложение – элемент, в котором описываются данные исполняющего компонента.

    Обратите внимание, что в любом исполняющем компоненте может быть только одно приложение.

  10. Перейдите в добавленное Приложение.
  11. Опишите сигнал.

    В Alpha.DevStudio есть два элемента для описания сигналов: Параметр и Событие. Оба эти элемента при применении конфигурации преобразуются в сигналы, но различаются по назначению и функциям, которые выполняют.

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

Проект готов к развертыванию.

Построение решения и настройка домена

Постройте решение.

При построении сначала выполняется проверка наличия ошибок. Если ошибок не обнаружено, создаются конфигурационные файлы проекта.

Перейдите к свойствам проекта: в свойстве Путь вывода по умолчанию указана папка bin. Эта папка создается в папке проекта, она предназначена для хранения конфигурационных файлов, создаваемых в процессе построения решения. Перейдите внутрь папки по пути bin\имя-вашей-среды-исполнения\имя-вашего-элемента-домена-\имя-вашего-элемента-узла-домена: здесь появился конфигурационный файл службы Alpha.Domain – alpha.domain.agent.xml. Этот файл нужно скопировать в папку, предназначенную для хранения конфигурационных файлов службы – C:\Program Files\Automiq\Alpha.Domain – а затем перезапустить службу Alpha.Domain.Agent.

Ознакомьтесь с файлом: здесь вы увидите использованные в проекте имена домена, компьютера и экземпляра службы Alpha.Server.

Развертывание конфигурации

Выполните развертывание:

  1. Откройте Мастер развертывания.

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

  2. Примените конфигурацию к Alpha.Server, нажав кнопку .

    Alpha.DevStudio передаст конфигурацию компоненту Alpha.Domain, который применит её к Alpha.Server и перезапустит службу.

Проверьте, что конфигурация применилась: подключитесь к Alpha.Server с помощью Конфигуратора или OpcExplorer и убедитесь, что в дереве сигналов есть добавленный вами сигнал.