1. Перечень принятых сокращений

АРМ  — автоматизированное рабочее место

БД  — база данных

ПО  — программное обеспечение

2. Цель документа

Инструкция предназначена для проведения установки ПО серверной и клиентской части программного комплекса «Надежность» (далее — Программа) и его дальнейшего использования.

3. Область применения

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

4. Требования к аппаратному и программному обеспечению

4.1. Требования к оборудованию АРМ

Оборудование АРМ должно соответствовать характеристикам, приведенным в таблице 1.

Таблица 1. Требования к оборудованию АРМ
Оборудование компьютера Минимальное требование

Процессор

4-ядерный 64-разрядный (x64) процессор с тактовой частотой 2.7 ГГц

Оперативная память

8 ГБ

Видеокарта

Требование не предъявляется

Жесткий диск (свободное пространство)

500 ГБ

Сетевой интерфейс

1 Гбит/с

4.2. Требования к программному обеспечению АРМ

Программное обеспечение АРМ должно соответствовать характеристикам, приведенным в таблице 2.

Таблица 2. Требования к программному обеспечению АРМ
Программное обеспечение Требуемая версия

Операционная система

Windows 10 64 бит
Windows Server 2016 64 бит

Веб-браузер

Chrome Версия 124.0.6367.119 (Официальная сборка), (64 бит)

PostgreSQL

14.0

pgAdmin 4

6.21 и выше

5. Процесс установки

5.1. Общая информация

Для корректной работы Программы необходимо создать новую роль и базу данных. Использование служебной роли и базы данных системы PostgreSQL при настройке Программы (см. раздел 5.5) не рекомендуется.

Процесс установки ПК «Надежность» состоит из нескольких этапов:

  • создание и подготовка базы данных к использованию;

  • установка и настройка программного комплекса «Надежность»;

  • запуск программного комплекса «Надежность».

5.2. Создание нового пользователя в PostgreSQL

Для корректной работы Программы необходимо создать новую роль в PostgreSQL. Создание новой роли осуществляется при помощи программы pgAdmin:

  1. в дереве серверов для выбранного сервера в разделе Login/Group Roles добавить новую роль, например, test_user (Login/Group Roles → Create → Login/Group Role…​ → test_user, см. рисунок 1);

  2. для созданной роли на вкладке Definition задать пароль, например, 123qweASD (см. рисунок 2);

  3. на вкладке Privileges отметить все привилегии, кроме параметра Create roles? (см. рисунок 3).

5.3. Создание новой базы данных в PostgreSQL

Для корректной работы Программы необходимо создать новую базу данных в PostgreSQL. Создание новой базы данных осуществляется при помощи программы pgAdmin:

  1. необходимо запустить pgAdmin, подключиться к серверу и перейти в раздел Databases;

  2. вызвать контекстное меню на элементе Databases и выбрать пункт Create → Database…​ (см. рисунок 4);

  3. в открывшемся окне задать наименование базы и назначить владельцем БД ранее созданного пользователя (см. рисунок 5).

    П р и м е ч а н и е — Наименование базы данных в PostgreSQL не должно начинаться с цифры и не должно содержать буквы кириллицы, заглавные буквы латиницы и спецсимволы (кроме символа подчеркивания — «_»).

5.4. Установка Программы

Дистрибутив программного комплекса «Надежность» необходимо распаковать в путь установки системы: C:\Program Files\DM\Wi\ (см. рисунок 6).

5.5. Настройка Программы

Для настройки Программы необходимо:

  1. перейти в папку C:\Program Files\DM\wi с установленной Программой;

  2. найти в папке файл wi_config;

  3. открыть данный файл в любом текстовом редакторе (например, стандартной программе «Блокнот», см. рисунок 7);

  4. изменить параметры блока connectionstring на соответствующие значения, указанные при создании базы данных в PostgreSQL:

    • host=<имя хоста> (по умолчанию localhost);

    • port=<номер порта> (по умолчанию 5433);

    • dbname=<имя базы данных в PostgreSQL> (по умолчанию maks30);

    • user=<имя пользователя> (по умолчанию postgres);

    • password=<пароль> (по умолчанию 123qweASD).

  5. сохранить изменения и закрыть текстовый редактор.

П р и м е ч а н и е — Не рекомендуется использование служебной роли и базы данных системы PostgreSQL в качестве данных пользователя и наименования БД в файле wi_config.

6. Развертывание сервера лицензии

Для запуска сервера лицензии необходимо произвести следующие действия:

  1. на автоматизированном рабочем месте (АРМ), где будет запущен сервер, выполнить файл node_info.exe из директории с программой. После запуска файла в той же директории будет создан файл node_info.dat;

  2. переслать файл node_info.dat в техподдержку АО «Цифровая мануфактура» по адресу cad_support@manufactory.digital;

  3. разместить полученный в ответном письме файл dongle.dat в одной директории с wi.exe.

7. Запуск Программы

Для запуска Программы необходимо:

  1. открыть командную строку от имени администратора одним из следующих способов:

    • выбрать пункт «Запуск от имени администратора» для приложения «Командная строка» в меню «Пуск» (см. рисунок 8);

    • нажать сочетание клавиш Win + R, затем в открывшемся окне «Выполнить» ввести cmd и нажать сочетание клавиш Ctrl + Shift + Enter (данное сочетание клавиш выполняет введенную команду от имени администратора, см. рисунок 9).

  2. ввести в командной строке cd "c:\Program Files\DM\wi" — для перехода в директорию с установленной Программой (см. рисунок 10);

  3. ввести команду wi.exe -f и нажать Enter (см. рисунок 11);

    installer cmd first launch
    Рисунок 11. Выполнение программы в командной строке

    П р и м е ч а н и е — При первом запуске Программы отобразится сообщение Database is successfully upgraded, restart application after it exits — это не ошибка, оно лишь сигнализирует о том, что созданная в PostgreSQL база теперь готова для работы с Программой. На этом этапе — после создания базы в PostgreSQL, но до внесения в нее изменений — возможно развертывание дампа демонстрационной базы данных (см. раздел 8).

  4. повторно запустить Программу, введя команду wi.exe -f и нажав Enter (см. рисунок 12);

  5. убедиться в отсутствии ошибок в системных сообщениях, отображаемых в окне командной строки;

  6. запустить веб-браузер Chrome;

  7. в адресной строке веб-браузера ввести https://127.0.0.1:8080/ или https://localhost:8080/ и нажать Enter;

  8. на открывшейся странице авторизации в Программе необходимо (см. рисунок 13):

    1. в поле «Логин» указать admin;

    2. в поле «Пароль» указать testpassword.

П р и м е ч а н и е — В случае, если отображается ошибка «Подключение не защищено», в нижней части страницы нажать на кнопку «Дополнительные настройки», а затем нажать на ссылку «Перейти на сайт ххх.ххх.ххх.ххх (небезопасно)» (см. рисунок 14).

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

  1. щелкнуть правой кнопкой мыши на файл wi.exe и в открывшемся контекстном меню выбрать пункт «Создать ярлык» (см. рисунок 15);

  2. щелкнуть правой кнопкой мыши на созданный файл wi.exe — ярлык и выбрать пункт «Свойства»;

  3. в открывшемся окне перейти на вкладку «Ярлык»;

  4. в графе «Объект» после "C:\Program Files\DM\wi\wi.exe" (после закрывающих кавычек) через пробел написать -f (см. рисунок 16);

  5. нажать на кнопку OK для сохранения изменений;

  6. поместить файл ярлыка в любое удобное место.

8. Развертывание дампа демонстрационной БД

Развертывание дампа демонстрационной БД возможно, только если Программа запускалась хотя бы один раз.

Демонстрационная БД поставляется в комплекте с Программой и содержит предзаполненную пользовательскую библиотеку.

Для развертывания демонстрационной БД необходимо:

  1. убедиться, что Программа не запущена. Если Программа запущена, то необходимо завершить работу Программы:

    1. в командной строке с запущенной Программой ввести команду stop и нажать на клавишу Enter;

    2. ввести команду y и нажать на клавишу Enter для подтверждения завершения работы Программы.

  2. ввести команды для развертывания БД в одной из двух командных оболочек от имени администратора:

    1. Bash:

      • перейти в директорию с установленной Программой;

      • ввести команду psql -h <localhost> -p <port> -U <username> -d <dbname> < "<fullpath>" и изменить параметры команды на соответствующие значения, указанные при создании базы данных в PostgreSQL:

        • <localhost> — имя хоста;

        • <port> — номер порта;

        • <username> — имя пользователя;

        • <dbname> — имя базы данных;

        • <fullpath> — полный путь к файлу library_demo.dump.

      • нажать на клавишу Enter.

    2. PowerShell:

      • перейти в директорию с установленной Программой;

      • ввести команду psql.exe -h <localhost> -p <port> -U <username> -d <dbname> < "<fullpath>" и изменить параметры команды на соответствующие значения, указанные при создании базы данных в PostgreSQL:

        • <localhost> — имя хоста;

        • <port> — номер порта;

        • <username> — имя пользователя;

        • <dbname> — имя базы данных;

        • <fullpath> — полный путь к файлу library_demo.dump.

      • нажать на клавишу Enter.

  3. запустить Программу.

9. Техническая поддержка

При сбоях или некорректной установке ПО, а также по всем возникающим вопросам необходимо обратиться в техническую поддержку: