...

Установка Wimark One

Установка Docker

1.Войти под пользователем root следующей командой:

...

sudo apt-get update

sudo apt-get install ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \ sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \ https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin \ docker-compose-plugin systemctl start docker

Информация
При необходимости установки каким-либо другим способом, либо на другую ОС, на сайте Install Docker Engine есть подробные инструкции для установки.

...

Загрузить дистрибутив Wimark One на сервер (при наличии доступа в интернет):

wget https://storage.wimark.com/api/public/dl/XZqjHaJe \
 -O /tmp/WiMark-one-1.11.0-2023-10-30-qtech-installer.run 
sudo chmod +x /tmp/WiMark-one-1.11.0-2023-10-30-qtech-installer.run

Для запуска установки необходимо выполнить bash:

sudo /tmp/WiMark-one-1.11.0-2023-10-30-qtech-installer.run

Во время установки будет предложено заполнить FQDN (рисунок 1).

Image RemovedImage Added
Рисунок 1

Следует указать FQDN. Если FQDN использоваться не будет, то можно указать любое доменное имя, например: one.mydomain.com.

Image AddedРисунок 2

Следует указать: y - для запуска установки, N - для отказа от установки.

Simple Mail Transfer Protocol (SMTP) - простой протокол передачи почты, применяемый для пересылки электронных писем с сервера отправителя на сервер получателя.Image Added

Рисунок 3 - Пример заполнения установщика SMTP

Проверка работоспособности

Для контроля работоспособности Wimark One пользователю следует перейти на web интерфейс платформы. При успешном завершении установки отобразится форма авторизации в соответствии с рисунком 14.

Image Added

Рисунок 4 - Форма авторизации

...

1. зайти на ВМ с платформой;

2. выполнить команду:

sudo docker restart one_nginx-ssl-proxy_1

Отсутствие платформы после жесткой перезагрузки

...

1. зайти на ВМ с платформой;

2. выполнить команды:

sudo su cd /etc/wimark/one bash start.sh

Обновление Wimark One

Процесс обновления Wimark One представляет собой удаление старых компонентов и установку новой версии платформы.
Если нет необходимости в переносе старых данных (статистики, SSID, настроек ТД и т.д.), то необходимо только удалить старую версию платформы, а затем установить новую версию в соответствии с инструкцией по установке Установка ПО Wimark One .

Создание резервных копий

Перед созданием резервной копии БД необходимо убедиться в том, что на сервере достаточно свободного места.
Для создания резервной копии платформы Wimark One рекомендуется иметь минимум 6G свободного места.

...

1. Создать резервную копию контейнеров:

docker save -o /opt/wimark_backup/images.tar \ $(docker compose -f /opt/wimark/one/docker-compose.yml config \ | grep image | awk '{print $2;}')

2. Создать резервную копию БД:

docker exec -it $(docker ps | grep 'one-mongo-1\|one-mongo-ha-1' | \ awk '{ print $1;}') mongodump --db=test --gzip --archive=/tmp/backup_wimark.gz

3. Создать папку для резервной копии:

mkdir /opt/wimark_backup/

4. Копировать архив с резервной копией БД из контейнера в систему:

docker cp $(docker ps | grep 'one-mongo-1\|one-mongo-ha-1' | \ awk '{ print $1;}'):/tmp/backup_wimark.gz /opt/wimark_backup/

5. Создать резервную копию static файлов, которые находятся в папке /opt/wimark/static:

cp -r /opt/wimark/static /opt/wimark_backup/static

Создание частичной резервной копии

1. Создать резервную копию БД без коллекций со статистикой:

docker exec -it $(docker ps | grep 'one-mongo-1\|one-mongo-ha-1' | \ awk '{ print $1;}')

...

 bashmongodump --db=test --excludeCollection=bss_stat_info \ --excludeCollection=client_stat_info --excludeCollection=client_stats \ --excludeCollection=cpe_stat_info --excludeCollection=stats \ --excludeCollection=wlan_stat_info --gzip --archive=/tmp/backup_wimark.gz; exit

2. Копировать архив с резервной копией БД из контейнера в систему:

docker cp $(docker ps | grep 'one-mongo-1\|one-mongo-ha-1' | \ awk '{ print $1;}'):/tmp/backup_wimark.gz /opt/wimark_backup/

3. Создать резервную копию static файлов, которые находятся в папке /opt/wimark/static:

cp -r /opt/wimark/static /opt/wimark_backup/static

Обновление ПО и перенос БД

...

1. Необходимо полностью удалить старую платформу следующей командой:

rm -r /opt/wimark; docker rm -f $(docker ps -qaf "name=one-|master|backup|one_")

Если на сервере в docker используется только Wimark One, то можно дополнительно выполнить эту команду:

docker system prune --all --volumes

2. Скачать на сервер и запустить установку (более подробное описание в разделе инструкции по установке):

wget https://storage.wimark.com/api/public/dl/XZqjHaJe \
 -O /tmp/WiMark-one-1.11.0-2023-10-30-qtech-installer.run 
sudo chmod +x /tmp/WiMark-one-1.11.0-2023-10-30-qtech-installer.run 
sudo /tmp/WiMark-one-1.11.0-2023-10-30-qtech-installer.run

Перенос БД

1.После того, как платформа полноценно запуститься (все контейнеры поднимаются за несколько минут), необходимо принудительно остановить контейнер отвечающий за backend:

docker stop $(docker ps | grep 'backend-golang-1' | awk '{ print $1;}')

2. Копировать ранее созданную резервную копию БД в контейнер mongo:

docker cp /opt/wimark_backup/backup_wimark.gz $(docker ps | \ grep 'one-mongo-1\|one-mongo-ha-1' | awk '{ print $1;}'):/tmp/

3. Запустить процесс восстановления из резервной копии:

docker exec -it $(docker ps | grep 'one-mongo-1\|one-mongo-ha-1' | \ awk '{ print $1;}') mongorestore --drop --nsInclude='test.*' \ --gzip --archive=/tmp/backup_wimark.gz

4. Удалить новые и перенести старые файлы static:

rm -r /opt/wimark/static cp -r /opt/wimark_backup/static /opt/wimark/

5. Запустить контейнер отвечающий за backend:

docker start $(docker ps | docker ps -a | grep 'backend-golang-1' | \ awk '{ print $12;}')

Далее следует подождать несколько минут и проверить работоспособность в соответствии с разделом Проверка работоспособности.

...