Запуск и остановка программы ============================ Программа «Витрина данных НСУД» не имеет графического интерфейса и запускается, как служба, автоматически в фоновом режиме при загрузке операционной системы.  При необходимости ее можно остановить и запустить заново. Менеджер кластера ADCM ---------------------- Менеджер кластера ПО :term:`ADCM` представляет собой контейнер, управляемый ПО :term:`Docker`. Для запуска и остановки Менеджера кластера ADCM используются команды ПО :term:`Docker`. Запуск Менеджера кластера ADCM осуществляется согласно следующим этапам: 1. Запустить :term:`Docker` с Менеджером кластера ADCM командой:: :term:`` t docker start adcm 2. Подключиться через браузер к веб-интерфейсу по адресу:: http://:8000. 3. Авторизоваться в веб-интерфейсе. Остановка Менеджера кластера ADCM выполняется путём остановки :term:`Docker` командой:: docker stop adcm ADQM ---- Компонент запускается как ``systemd ``сервис автоматически при установке. Включен автозапуск сервиса при перезапуске сервера. 1. Запуск и остановка кластера ADQM через текстовый пользовательский интерфейс программной консоли Для ручной остановки и запуска необходимо подключиться по ``ssh`` на каждый сервер кластера и с правами ``sudo`` использовать штатный функционал ``systemctl``. Например:: sudo systemctl stop clickhouse-server sudo systemctl start clickhouse-server Запуск и остановка кластера ADQM через графический пользовательский интерфейс Менеджера кластера ADCM ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Графический пользовательский интерфейс Менеджера кластера ADCM предоставляет возможность независимо выполнять операции запуска и остановки кластера ADQM (см. :numref:`image30`). .. _image30: .. figure:: img/image30.png :align: center :alt: Программные кнопки запуска и остановки кластера ADQM в графическом пользовательском интерфейсе Менеджера кластера ADCM Программные кнопки запуска и остановки кластера ADQM в графическом пользовательском интерфейсе Менеджера кластера ADCM Запуск кластера ADQM через графический пользовательский интерфейс Менеджера кластера ADCM ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Перейти на вкладку кластера ADQM. 2. Нажать на программную кнопку Start, расположенную на верхней панели. 3. Подтвердить действие в открывшемся диалоговом окне. 4. Проверить успешность запуска кластера: - Обновить страницу графического интерфейса - Проверить изменение цвета пиктограммы статусов сервисов на зеленый - Проверить изменение текста описания состояния кластера ADQM с ``stopped`` на ``running``. Остановка кластера ADQM через графический пользовательский интерфейс Менеджера кластера ADCM ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Перейти на вкладку кластера ADQM. 2. Нажать на программную кнопку **Stop**, расположенную на верхней панели. 3. Подтвердить выбранное действие нажатием программной кнопки Run.44580 4. Проверить успешность остановки кластера: - Обновить страницу графического интерфейса. - Проверить изменение цвета пиктограммы статусов сервисов на оранжевый. - Проверить изменение текста описания состояния кластера ADB с ``running`` на ``stopped``. Диспетчер сообщений ADS ~~~~~~~~~~~~~~~~~~~~~~~ Компонент запускается автоматически при установке как два ``systemd`` сервиса: *Kafka* и *Zookeeper*. Включен автозапуск сервисов при перезапуске сервера. 1. Запуск и остановка сервисов ПО ADS через текстовый пользовательский интерфейс программной консоли Сервис *Kafka* всегда необходимо запускать после сервиса *Zookeeper*. Для ручной остановки и запуска необходимо подключиться по ``ssh`` на сервер и с правами ``sudo`` использовать штатный функционал ``systemctl``. Например:: sudo systemctl stop kafka sudo systemctl stop zookeeper sudo systemctl start zookeeper sudo systemctl start kafka Запуск и остановка сервисов ПО ADS через графический пользовательский интерфейс Менеджера кластера ADCM ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Графический пользовательский интерфейс Менеджера кластера ADCM предоставляет возможность независимо выполнять операции запуска, остановки и перезапуска для сервисов *Kafka* и *Zookeeper*. Запуск сервиса Zookeeper через графический пользовательский интерфейс Менеджера кластера ADCM """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти в пункт кластер ADS. 2. На вкладке **Services** для сервиса *Zookeeper* в поле **Actions** нажать на пиктограмму и выбрать действие **Start** (см. :numref:`image31`). .. _image31: .. figure:: img/image31.png :align: center :alt: Запуск сервиса Zookeeper ПО ADS из меню доступных операций в графическом пользовательском интерфейсе Менеджера кластера ADCM Запуск сервиса Zookeeper ПО ADS из меню доступных операций в графическом пользовательском интерфейсе Менеджера кластера ADCM Остановка сервиса Zookeeper через графический пользовательский интерфейс Менеджера кластера ADCM """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти в пункт кластер ADS. 2. На вкладке **Services** для сервиса *Zookeeper* в поле **Actions** нажать на пиктограмму и выбрать действие **Stop** (см. :numref:`image31`). Перезапуск сервиса Zookeeper через графический пользовательский интерфейс Менеджера кластера ADCM """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Для перезапуска компонентов сервиса Zookeeper в графическом пользовательском интерфейс необходимо: 1. Перейти в пункт кластер ADS. 2. На вкладке **Services** для сервиса *Zookeeper* в поле **Actions** нажать на пиктограмму и выбрать действие **Restart** (см. :numref:`image31`). Запуск сервиса Kafka через графический пользовательский интерфейс Менеджера кластера ADCM """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти в пункт кластер ADS. 2. На вкладке **Services** для сервиса *Kafka* в поле **Actions** нажать на пиктограмму и выбрать действие **Start**. Остановка сервиса Kafka через графический пользовательский интерфейс Менеджера кластера ADCM """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти в пункт кластер ADS. 2. На вкладке **Services** для сервиса Kafka в поле **Actions** нажать на пиктограмму и выбрать действие **Stop**. Перезапуск сервиса Kafka через графический пользовательский интерфейс Менеджера кластера ADCM """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Для перезапуска компонентов сервиса Kafka в графическом пользовательском интерфейс необходимо: 1. Перейти в пункт кластер ADS. 2. На вкладке **Services** для сервиса Kafka в поле **Actions** нажать на пиктограмму и выбрать действие **Restart**. Запуск и остановка диспетчера сообщений ADS на уровне кластера """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" ПО ADCM предоставляет через графический пользовательский интерфейс функцию запуска и остановки диспетчера сообщений ADS на уровне кластера (см. :numref:`image32`). .. _image32: .. figure:: img/image32.png :align: center :alt: Программные кнопки запуска и остановки диспетчера сообщений ADS в графическом пользовательском интерфейсе Менеджера кластера ADCM Программные кнопки запуска и остановки диспетчера сообщений ADS в графическом пользовательском интерфейсе Менеджера кластера ADCM ADB --- Кластер автоматически запускается при первичной установке. Далее при перезапуске сервера, необходимо запускать кластер вручную. Запуск и остановка кластера ADB через текстовый пользовательский интерфейс программной консоли ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Кластер запускается и останавливается через специальные утилиты :term:`Greenplum`. Для остановки и запуска необходимо подключиться по «ssh» на первичный мастер сервер и далее перейти в учетную запись администратора ``gpadmin``. Например:: sudo su - gpadmin Запуск кластера выполняется командой ``gpstart``. Например:: gpstart Остановку можно выполнить командой «gpstop» с добавлением необходимых ключей. Чаще используется ключ ``-M fast``. Например:: gpstop -M fast Подробнее о параметрах можно узнать в официальной документации https://gpdb.docs.pivotal.io/6-7/admin_guide/managing/startstop.html либо в справке команды используя ключ ``-h``. Запуск и остановка кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Графический пользовательский интерфейс Менеджера кластера ADCM предоставляет возможность независимо выполнять операции запуска, остановки кластера ADB. Запуск кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти на вкладку кластера ADB. 2. Нажать на программную кнопку Start, расположенную на верхней панели (см. :numref:`image33`). 3. Подтвердить действие в открывшемся диалоговом окне. 4. Проверить успешность запуска кластера: - Обновить страницу графического интерфейса. - Проверить изменение цвета пиктограммы статусов сервисов на зеленый. - Проверить изменение текста описания состояния кластера ADB с ``stopped`` на ``running``. .. _image33: .. figure:: img/image33.png :align: center :alt: Запуск кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM Запуск кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM Остановка кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти на вкладку кластера ADB. 2. Нажать на программную кнопку Stop, расположенную на верхней панели (см. :numref:`image34`). .. _image34: .. figure:: img/image34.png :align: center :alt: Остановка кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM Остановка кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM 3. Выбрать режим остановки ADB: - для остановки кластера ADB при отсутствии клиентских соединений выбрать режим ``smart``; - для принудительной остановки кластера ADB путём прерывания выполняющихся транзакций и закрытия соединений выбрать режим ``fast``; - для принудительной небезопасной остановки кластера ADB путём принудительного завершения процессов postgres без корректной обработки транзакции выбрать режим ``immediate``. 4. Подтвердить выбранное действие нажатием программной кнопки Run (см. :numref:`image35`). .. _image35: .. figure:: img/image35.png :align: center :alt: Выбор режима остановки кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM Выбор режима остановки кластера ADB через графический пользовательский интерфейс Менеджера кластера ADCM 5. Проверить успешность остановки кластера: - Обновить страницу графического интерфейса - Проверить изменение цвета пиктограммы статусов сервисов на оранжевый (см. :numref:`image33`) - Проверить изменение текста описания состояния кластера ADB с ``running`` на ``stopped`` (см. :numref:`image36`). .. _image36: .. figure:: img/image36.png :align: center :alt: Отображение через графический пользовательский интерфейс Менеджера кластера ADCM статусов остановленного кластера ADB Отображение через графический пользовательский интерфейс Менеджера кластера ADCM статусов остановленного кластера ADB ADG --- Компонент запускается как ``systemd`` сервисы автоматически при установке. Включен автозапуск сервисов при перезапуске сервера. Запуск и остановка кластера ADG через текстовый пользовательский интерфейс программной консоли ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Для ручной остановки и запуска необходимо подключиться по :term:`SSH` на каждый сервер кластера и с правами «sudo» использовать штатный функционал ``systemctl``. Сервисы могут устанавливаться на различных серверах кластера в зависимости от топологии. Перед тем как запустить или остановить сервис, необходимо убедиться, какие сервисы установлены на конкретном сервере. Для этого можно воспользоваться ``systemctl``. Например:: sudo systemctl \| grep memstorage Далее уже можно включить или выключить найденный сервис. Например:: sudo systemctl stop memstorage@api-1-master sudo systemctl start memstorage@api-1-master Запуск и остановка кластера ADG через графический пользовательский интерфейс Менеджера кластера ADCM ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ В силу того, что программная архитектура СУБД ADG значительно отличается от программных архитектур СУБД ADB и ADQM, запуск/остановка кластера ADG осуществляется в виде последовательности действий по созданию/удалению экземпляров ADG на каждом из хостов кластера. Графический пользовательский интерфейс Менеджера кластера ADCM предоставляет возможность выполнять операции создания и удаления экземпляров ADG. Создание экземпляра ADG через графический пользовательский интерфейс Менеджера кластера ADCM """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти на вкладку кластера ADG в раздел *SERVICES -> GRID*. 2. Нажать на программную кнопку **Add_instance**, расположенную на верхней панели. 3. Подтвердить действие в открывшемся диалоговом окне (см. Рисунок 37) нажатием программной кнопки **Run**. 4. Проверить успешность создания экземпляра ADG. Удаление экземпляра ADG через графический пользовательский интерфейс Менеджера кластера ADCM """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 1. Перейти на вкладку кластера ADG в раздел *SERVICES -> GRID*. 2. Нажать на кнопку **Remove_instance**, расположенную на верхней панели. 3. Подтвердить действие в открывшемся диалоговом окне (см. :numref:`image38`). Для этого нажмите кнопку **Run**. 4. Проверить успешность удаления экземпляра ADG. .. _image37: .. figure:: img/image37.png :align: center :alt: Добавление экземпляра ADG Добавление экземпляра ADG .. _image38: .. figure:: img/image38.png :align: center :alt: Удаления экземпляра ADG Удаления экземпляра ADG Ядро витрины  ProStore ---------------------- Запуск ProStore ~~~~~~~~~~~~~~~ Для ручной остановки и запуска необходимо подключиться по ``ssh`` на сервер и с правами ``sudo`` использовать штатный функционал ``systemctl``. Например:: sudo systemctl stop query-execution sudo systemctl start query-execution sudo systemctl start kafka-clickhouse-reader sudo systemctl stop kafka-clickhouse-reader sudo systemctl start kafka-clickhouse-writer sudo systemctl stop kafka-clickhouse-writer sudo systemctl stop status-monitor sudo systemctl start status-monitor СМЭВ3-адаптер ------------- СМЭВ3-адаптер представляет собой jar-файл. Запуск СМЭВ3-адаптера ~~~~~~~~~~~~~~~~~~~~~~~ Для ручного запуска необходимо подключиться по ``ssh`` на сервер и в командной строке запустить jar-файл, указав его расположение. Например:: *java -jar smev3-connector-fat.jar* *-Dconfig.location=* *(опционально) -Dlogging-profile=json - для логов в json формате* *(опционально) -Dlogback.configurationFile=* Для ручной остановки необходимо подключиться по «ssh» на сервер, найти процесс, который содержит jar-файл и остановить его. Например:: pgrep -f smev3-connector-x.x.x-fat.jar:dtm-jdbc-3.4.0.jar \` kill «номер процесса» Настройка СМЭВ3-адаптера ~~~~~~~~~~~~~~~~~~~~~~~~ Для каждого ``verticles`` можно настроить количество ``instance``'ов. Шаблоны настраиваются в ``SmevReceiverVerticle`` и ``RestReceiverVerticle``. Пример конфигурации файла ``application.yml`` для СМЭВ3 коннектора см. в Приложении 1. Сервисная БД СМЭВ3-адаптер ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Ручной запуск и остановка сервисной БД адаптера СМЭВ3 приведены в официальной документации: https://postgrespro.ru/docs/postgrespro/13/admin Запуск ПОДД-адаптер ------------------- .. Подключаем файл с запуском ПОДД-адаптер .. include:: ../../modules/podd-adapter-query/doc/podd_adapter_query_start.rst ETL --- Apache Airflow ~~~~~~~~~~~~~~ :term:`Apache Airflow` представляет собой набор контейнеров, управляемых :term:`Docker`. Для запуска и остановки :term:`Apache Airflow` используется файл ``docker-compose.yml`` (см. п. 3.2.15.1.2). Для запуска и установки :term:`Apache Airflow` необходимо выполнить следующее: 1. Перейти в директорию с файлом docker-compose.yml, созданным при установке :term:`Apache Airflow`: Например:: cd ~/direct 2. Остановка :term:`Apache Airflow`. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду:: docker-compose stop 3. Запуск :term:`Apache Airflow`. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду:: docker-compose start Apache Spark ~~~~~~~~~~~~ :term:`Apache Spark` представляет собой контейнер, управляемый :term:`Docker`. Для запуска и остановки Apache :term:`Apache Spark` используется файл ``docker-compose.yml`` из директории :term:`Apache Spark`. 1. Перейти в директорию с файлом ``docker-compose.yml``, созданным при установке Apache Spark. Например:: cd ~/direct 2. Остановка Apache Spark. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду:: docker-compose stop 3. Запуск Apache Spark. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду:: docker-compose start Для запуска и остановки отдельно мастера и воркера Apache Spark можно использовать команды :term:`Docker`: Запуск:: docker start spark-master docker start spark-worker-1 Остановка:: docker stop spark-master docker stop spark-worker-1 1. Apache Hadoop :term:`Apache Hadoop` представляет собой набор контейнеров, управляемых :term:`Docker`. Для запуска и остановки :term:`Apache Hadoop` используется файл ``docker-compose.yml`` из директории :term:`Apache Hadoop`. 1. Перейти в директорию с файлом ``docker-compose.yml``, созданным при установке :term:`Apache Hadoop`: Например:: cd ~/direct 2. Остановка Apache Hadoop. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду:: docker-compose stop 3. Запуск Apache Hadoop. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду: docker-compose start Для запуска и остановки отдельно каждого контейнера :term:`Apache Hadoop` можно использовать команды :term:`Docker`: Запуск:: docker start namenode docker start datanode docker start resourcemanager docker start nodemanager docker start historyserver Остановка: docker stop namenode docker stop datanode docker stop resourcemanager docker stop nodemanager docker stop historyserver СУБД Tarantool ~~~~~~~~~~~~~~ СУБД :term:`Tarantool` представляет собой контейнер, управляемый :term:`Docker`. Для запуска и остановки СУБД Tarantool используется файл ``docker-compose.yml`` из директории СУБД Tarantool. 1. Перейти в директорию с файлом ``docker-compose.yml``, созданным при установке СУБД Tarantool: Например: cd ~/direct 2. Остановка СУБД Tarantool. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду:: docker-compose stop 3. Запуск СУБД Tarantool. В папке, где лежит файл ``docker-compose.yaml`` нужно выполнить следующую команду: docker-compose start Для запуска и остановки отдельно каждого контейнера СУБД Tarantool можно использовать команды :term:`Docker`: Запуск:: docker start tarantool1 docker start tarantool2 Остановка:: docker stop tarantool1 docker stop tarantool2 REST-адаптер ------------ :term:`REST-адаптер` представляет собой контейнер, управляемый :term:`Docker`. Для запуска и остановки :term:`REST-адаптер` используются команды :term:`Docker`. Запуск :term:`REST-адаптер` выполняется путём запуска :term:`Docker` командой:: docker start rest-adapter Остановка :term:`REST-адаптер` выполняется путём остановки :term:`Docker` командой: docker stop rest-adapter