Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление

Копирование и перенос с помощью скриптов

Помимо переноса данных вручную, (см. описание в Копирование данных и Развертывание данных) в Платформе также имеется автоматизированная возможность переноса данных с помощью скриптов копирования и развертывания: "backup.sh" и "restore.sh". Скрипты входят в стандартную поставку платформы.


Для копирования данных необходимо воспользоваться скриптом: "backup.sh"

Скрипт производит действия, описанные в разделе Копирование данных, а именно:

  1. Копирование DashboardServer
  2. Копирование данных ViQube
  3. Копирование данных ViQube Admin
  4. Копирование данных SSBI
  5. Копирование данных proxy
  6. Копирование данных ViTalk
  7. Копирование данных Data CollectionSmart Forms


Для развертывания данных необходимо воспользоваться скриптом: "restore.sh"

Скрипт производит действия, описанные в разделе Развертывание данных, а именно (кроме лицензий):

  1. Развертывание DashboardServer
  2. Развертывание данных Data CollectionSmart Forms
  3. Развертывание данных ViTalk
  4. Развёртывание данных proxy, ssbi, viqube-admin и viqube


Примечание
titleОграничения

При переносе данных версии на стендах должны быть одинаковые, нельзя переносить данные между разными версиями стендов

  • Не переносятся Планы загрузки в ViQube Admin
  • Не переносятся настройки автоматического переноса данных из Smart Forms
  • .


    Инструкция по переносу

    Подготовка

    Предупреждение
    1. Рекомендуется создать контрольную точку на стенде, на который переносятся измерения
    2. Обязательно скопируйте Лицензионный ключ с Портала на стенде, на который переносятся измерения: "Основные"→ "Лицензия".
      Ключ понадобится по итогам разворачивания данных.
    3. Перед запуском скриптов необходимо настроить свои параметры доступа

    ...

    1. в

    ...

    1. файлах "backup.sh", "restore.sh".

    Копирование

    1. Задать в скрипте "backup.sh"

      свои параметры доступа к БДРазметить

      все параметры (имена пользователей и пароли) доступа к компонентам платформы.

      Раскрыть
      titleВыжимка из скрипта со списком параметров

      SF_POSTGRES_USER="postgres"
      SF_POSTGRES_PASSWORD="Postgres9"
      VL_POSTGRES_USER="viloaderuser"
      VA_POSTGRES_USER="postgres"
      VA_POSTGRES_PASSWORD="Postgres9"
      SYSTEM_USERNAME="admin"
      SYSTEM_USERNAME_PASSWORD="123456"


      Информация
      iconfalse
      В большинстве случаев вам будет достаточно задания только SYSTEM_USERNAME и SYSTEM_USERNAME_PASSWORD, то есть логин и пароль от учетной записи администратора платформы. Остальные доступы к Postgres по умолчанию используются только внутри платформы при взаимодействии ее компонентов между собой и редко меняются. Посмотреть эти доступы к Postgres можно в файлах config.json в соответствующих папках компонентов внутри каталога /docker-volume.


    2. Размеcтить скрипт  "backup.sh" в каталоге, в котором будет будет создан архив с данными для переноса
    3. Перейдите в каталог с "backup.sh"
    4. Дать Дать права на исполнениена исполнение:

      Блок кода
      languageactionscript3
      themeRDark
      sudo chmod +x *.sh


    5. Запустить скрипт для получения архива получения архива с данными для переноса

      Блок кода
      languageactionscript3
      themeRDark
      sudo ./backup.sh -p <address> --https <on|off> --with-platform-stop <yes|no> --only-smart-forms <yes|no> --only-viqube <yes|no> 


      Примечание
      • -p <address>
        Адрес сервера, с которого снимается дамп данных. Значение параметра может быть как IP-адресом, так и доменным именем сервера с установленной платформой, в зависимости от настроек сетевого окружения.

      • --https <on|off>
      • Параметр определяет, работает платформа со схемой HTTPS или HTTP. Для использования HTTPS необходимо указать значение параметра on или не указывать параметр --https. Для использования схемы HTTP необходимо указать значение параметра offПо умолчанию - on

      • --with-platform-stop <yes|no>
        Параметр определяет, останавливать ли компоненты платформы при снятии дампа данных. Для остановки компонент необходимо указать значение yes, иначе - no или не указывать параметр. После снятия дампа данных платформа запустится автоматически. По умолчанию - no
        При большом количестве данных, процесс резервного копирования может длиться несколько часов. Внесенные в это время изменения в конфигурацию системы могут частично попасть в итоговый дамп. Для создания точной копии системы на определенный момент времени, рекомендуется использовать параметр --with-platform-stop yes.

      • --only-viqube <yes|no>
        Параметр определяет режим снятия дампа только для компонента ViQube. Для включения этого режима необходимо указать значение yes, иначе - no или не указывать параметр. По умолчанию - no

      • --only-smart-forms <yes|no>
        Параметр определяет режим снятия дампа только для компонента Smart-Forms. Для включения этого режима необходимо указать значение yes, иначе - no или не указывать параметр. По умолчанию - no


    6. По итогам исполнения запроса в текущем каталоге будет создан архив: <pm0684 <LOCALNAME-visiology-DD.MM.YYYY.tar.gz>

    Разворачивание

    1. Задать в скрипте "restore.sh" свои параметры доступа к БДПеренести полученный архив <pm0684все параметры (имена пользователей и пароли) доступа к компонентам платформы аналогично пункту 1 в разделе "Копирование" выше. Доступы нужно прописывать от целевого стенда с платформой, а не от стенда-источника, откуда данные уже были скопированы ранее.
    2. Перенести полученный архив <LOCALNAME-visiology-DD.MM.YYYY.tar.gz> на стенд, на который переносятся измерения
    3. Разместить скрипт "restore.sh" в каталог, где находится архив <pm0684<LOCALNAME-visiology-DD.MM.YYYY.tar.gz>
    4. Дать Дать права на исполнениена исполнение:

      Блок кода
      languageactionscript3
      themeRDark
      sudo chmod +x *.sh


    5. Разверните архив:

      Блок кода
      languageactionscript3
      themeRDark
      sudo ./restore.sh <ИМЯ_АРХИВА> -p <address> --https <on|off> --with-platform-stop <yes|no> --only-smart-forms <yes|no> --only-viqube <yes|no> 

      1. Примечание
        • -p <address>
          Адрес сервера, на котором разворачивается дамп данных. Значение параметра может быть как IP-адресом, так и доменным именем сервера с установленной платформой, в зависимости от настроек сетевого окружения.

        • --https <on|off>
          Параметр определяет, работает платформа со схемой HTTPS или HTTP. Для использования HTTPS необходимо указать значение параметра on или не указывать параметр --https. Для использования схемы HTTP, необходимо указать значение параметра off. По умолчанию - on.

        • --with-platform-stop <yes|no>
          Параметр определяет, останавливать ли компоненты платформы при развертке дампа данных. Для остановки компонент необходимо указать значение yes или не указывать параметр, иначе - no.
          При большом количестве данных, процесс восстановления данных может длиться несколько часов. Внесенные в это время изменения в конфигурацию системы могут частично быть перезаписаны по результату работы процесса восстановления данных. Для создания точной копии системы из бекапа, рекомендуется использовать параметр --with-platform-stop yes. По умолчанию - no

        • --only-viqube <yes|no>
          Параметр определяет режим развертки дампа только для компонента ViQube. Для включения этого режима необходимо указать значение yes, иначе - no или не указывать параметр. По умолчанию - no

        • --only-smart-forms <yes|no>
          Параметр определяет режим развертки дампа только для компонента Smart-Forms. Для включения этого режима необходимо указать значение yes, иначе - no или не указывать параметр. По умолчанию - no

        • --with-smart-forms-triggers <yes|no>
          Параметр определяет, переносить ли настройки расписания автоматического переноса данных из Smart Forms в ViQube. Для переноса необходимо указать значение yes, иначе - no или не указывать параметр. По умолчанию - no

        • --with-viqube-admin-plans <yes|no>
          Параметр определяет, переносить ли настройки планов загрузчиков в панели администратора ViQube. Для переноса необходимо указать значение yes, иначе - no или не указывать параметр. По умолчанию - no


    6. Активируйте лицензию: 
      • Перейдите
      на портал
      • в админку (<url>/admin) и введите ключ, который был скопирован до
      Разворачивания
      • разворачивания
      • Введите ключ и
      Примените
      • примените его
      • Перезапустите систему согласно инструкции