# 1. УСТАНОВКА И ОБНОВЛЕНИЕ WISLA

# Программные требования

1. Операционная система для развёртывания сервера: CentOS 7, Debian 11, Ubuntu 20.04 LTS, Astra Linux Special Edition 1.6 Smolensk, RedOS 7.3. Использование других операционных систем требует анализа возможности применения.
2. Архитектура: x86\_64.
3. Для корректной работы программы установки требуется разрешить зависимости (установить дополнительные пакеты согласно описанию ниже). Для этого сервер, где планируется запуск программы установки, должен иметь доступ к репозиториям или набору пакетов операционной системы на время установки системы wiSLA. Если это невозможно, следует обратиться в службу технической поддержки.
4. В ходе подготовки окружения операционной системы к установке потребуется редактировать текстовые файлы настроек. Рекомендуется установить и использовать знакомый администратору пакет для работы с текстовыми файлами, например: nano, mcedit, vim, vi.
5. Для корректного заполнения адресов и автоматического определения координат точек доступа серверы wiSLA и рабочие места пользователей должны иметь доступ к сети интернет. Если доступ к сети интернет невозможен, потребуется развернуть локальный сервер карт (обратитесь в службу поддержки за получением инструкций).
6. Для возможности рассылки уведомлений по электронной почте серверам wiSLA должен быть доступен корпоративный или внешний сервер электронной почты.
7. Для корректной работы механизмов системы требуется обеспечить синхронизацию времени по протоколу NTP на серверах wiSLA, зондах и программных агентах. Настройка NTP не описывается в настоящем документе.
8. Для работы с порталом рекомендуются браузеры: 
    - Mozilla Firefox v 134.0 и выше
    - Google Chrome v 132.0.6834.83 и выше
    - Yandex browser v 24.12.2.856 и выше

# Сетевые доступы

Используемые сетевые доступы представлены в таблице.

<div class="tableWrap" id="bkmrk-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%90%D0%B4%D1%80%D0%B5%D1%81%D0%B0-%D0%B8%D1%81%D1%82%D0%BE"><table border="1" id="bkmrk-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%90%D0%B4%D1%80%D0%B5%D1%81%D0%B0-%D0%B8%D1%81%D1%82%D0%BE-1"><colgroup><col></col><col></col><col></col><col></col><col></col></colgroup><tbody><tr><td class="align-center">**Описание**</td><td class="align-center">**Адреса источников**</td><td class="align-center">**Адрес назначения**</td><td class="align-center">**Протокол**</td><td class="align-center">**Порт назначения**</td></tr><tr><td>web portal access</td><td>clients (lan)</td><td>wisla-01</td><td>TCP</td><td>8080,8443,80,443</td></tr><tr><td>Utest</td><td>agent</td><td>agent</td><td>UDP</td><td>8787</td></tr><tr><td>TWAMP</td><td>agent</td><td>agent</td><td>UDP</td><td>10862</td></tr><tr><td>telnet</td><td>wisla-01</td><td>agent</td><td>TCP</td><td>5555</td></tr><tr><td>UDP</td><td>agent-server</td><td>agent-client</td><td>UDP</td><td>5001</td></tr><tr><td>MTU</td><td>agent-server</td><td>agent-client</td><td>UDP</td><td>5002</td></tr><tr><td>SNMP</td><td>wisla-01</td><td>snmp</td><td>UDP</td><td>161</td></tr><tr><td>agent-to-wisla</td><td>agent</td><td>wisla-01</td><td>TCP</td><td>8080,8443,80,443</td></tr></tbody></table>

</div>

# Подготовка операционной системы к запуску программы установки

Программа установки представляет собой консольное псевдографическое приложение с набором скриптов и настроек, работающее в <span lang="EN-US">Linux</span>-окружении (<span lang="EN-US">bash</span>). Дистрибутив и программа установки, как правило, поставляются как единый самораспаковывающийся <span lang="EN-US">run</span>-файл. Шаблоны отчётов и плагины могут поставляться в виде отдельных файлов.

Если система <span lang="EN-US">wiSLA</span> устанавливается на несколько серверов, один экземпляр программы установки, запущенный на одном сервере, может управлять процессом установки, настройки и резервного копирования данных на всех серверах. Для этого создаётся пользователь <span lang="EN-US">wisla</span>, которому обеспечивается посредством <span lang="EN-US">SSH</span> доступ по ключу ко всем серверам контура.

Перед запуском программы установки требуется выполнить следующие шаги:

1. На непосредственном рабочем месте администратора подготовить к работе приложение – SSH-клиент, с помощью которого будет производиться взаимодействие с консолями серверов. Для Windows рекомендуется PuTTY. Для операционных систем семейства Linux можно воспользоваться стандартным эмулятором терминала и утилитой ssh.
2. Назначить уникальные сетевые имена (hostname) серверам (например, добавить запись в /etc/hosts). Этот шаг можно пропустить, если серверы централизовано получают hostname в автоматическом режиме или действие было выполнено ранее (например, в процессе установки операционной системы).

# Подготовка системы, установка и обновление wisla (ручная)

## Установка системы

### Программно-аппаратные требования

**Платформа:** аппаратный сервер или виртуальная машина (с учетом будущей инфраструктуры рекомендуется не менее 30 Гбайт свободного пространства на диске, минимум 8 Гбайт оперативной памяти без GUI и 10 Гбайт оперативной памяти с GUI).

**Операционная система:** CentOS 7, Debian 11, Ubuntu 20.04 LTS, Astra Linux Special Edition 1.6 Smolensk, RedOS 7.3, Astra Linux Special Edition 1.7(Орел и Воронеж).

**Архитектура:** x86\_64.

**Пакеты: [deb.zip](https://wiki.wellink.ru/attachments/1369) | [astra.zip](https://wiki.wellink.ru/attachments/1367) | [centos.zip](https://wiki.wellink.ru/attachments/1370) | [redos.zip](https://wiki.wellink.ru/attachments/1368)**


### Настройка ОС

Ниже описаны шаги по подготовке окружения операционной системы к выполнению программы установки.

#### 1. Установка и запуск клиента SSH 

Для Linux-совместимых операционных систем можно воспользоваться стандартной консолью и утилитой ssh, авторизоваться можно как Administrator.

### 2. Настройка ***hostname***

Задайте имя сервера в файлах `/etc/hostname` и `/etc/hosts` как указано на примерах ниже.

Пример структуры файла `/etc/hostname`:

```bash
wisla
```

Пример структуры файла `/etc/hosts`:

```bash
127.0.0.1       localhost
192.168.159.136 wisla

# The following lines are desirable for IPv6 capable hosts
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
```

<p class="callout warning">**Обратите внимание!**  
В некоторых Linux-дистрибутивах в файле `/etc/hosts` указанный во время установки системы `hostname` может ссылаться на `127.0.1.1`, для корректной работы сервисов ***WiSLA*** эту запись нужно изменить в соответствии с примером выше. </p>

Если сетевые настройки получены по DHCP, в будущем могут возникнуть проблемы при изменении IP-адреса сервера, так как сервисы будут ссылаться на записи в файле `/etc/hosts`, который останется без изменений. Рекомендуется использовать статический IP-адрес на сетевом интерфейсе сервера.

<p class="callout success">В файле `/etc/hosts` имя хоста должно соответствовать IP-адресу, отличному от `127.0.0.1` и `127.0.1.1`.</p>

### 3. Создание пользователя “wisla”

Если на вашем сервере присутствует только учётная запись суперпользователя Administrator, тогда вам необходимо создать сервисную учётную запись для работы с системой. В данном примере будет создана учётная запись `wisla`:

```bash
sudo useradd -d /home/wisla -m wisla && sudo passwd wisla
```

В терминале сервера появится запрос на ввод пароля, задайте надёжный пароль для сервисной учётной записи.

### 4. Изменение привилегий для пользователя “wisla”

Чтобы все сервисы ***WiSLA*** работали корректно необходимо предоставить сервисной учётной записи привилегированный доступ без запроса пароля:

```bash
cat << EOF > /etc/sudoers.d/wisla
## Allow wisla to run any commands anywhere
wisla    ALL=(ALL:ALL) NOPASSWD:ALL

EOF
```

Данное действие обязательно, иначе могут возникнуть проблемы из-за того, что группа, в которой состоит пользователь, не имеет `NOPASSWD` и будут унаследованы её права.

### 5. Создайте подкаталог ***/opt/wisla5*** 

Для хранения файлов системы ***WiSLA*** необходимо создать подкаталог `/opt/wisla5`:

```bash
# Если вы работаете из под учётной записи Administrator переключитесь на ранее созданного пользователя wisla
su -l wisla
# Если вы уже переключились на сервисную учётную запись используйте sudo 
sudo mkdir -p /opt/wisla5 && sudo chown wisla:wisla /opt/wisla5
```

Скопируйте файлы дистрибутива `wisla*.run` с помощью программы ***winSCP*** или другим доступным способом в подкаталог `/home/wisla/`:

```bash
mv wisla*.run /home/wisla
sudo chown -R wisla:wisla /home/wisla/
chmod +x /home/wisla/wisla*
```

### 6. Установка зависимостей

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

<details id="bkmrk-redos-%D0%A1-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BE%D0%BC-%D0%BA-%D1%81"><summary>RedOS</summary>

##### С доступом к сети или внутреннему репозиторию:*<span style="text-decoration: underline;">  
</span>*

```bash
sudo yum install ntp lzo dialog rsync uuid zip unzip wget tar python3 fontconfig curl pv uuid python3-paramiko
```

<span style="font-family: var(--font-heading, var(--font-body)); font-size: 1.4em; font-weight: 500;">Без доступа к сети:</span>

```bash
#Копируем архив на хост удобным способом

# Разархивируем 
unzip redos.zip
cd redos

# Устанавливаем
#Все по очереди:
for i in $(ls *.rpm) 
do
  rpm -i $i || exit
done
#Вручную:
rpm -i libtomcrypt-1.18.2-1.el7.x86_64.rpm libtommath-1.2.0-3.el7.x86_64.rpm dialog-1.3-14.20171209.el7.x86_64.rpm pv-1.6.6-1.x86_64.rpm uuid-1.6.2-26.el7.x86_64.rpm
rpm -i python3-pynacl-1.5.0-1.el7.x86_64.rpm python3-bcrypt-3.2.2-1.el7.x86_64.rpm python3-paramiko-3.2.0-1.el7.noarch.rpm
```

</details>
<details id="bkmrk-centos-%D0%A1-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BE%D0%BC-%D0%BA-"><summary>CentOS</summary>

##### С доступом к сети:

```bash
sudo yum install ntp lzo dialog rsync uuid zip unzip wget tar python3 fontconfig curl
wget https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py
python3 -m pip install --upgrade pip
pip install paramiko
sudo rpm -i http://www.ivarch.com/programs/rpms/pv-1.6.6-1.x86_64.rpm
```

##### Без доступа к сети:

```bash
#Копируем архив на хост удобным способом

# Разархивируем 
unzip centos.zip
cd centos-pgks

# Устанавливаем
#Все по очереди:
for i in $(ls *.rpm) 
do
  rpm -i $i || exit
done
#Вручную:
rpm -i wget-1.14-18.el7_6.1.x86_64.rpm
rpm -i uuid-1.6.2-26.el7.x86_64.rpm
rpm -i rsync-3.1.2-10.el7.x86_64.rpm
rpm -i python-crypto-2.6.1-1.el7.centos.x86_64.rpm
rpm -i python-paramiko-2.1.1-9.el7.noarch.rpm
rpm -i pv-1.6.6-1.x86_64.rpm
rpm -i dialog-1.2-5.20130523.el7.x86_64.rpm

# Возможно потребуется установить дополнительные пакеты из этого архива
```

</details><details id="bkmrk-debian-%D0%B8-ubuntu-sudo"><summary>Debian и Ubuntu</summary>

```bash
sudo apt install -y ntp pv liblzo2-2 dialog rsync uuid zip unzip wget tar python3 python3-paramiko fontconfig curl language-pack-ru
```

</details><details id="bkmrk-astra-linux-%D0%A1-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF"><summary>Astra Linux 1.6 и 1.7</summary>

##### С доступом к сети:

```bash
sudo apt install -y ntp liblzo2-2 dialog rsync zip unzip wget tar python3 python3-paramiko fontconfig curl
```

<p class="callout warning">**Обратите внимание!**<span style="text-decoration: underline;">  
</span>В репозиториях ***Astra Linux*** нет пакетов `pv`, `paramiko` и `uuid`, поэтому их необходимо установить из исходников используя `.deb-пакеты`.   
Следуйте приведённой ниже инструкции в секции "***Без доступа к сети***".  
</p>

##### Без доступа к сети:

```bash
unzip astra.zip
cd astra-pkgs
#Все по очереди:
ls *.deb > /tmp/packages.list && sudo dpkg -i $(cat /tmp/packages.list) && rm -rf /tmp/packages.list
#Вручную:
sudo dpkg -i pv_1.6.6-1_amd64.deb
sudo dpkg -i rsync_3.1.3-6+ci202302061937+astra1_amd64.deb
sudo dpkg -i libossp-uuid16_1.6.2-1.5+b4_amd64.deb
sudo dpkg -i uuid_1.6.2-1.5+b4_amd64.deb
sudo dpkg -i wget_1.20.1-1.1_amd64.deb
sudo dpkg -i python3-paramiko_2.6.0-1~bpo10+1_all.deb
sudo dpkg -i python3-*
sudo dpkg -i dialog_1.3-20190211-1_amd64.deb
```

##### Установка и настройка pip для Python  


<span style="color: rgb(224, 62, 45);">**Обязательно для работы Paramiko на Astra Linux 1.7**</span>

Скачайте установочный скрипт get-pip.py(Версии могут отличатся от обновления Astra Linux, сравнивать с версией Python в системе ):

```
wget https://bootstrap.pypa.io/pip/3.7/get-pip.py
```

Запустите скрипт для установки pip:

```
python3 get-pip.py
```

Установите необходимые зависимости:

```
sudo apt install python3-distutils
```

Добавьте путь к локальным бинарным файлам в переменную PATH:

```
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

Обновите pip до последней версии:

```
python -m pip install --upgrade pip
```

Обновите библиотеку Paramiko:

```
pip install --upgrade paramiko
```


</details><details id="bkmrk-astra-linux-1.8-%D0%A1-%D0%B4%D0%BE"><summary>Astra Linux 1.8</summary>

##### С доступом к сети:

```bash
sudo apt install -y rsync libossp-uuid16 uuid wget python3 python3-paramiko dialog dialog fontconfig liblzo2-2 python3-asn1crypto python3-bcrypt python3-cffi-backend python3-cryptography python3-nacl rsync unzip zip
```

<p class="callout warning">**Обратите внимание!**<span style="text-decoration: underline;">  
</span>В репозиториях ***Astra Linux*** нет пакета `pv`, поэтому его необходимо установить из исходников используя `.deb-пакет`.   
Следуйте приведённой ниже инструкции в секции "***Без доступа к сети***".  
</p>

##### Без доступа к сети:

```bash
unzip astra.zip
cd astra-pkgs
#Все по очереди:
ls *.deb > /tmp/packages.list && sudo dpkg -i $(cat /tmp/packages.list) && rm -rf /tmp/packages.list
#Вручную:
sudo dpkg -i pv_1.6.6-1_amd64.deb
sudo dpkg -i rsync_3.1.3-6+ci202302061937+astra1_amd64.deb
sudo dpkg -i libossp-uuid16_1.6.2-1.5+b4_amd64.deb
sudo dpkg -i uuid_1.6.2-1.5+b4_amd64.deb
sudo dpkg -i wget_1.20.1-1.1_amd64.deb
sudo dpkg -i python3-paramiko_2.6.0-1~bpo10+1_all.deb
sudo dpkg -i python3-*
sudo dpkg -i dialog_1.3-20190211-1_amd64.deb
```

Ручная установка пакета `pv`:

```bash
sudo dpkg -i pv_1.6.6-1_amd64.deb
```

</details><details id="bkmrk-alt-linux-%28simply-li"><summary>Alt Linux (Simply Linux)</summary>

##### С доступом к сети:

```bash
sudo apt-get install -y ntp pv dialog rsync zip unzip wget tar python3 fontconfig curl python3-module-paramiko ossp-uuid
```

<p class="callout info">В ходе тестирования было замечено, что для установки ***WiSLA*** в ***altLinux*** необходимо подключаться по ***ssh***, либо используйте `sudo su $(whoami)`), иначе будет возникать окно с авторизацией. Также необходимо увеличить размер `/tmp` в `/etc/fstab`, добавьте через запятую `size=4G` (***4G*** указаны в качестве примера) и `mount -o remount`, `rw /tmp`.</p>

</details>### 7. Установить ***python3*** по умолчанию

Укажите системе использовать `python3` в качестве основной версии:

```bash
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1
```

### 8. Настройка правил ***firewall***

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

<details id="bkmrk-centos-%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0-%D0%B4%D0%BB%D1%8F%C2%A0f"><summary>CentOS</summary>

##### Правила для firewalld:

```bash
sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp
sudo firewall-cmd --reload
```

##### Наcтройка SELinux:

Настройки ***SELinux*** по умолчанию могут блокировать доступ к серверу с системой ***WiSLA***, рекомендуется настроить режим `Permissive`.

```bash
# Открываем файл
sudo nano /etc/selinux/config
# Утсанавливаем значение и сохраняем
SELINUX=permissive
# Выключаем на текущий момент чтобы не перезагружаться
setenforce 0
```

</details><details id="bkmrk-debian%2C-ubuntu-%D0%B8-ast"><summary>Debian, Ubuntu и Astra Linux</summary>

##### Правила для UFW:  


```bash
sudo ufw allow 8080/tcp
```

</details>### 9. Настройка ***limits.conf*:**

Выполните команду ниже или создайте файл вручную как указано на примере ниже:

```
cat << EOF > /etc/security/limits.d/wisla
wisla   soft      nofile  32768
wisla   hard     nofile  32768
wisla   soft      nproc   32768
wisla   hard     nproc   32768

EOF
```

### 10. Настройка ***locale***

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

<details id="bkmrk-centos-%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5-%D0%BA%D0%BE%D0%BC"><summary>CentOS</summary>

##### Выполните команды приведённые ниже:

```bash
sudo dnf install glibc-locale-source glibc-langpack-ru 
sudo localectl set-locale LANG=ru_RU.UTF-8
```

##### Затем заново авторизуйтесь на сервере. 

</details><details id="bkmrk-ubuntu-%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5-%D0%BA%D0%BE%D0%BC"><summary>Ubuntu</summary>

##### Выполните команды приведённые ниже:

```bash
sudo apt install -y locales
sudo sed -i 's|# ru_RU.UTF-8 UTF-8|ru_RU.UTF-8 UTF-8|g' /etc/locale.gen
sudo locale-gen ru_RU
sudo locale-gen ru_RU.UTF-8
sudo update-locale
localectl set-locale LANG=ru_RU.UTF-8
```

##### Затем заново авторизуйтесь на сервере. 

</details>
<details id="bkmrk-debian-%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5-%D0%BA%D0%BE%D0%BC"><summary>Debian</summary>

##### Выполните команды приведённые ниже:  


```bash
sudo locale-gen ru_RU.UTF-8
sudo dpkg-reconfigure locales
```

##### Затем заново авторизуйтесь на сервере. 

</details><p class="callout warning">**Обратите внимание!**  
Перед запуском программы установки следует выполнить команду `locale` и убедиться, что активна `ru_RU.UTF-8`. При возникновении проблем необходимо обратиться к документации по дистрибутиву для установки нужной локали. Также следует проверить вывод `timedatectl`, часовой пояс должен иметь буквенное обозначение вместо `n/a`.</p>

### 11. Подготовка системы к установке

Сгенерируйте SSH-ключ для беспарольного доступа по SSH для пользователя `wisla`:

```bash
# Переключитесь на пользователя wisla, если вы не сделали этого ранее
su -l wisla
# Сгенерируйте SSH-ключ
ssh-keygen -P ""
# В случае если установка в кластере нужно выполнить следующую команду для каждого сервера, 
# где вместо $(hostname) dns имя или ip адрес в зависимости от того как будут указаны сервера в конфигурации при установки
username=$(whoami)
ssh-copy-id $username@$(hostname)
ssh-copy-id $username@localhost
# Проверьте работу аутентификации по ключам
ssh $username@$(hostname) exit
ssh $username@localhost exit
```

<p class="callout warning">**Обратите внимание!**  
Запроса пароля быть не должно! Если пароль запрашивается, тогда требуется найти причину и добиться входа без пароля, иначе в процессе установки будут происходить многократные запросы пароля. Причиной может быть неразрешённый тип ключа или несоответствие сетевого (доменного) имени.</p>

Отключите опцию ***KillUserProcesses***:

```bash
sudo sed -i 's/#KillUserProcesses=yes/KillUserProcesses=no/g' /etc/systemd/logind.conf
```

Перезагрузите сервер, чтобы применить изменения:

```bash
sudo reboot
```

Проделав указанные выше действия ваша операционная система подготовлена к запуску программы установки.


### 12. Запуск программы установки

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

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

<p class="callout warning">**Обратите внимание!**  
Программа установки должна запускаться под сервисной учётной записью в её окружении, в данном примере это пользователь `wisla`.</p>

<p class="callout info">В ходе тестирования выявлено, что при развёртывании окна терминала на весь экран программа установки не запустится.   
**Чтобы запустить установку не разворачивайте окно на весь экран!**</p>

Если установка системы будет аварийно прервана или завершена с ошибкой, журналы установки можно найти в каталоге с программой (`install*.log`, `runtime.log`). Информация о ходе установки также доступна в буфере эмулятора терминала.

**Переключитесь на каталог, в который была скопирована программа установки:**

```bash
cd /home/wisla
```

**Запустите программы установки от имени пользователя** `wisla` **выполнив команду ниже:**

```bash
./wisla*.run
```

<p class="callout success">Если программа установки не стартует попробуйте выполнить `export TERM=xterm` перед её запуском.</p>

Если приложение не запускается, следует проанализировать сообщения об ошибках и созданные в текущем каталоге log-файлы.

<p class="callout info">Навигация в программе установки осуществляется с помощью стрелок управления курсором, клавиш `Home`, `End`, `Tab`, `Esc` и `Enter`.   
Если требуется аварийно прервать работу программы, можно использовать комбинацию клавиш `CTRL+C`, для штатного завершения программы установки следует использовать кнопку `Exit`.</p>

##### В процессе установки вам также необходимо проверить следующие конфигурации:

**Окно 'Installer startup configuration'**

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

**Окно 'Select action'**

Нажмите '***Install***'.

**Окно 'JRE\* configuration'**

Нажмите '***OK***'.

**Окно 'Postgresql\* configuration'**

Проверить параметр '***Trust host or network***'.

Нужно проверить и заполнить ***Trusted network/host***, иначе будут проблемы с подключением ***Postgres*** и патчами.

**Окно 'Wildfly\* configuration'**

Проверить значение ***memory size***.

**Окно 'Hadoop\* configuration'**

Проверить имя ***hostname*** в '***HDFS master***' и '***Tracker host' fields***'.

**Окно 'HBase\* configuration'**

Проверить имя ***hostname*** в '***Zookeeper quorum***'.

**Окно 'wiSLA\* data collection configuration'**

Если планируется использование зондов ***wiProbe***, нужно прокрутить список и изменить настройку «***wiProbe destination***». В ней задаётся адрес, который будет использоваться зондом для отправки данных в систему ***wiSLA***, в форме ***URL***. Остальные параметры менять без необходимости не рекомендуется.

**Окно 'wiSLA\* LDAP configuration'**

Если не планируется интегрировать систему с ***MS Active Directory*** или ***OpenLDAP Server***, рекомендуется оставить значения по умолчанию.

**Окно 'wiSLA\* resources configuration'**

Убедиться, что имя hostname указано в ***URL***.

**Окно 'wiSLA\* notification and ASI configuration'**

Требуется указать параметры подключения к почтовому серверу. Если этого не сделать, новые пользователи не смогут получать письма о добавлении учётной записи и другие уведомления, отсылаемые на email. Также здесь можно включить отправку SNMP-уведомлений по определённым событиям.   
Настройка email-уведомлений:  
1.Необходимо выбрать почту с которой буду отправляться уведомления и выполнить настройку по [инструкции](https://yandex.ru/support/mail/mail-clients/others.html).  
2.Устанавливаем конфиги:

- Notification enabled: true
- Profile-status notification enabled: false
- Service notification enabled: false
- Wisla notification op\_link: wisla
- Wisla notification cp\_link: wisla
- Wisla inter-hop master:
- Wisla inter-hop slaves:
- Wisla inter-hop slave: false
- Mail host: smtp.{домен почты}.ru
- Mail from: email (например: [test\_push@yandex.ru](mailto:test_push@yandex.ru))
- Mail from alias: email без домена (например: [test\_push](mailto:test_push@yandex.ru) )
- Mail port: 587
- Mail protocol: smtp
- Mail smtp auth: true
- Mail smtp starttls: true
- Mail user: email с которого планируется отправка уведомлений (например: [test\_push@yandex.ru](mailto:test_push@yandex.ru))
- Mail password: "пароль приложения" сформированный на шаге 1
- ASI notification enabled: false
- ASI hendlers: genericSnmp
- ASI SNMP distation:
- Events limit for notification: 10
- No data duration: 10
- Reports use en filenames: false

**Окно 'wiSLA\* operator portal configuration'**

Обращаем ваше внимание, если вы получаете доступ к порталу с помощью проброса портов или через прокси сервер, то вам необходимо отредактировать пункт ***HOST*** и в ***Whitelisted domains*** установить необходимые IP-адреса.

3. Подтверждение настроек

На этом этапе можно вернуться назад и внести исправления в настройки. После подтверждения начинается процесс установки.

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

Во время установки в каталог `/opt/wisla5` будут добавлены следующие компоненты:

- ***Zookeeper***;
- ***Hadoop***;
- ***HBase***;
- ***PostgreSQL***;
- ***Java Runtime Environment***;
- ***WildFly Application Server***;
- ***wiSLA Portal***.

Процесс можно прервать, нажав `CTRL+C`, все настройки будут сброшены.

После завершения установки будет предложено добавить систему в список автозагрузки – нажмите кнопку `Нет`.

<p class="callout warning">**Обратите внимание!**  
В ходе тестирования выявлено, что на ***Astra Linux*** в некоторых сценариях не создается `systemd unit`, при возникновении данной проблемы нужно создать его руками.</p>

Выполните команду ниже или создайте файл вручную с содержанием как на примере ниже:

```bash
cat << EOF > /etc/systemd/system/wisla.service
[Unit]
Description=Starts JBoss process with wiSLA 5 system
After=network-online.target
Requires=network-online.target

[Service]
Type=forking
RemainAfterExit=true
WorkingDirectory=/opt/wisla5
ExecStart=/opt/wisla5/scripts/wisla5.sh start
ExecStop=/opt/wisla5/scripts/wisla5.sh stop

[Install]
WantedBy=multi-user.target

EOF

sudo systemctl daemon-reload
sudo systemctl enable wisla.service
```

### 13. Запуск WiSLA

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

```bash
less -f /opt/wisla5/wildfly/current/standalone/log/server.log
less -f /opt/wisla5/wildfly/current/standalone/log/communicator.log
```

Маркером успешного запуска является следующее сообщение в журнале (server.log):

```bash
INFO  [com.wellink.wisla.communicator.impl.state.AvailabilitySystemStateSingletonImpl] (http-0.0.0.0-0.0.0.0-8080-1) !***   THE ALL wiSLA
COMPONENTS ARE FULLY DEPLOYED, INTERCONNECTED AND READY TO WORK!   ***!
13:48:30,028 INFO  [com.wellink.wisla.communicator.impl.state.AvailabilitySystemStateSingletonImpl] (http-0.0.0.0-0.0.0.0-8080-1) !********************
**********************************************************************!
```

Теперь можно запустить веб-браузер и открыть страницу системы указав IP-адрес сервера и порт.

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-09/scaled-1680-/bXCimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-09/bXCimage.png)

<span style="color: #000000;">   
</span>В данном примере система будет доступна по адресу `http://192.168.159.136:8080`.



## Обновление wiSLA


Рекомендуется обновляться с предыдущей минорной версии ***wiSLA*** (*5.1*-&gt;*5.2*-&gt;*5.2.1*-&gt;*5.2.2*-&gt;*5.2.3*).

1\) Запустить программу установки wiSLA 5.2.3;

2\) В основном меню выбрать пункт Update;

2.1) Подтвердить или отклонить создание резервной копии (рекомендуется сделать);

2.2) Подтвердить остановку компонентов wiSLA;

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

2.4) После обновления и запуска всех компонентов системы подтвердить или отклонить добавление wiSLA в автозагрузку;

3\) После успешного запуска сервера приложений, выполнить индексацию (`Maintenance > wiSLA > Reindex` (*Не путать со <span style="text-decoration: underline;">Standalone Reindex</span>!);*

4\) Открыть портал, проверить работу системы;

5\) Очистить кэш браузера на всех рабочих местах.

**Возможные ошибки в процессе обновления:**

Иногда при обновлении до новой версии может зависнуть сервис `wildfly`, на это будут указывать следующие записи в журнале `server.log`:

```javascript
13:24:21,676 ERROR [org.jboss.as.controller.management-operation] (DeploymentScanner-threads - 2) 
 WFLYCTL0013: Operation ("deploy") failed - address: ([("deployment" => "wisla-engine-5.2.4-SNAPSHOT.war")]) - failure description: {"WFLYCTL0080: Failed services" => {"jboss.deployment.unit.\"wisla-engine-5.2.4-SNAPSHOT.war\".undertow-deployment" => "java.lang.RuntimeException: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'expireSessionSchedulerSingleton': Unsatisfied dependency expressed through field 'eventLoggerService'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'eventLoggerService' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'hibernateAuditLogAppender' while setting bean property 'appenders' with key [0]; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hibernateAuditLogAppender' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'sessionFactory' while setting bean property 'sessionFactory'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in class path resource [engine/conf/spring/datasource.xml]: Invocation of init method failed; nested exception is org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' 
    Caused by: java.lang.RuntimeException: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'expireSessionSchedulerSingleton': Unsatisfied dependency expressed through field 'eventLoggerService'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'eventLoggerService' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'hibernateAuditLogAppender' while setting bean property 'appenders' with key [0]; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hibernateAuditLogAppender' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'sessionFactory' while setting bean property 'sessionFactory'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in class path resource [engine/conf/spring/datasource.xml]: Invocation of init method failed; nested exception is org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' 
    Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'expireSessionSchedulerSingleton': Unsatisfied dependency expressed through field 'eventLoggerService'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'eventLoggerService' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'hibernateAuditLogAppender' while setting bean property 'appenders' with key [0]; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hibernateAuditLogAppender' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'sessionFactory' while setting bean property 'sessionFactory'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in class path resource [engine/conf/spring/datasource.xml]: Invocation of init method failed; nested exception is org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' 
    Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'eventLoggerService' defined in class path resource[audit/conf/spring/services.xml]: Cannot resolve reference to bean 'hibernateAuditLogAppender' while setting bean property 'appenders' with key [0]; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hibernateAuditLogAppender' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'sessionFactory' while setting bean property 'sessionFactory'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in class path resource [engine/conf/spring/datasource.xml]: Invocation of init method failed; nested exception is org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hibernateAuditLogAppender' defined in class path resource [audit/conf/spring/services.xml]: Cannot resolve reference to bean 'sessionFactory' while setting bean property 'sessionFactory'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in class path resource [engine/conf/spring/datasource.xml]: Invocation of init method failed; nested exception is org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' 
    Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in class path resource [engine/conf/spring/datasource.xml]: Invocation of init method failed; nested exception is org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' 
    Caused by: org.hibernate.search.exception.SearchException: HSEARCH000103: Unable to initialize IndexManager named 'sap' 
    Caused by: org.hibernate.search.exception.SearchException: Unable to open Lucene IndexReader for IndexManager sap 
    Caused by: org.apache.lucene.index.CorruptIndexException: file mismatch, expected id=42hlomvwa71vvwwn7vem94t0p, got=7mz5ojw75crmjs1kxhmc322p2 (resource=BufferedChecksumIndexInput(MMapIndexInput(path=\"/opt/wisla5/wildfly/wildfly-14.0.1.Final/bin/searchindexes/engine/sap/_q.si\")))"}}
```

Чтобы решить эту проблему удалите содержимое каталога `/opt/wisla5/wildfly/wildfly-14.0.1.Final/bin/searchindexes/engine/sap/`:

```bash
sudo rm -rf /opt/wisla5/wildfly/wildfly-14.0.1.Final/bin/searchindexes/engine/sap/*
```

Затем повторно запустите процесс обновления с помощью инсталлятора `wisla`, после обновления системы не забудьте запустить индексацию.

**Если перед началом обновления требуется удалить данные из базы данных:**

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

В данной ситуации нужно проделать следующие действия:

1. Сделать резервную копию БД для возможности восстановления данных на другой машине со старой версией приложения;
2. Остановите приложения wiSLA;
3. Подключиться к БД используя клиент, например DBviewer;
4. Переключиться на БД wisla и выполнить скрипт wisla\_init\_schema.sql;
5. Затем выполнить скрипт wisla\_init\_schema.sql;
6. После выполнения скриптов отключитесь от БД и вернитесь к терминалу сервера с инсталлером;
7. Загрузите на сервер пустую БД wiSLA clear1.backup;
8. Перейдите в раздел backup и загрузите пустую БД в базу в режиме восстановления;
9. Загрузив БД перейдите к настройке PostgreSQL (Maintenance &gt; PostrgeSQL) и запустите патч для создания необходимых таблиц;
10. После того как таблицы будут сформированы запустите приложения wiSLA и проверьте работу веб-портала.

# Установка wiSLA 5

## Оглавление

1. [Системные требования](https://wiki.wellink.ru/link/1849#bkmrk-%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE-%D0%B0%D0%BF%D0%BF%D0%B0%D1%80%D0%B0%D1%82%D0%BD%D1%8B);
2. [Подготовка операционной системы](https://wiki.wellink.ru/link/1849#bkmrk-%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%9E%D0%A1-1);
3. [Установка системы мониторинга wiSLA 5](https://wiki.wellink.ru/link/1849#bkmrk-5.-%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B);
4. [Запуск wiSLA](https://wiki.wellink.ru/link/1849#bkmrk-%D0%97%D0%B0%D0%BF%D1%83%D1%81%D0%BA-wisla).

### Системные требования

**Платформа:**

- Физический сервер или виртуальная машина с поддержкой микроархитектуры ***x86-64***;
- Объём накопителя не менее ***40 ГБайт***;
- Не менее ***10 ГБ*** оперативной памяти;
- Совместимая операционная система.

**Список поддерживаемых операционных систем:**

- ***Debian 12;***
- ***Debian 11;***
- ***Debian 10;***
- ***Ubuntu 24.04 LTS;***
- ***Ubuntu 22.04 LTS;***
- ***Ubuntu 20.04 LTS;***
- ***Astra Linux 1.8.1;***
- ***Astra Linux 1.7.7 (начиная с [v1.9.6](https://gitlab.wellink.ru/wisla/wisla-pre-installation-program/-/tree/1.9.6))***
- ***Astra Linux 1.7.6;***
- ***Astra Linux 1.7.5;***
- ***Red OS 8.0.***

Файлы программы можно загрузить из [GitLab](https://gitlab.wellink.ru/wisla/wisla-pre-installation-program/-/tree/master?ref_type=heads).

Запись встречи с демонстрацией работы программы можно посмотреть на [корпоративном облаке](https://cloud.wellink.ru/s/jYm5mqL5qdfs783).


#### Подготовка операционной системы 

##### 1. Загрузка файлов на сервер

Подключитесь к серверу через протокол SSH используя учётную запись пользователя с привилегированным доступом. Затем с помощью **SFTP** или **scp** скопируйте [файлы программы](https://gitlab.wellink.ru/wisla/wisla-pre-installation-program/-/tree/master?ref_type=heads) и инсталлятор wiSLA 5 на сервер, например в домашний каталог текущего пользователя.

<details id="bkmrk-%D0%95%D1%81%D0%BB%D0%B8-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D1%83%D0%B5%D1%82%D0%B5-%D0%B2%D0%B5%D1%80"><summary>Если используете версию 1.9.4 и ниже</summary>

1\. Откройте файл `/etc/hosts` на редактирование в привилегированном режиме используя удобный для вас текстовый редактор (`nano`, `vi` или `vim`):

```bash
sudo vim /etc/hosts
```

2\. Проверьте структуру файла `/etc/hosts`, имя текущего узла должно сопоставляться с его основным IP-адресом как показано на примере ниже:

```bash
127.0.0.1       localhost
192.168.159.136 wisla

# The following lines are desirable for IPv6 capable hosts
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
```

<p class="callout warning">**Обратите внимание!**   
В некоторых Linux-дистрибутивах в файле `/etc/hosts` указанный во время установки системы `hostname` может ссылаться на `127.0.1.1`, для корректной работы сервисов ***wiSLA*** эту запись нужно изменить в соответствии с примером выше. </p>

<p class="callout success">Если сетевые настройки получены по DHCP, в будущем могут возникнуть проблемы при изменении IP-адреса сервера, так как сервисы будут ссылаться на записи в файле `/etc/hosts`, который останется без изменений. Рекомендуется использовать статический IP-адрес на сетевом интерфейсе сервера.</p>

3\. Скорректировав записи в файле `/etc/hosts` проверьте, чтобы имя узла корректно сопоставлялось с основным IP-адресом сервера выполнив такую команду:

```bash
hostname -i
```

В результате выполнения команды в терминале должен отобразится основной сетевой адрес вашего сервера:

```bash
kreshetnikov@wisla:~$ hostname -i
192.168.159.136
```

Убедившись в корректном разрешении сетевого адреса по отношению к имени узла можно приступать к добавлению прав и запуску программы.

</details>Загрузив необходимые файлы на сервер добавьте права на выполнение для программы предварительной настройки:

```bash
sudo chmod +x ./preparing-os.start
```

После обновления прав доступа запустите программу.

##### 2. Предварительная настройка узла

Запустите программу предварительной настройки:

```bash
./preparing-os.start
```

При запуске программы будет выведена информация о её версии, системе и релизе, затем запустится механизм проверки необходимых файлов и будет создан журнал для записи событий:

```bash
wisla-admin@wisla:~$ ./preparing-os.start

WWWWWWWW                           WWWWWWWW                 lllllll  lllllll    iiii                    kkkkkkkk
W::::::W                           W::::::W                 l:::::l  l:::::l   i::::i                   k::::::k
W::::::W                           W::::::W                 l:::::l  l:::::l    iiii                    k::::::k
W::::::W                           W::::::W                 l:::::l  l:::::l                            k::::::k
 W:::::W           WWWWW           W:::::W  eeeeeeeeeeee     l::::l   l::::l  iiiiiii nnnn  nnnnnnnn     k:::::k    kkkkkkk
  W:::::W         W:::::W         W:::::W ee::::::::::::ee   l::::l   l::::l  i:::::i n:::nn::::::::nn   k:::::k   k:::::k
   W:::::W       W:::::::W       W:::::W e::::::eeeee:::::ee l::::l   l::::l   i::::i n::::::::::::::nn  k:::::k  k:::::k
    W:::::W     W:::::::::W     W:::::W e::::::e     e:::::e l::::l   l::::l   i::::i nn:::::::::::::::n k:::::k k:::::k
     W:::::W   W:::::W:::::W   W:::::W  e:::::::eeeee::::::e l::::l   l::::l   i::::i   n:::::nnnn:::::n k::::::k:::::k
      W:::::W W:::::W W:::::W W:::::W   e:::::::::::::::::e  l::::l   l::::l   i::::i   n::::n    n::::n k:::::::::::k
       W:::::W:::::W   W:::::W:::::W    e::::::eeeeeeeeeee   l::::l   l::::l   i::::i   n::::n    n::::n k:::::::::::k
        W:::::::::W     W:::::::::W     e:::::::e            l::::l   l::::l   i::::i   n::::n    n::::n k::::::k:::::k
         W:::::::W       W:::::::W      e::::::::e          l::::::l l::::::l i::::::i  n::::n    n::::n k::::::k k:::::k
          W:::::W         W:::::W        e::::::::eeeeeeee  l::::::l l::::::l i::::::i  n::::n    n::::n k::::::k  k:::::k
           W:::W           W:::W          ee:::::::::::::e  l::::::l l::::::l i::::::i  n::::n    n::::n k::::::k   k:::::k
            WWW             WWW             eeeeeeeeeeeeee  llllllll llllllll iiiiiiii  nnnnnn    nnnnnn kkkkkkkk    kkkkkkk


Привет, wisla-admin!

Данная программа выполнит подготовку сервера для развёртывания системы мониторинга wiSLA.
Автор программы: системный инженер К. Решетников.
Версия программы: 1.9.6.

Информация о системе:
Версия ОС: Astra Linux 1.7.7.
Версия Debian: 10.0.

Информация о релизе:

Distributor ID: AstraLinux
Description:    Astra Linux 1.7 x86-64
Release:        1.7_x86-64
Codename:       1.7_x86-64

Выполняется проверка файлов...

Архив с временными файлами программы существует.
                                                                                                          OK
Файл журнала уже существует.
                                                                                                          OK
```

Когда программа удостоверится в наличии всех необходимых файлов запустится процесс создания сервисной учётной записи `wisla`.

```bash
Проверка учётной записи wisla...
Создаётся сервисная учётная запись wisla...
Задайте пароль для учётной записи пользователя wisla
Новый пароль :
Повторите ввод нового пароля :
passwd: пароль успешно обновлён
                                                                                                          OK
```

Если учётной записи `wisla` не существует в системе, тогда она будет создана и вы увидите запрос на создание пароля.

<p class="callout info">**Информация**  
  
При создании пароля используйте сложные комбинации с латинскими буквами разного регистра, цифрами и спецсимволами для обеспечения информационной безопасности. </p>

После создания сервисной учётной записи программа обновит файлы конфигурации системы, создаст необходимые каталоги, и извлечёт временные файлы. Затем будет произведено обновление прав доступа на ранее созданные каталоги и запустится основной сценарий настройки под учётной записью пользователя `wisla`.

```bash
Обновление конфигурации системы...
                                                                                                          OK
Выполняется проверка каталога /home/wisla/.ssh...
Каталог /home/wisla/.ssh уже существует.
                                                                                                          OK
Выполняется проверка каталога /opt/wisla5...
Каталог /opt/wisla5 уже существует.
                                                                                                          OK
Извлечение временных файлов программы...
                                                                                                          OK
Найден файл установки ./wisla-5.2.11-2505210711.run.
Перемещение ./wisla-5.2.11-2505210711.run в каталог /home/wisla...
                                                                                                          OK        
Выполняется изменение прав доступа для каталога "/opt/wisla5"...
Права доступа обновлены успешно!
                                                                                                          OK
Выполняется изменение прав доступа для каталога "/home/wisla"...
Права доступа обновлены успешно!
                                                                                                          OK
Запуск сессии под пользователем wisla...
                                                                                                          OK
```

На этом этапе программа проверит наличие стандартной записи `127.0.1.1` в `/etc/hosts`,

```bash
Выполняется проверка сетевого адреса для wisla...
                                                                                                          OK
```

Если он отсутствует программа предложит проверить имя узла, при наличии данной записи она будет автоматически заменена на основной IP-адрес сервера.

Когда на сервере несколько активных сетевых интерфейсов будет предложено выбрать нужный:

```
Выполняется проверка сетевого адреса для wisla...
Выберите сетевой интерфейс из списка:
1) eth0 | 10.0.0.45/26
2) eth1 | 10.0.0.46/26
#? 1
                                                                                                          WARNING
IP-адрес для wisla изменён на 10.0.0.45.
```

На шаге с настройкой имени узла будет выведено текущее имя сервера и основной IP-адрес, который будет использоваться системой мониторинга wiSLA 5:

```bash
Пожалуйста проверьте имя узла перед тем как продолжить!

Если имя узла задано верно, тогда укажите значение "н" и нажмите на клавишу Enter чтобы продолжить настройку.
В ином случае укажите значение "д" и задайте верное имя узла (hostname).

При смене имени узла будьте предельно внимательны!
Если вы допустили ошибку нажмите сочетание клавиш CTRL + C чтобы прервать работу программы, затем запустите
её заново и повторите процесс настройки!

Текущее имя узла:

wisla | 192.168.159.136

Вы хотите изменить имя узла? (д/н):
н
```

Если имя узла указано верно передайте значение `н` и нажмите на клавишу `Enter` чтобы продолжить:

```bash
Вы хотите изменить имя узла? (д/н):
н

Сохранено текущее имя узла wisla.
```

В ином случае передайте значение `д`, затем нажмите клавишу `Enter` и укажите нужное имя узла как показано на примере ниже.

```bash
При смене имени узла будьте предельно внимательны!
Если вы допустили ошибку нажмите сочетание клавиш CTRL + C чтобы прервать работу программы, затем запустите её 
заново и повторите процесс настройки!

Текущее имя узла:

astra | 192.168.159.136

Вы хотите изменить имя узла? (д/н):
д
Задайте новое имя узла: wisla
Выполняется настройка...
                                                                                                                 OK
Новое имя узла wisla сохранено.
                                                                                                                 OK
```

На следующем шаге вам необходимо выбрать вариант установки пакетов.

**Возможные варианты:**

1. С доступом к сети интернет;
2. Без доступа к сети интернет (установка из бинарных файлов).

Вывод в терминале будет следующего вида:

```bash
Перед тем как продолжить пожалуйста ознакомтесь с официальной документацией!

Выберете подходящий вариант установки пакетов:

    1) С доступом к сети интернет;
    2) Без доступа к сети интернет.

Чтобы выйти из программы нажмите сочетание клавиш CTRL + C.

Укажите нужное значение (1/2) и нажмите на клавишу Enter:
1
```

<p class="callout warning">**Обратите внимание!**  
  
При выборе варианта настройки с подключением к сети интернет будет выполнена установка обновлений для всех пакетов системы.   
</p>

Укажите нужное значение и нажмите клавишу `Enter`, в данном примере был выбран вариант с доступом к сети интернет.

```bash
Выбран вариант установки с подключением к сети интернет.
Обновление кэша репозиториев...
Системе отправлена команда:
sudo apt-get update
Игн:1 http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-main 1.7_x86-64 InRelease
Сущ:2 http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-update 1.7_x86-64 InRelease
Сущ:3 http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base 1.7_x86-64 InRelease
Сущ:4 http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended 1.7_x86-64 InRelease
Сущ:5 http://download.astralinux.ru/astra/stable/1.7_x86-64/uu/last/repository-update 1.7_x86-64 InRelease
Сущ:6 http://download.astralinux.ru/astra/stable/1.7_x86-64/repository-main 1.7_x86-64 Release
Чтение списков пакетов…
Кэш репозиториев обновлён успешно.
                                                                                                                 OK
```

Обновив кэш репозиториев программа проверит наличие неудовлетворённых зависимостей и постарается их исправить.

```bash
Проверка на наличие неудовлетворённых зависимости...
Системе отправлена команда:
sudo apt-get --fix-broken install -y
Чтение списков пакетов…
Построение дерева зависимостей…
Чтение информации о состоянии…
Обновлено 0 пакетов, установлено 0 новых пакетов, для удаления отмечено 0 пакетов, и 0 пакетов не обновлено.
Зависимости успешно исправлены.
                                                                                                                 OK
```

Далее будет запущен механизм установки обновлений и необходимых пакетов для работы ***wiSLA***.

<p class="callout info">**Информация** Рекомендуется использовать вариант с доступом к сети интернет для установки актуальных версий пакетов со всеми зависимостями.  
</p>

**Обратите внимание на этап, связанный с установкой обновлений системы!** Вывод программы в терминале:

```bash
Выполняется установка обновлений...
Системе отправлена команда: sudo apt-get dist-upgrade -y
Чтение списков пакетов…
Построение дерева зависимостей…
Чтение информации о состоянии…
Расчёт обновлений…
```

Данная программа разработана с возможностью включения режима отладки и расширенного логирования, что существенно повышает её эффективность. Реализация этого функционала осуществляется с помощью утилиты `stdbuf`, управляющей буферизацией вывода. Процесс установки обновлений происходит в фоновом режиме, а вывод команды в терминал осуществляется построчно. Это позволяет пользователю продолжать работу без задержек, но накладывает определённые ограничения на отображение информации в терминале.

В частности, в терминале не будет отображаться строка прогресс-бара и символы введённые с клавиатуры, когда высокоуровневый пакетный менеджер ***APT*** будет запрашивать варианты изменения файлов конфигурации.  
Ниже представлен пример для файла `/etc/pam.d/login`:

```bash
Файл настройки «/etc/pam.d/login»
 ==> Изменён с момента установки (вами или сценарием).
 ==> Автор пакета предоставил обновлённую версию.
  Что нужно сделать? Есть следующие варианты:
   Y или I : установить версию, предлагаемую сопровождающим пакета
   N или O : оставить установленную на данный момент версию
      D    : показать различия между версиями
      Z    : запустить оболочку командной строки для проверки ситуации
 По умолчанию сохраняется текущая версия файла настройки.
```

Как правило, параметры остаются неизменными, поэтому просто нажмите клавишу `Enter`, чтобы пропустить этот шаг. Если вам необходимо ввести другое значение, убедитесь, что у вас включена английская раскладка клавиатуры и выключен `CapsLock`. Затем укажите нужный вариант и нажмите клавишу `Enter`, чтобы продолжить.

Указанное вами значение отобразится в терминале после того как программа продолжит установку обновлений:

```bash
Файл настройки «/etc/astra-syslog.conf»
 ==> Изменён с момента установки (вами или сценарием).
 ==> Автор пакета предоставил обновлённую версию.
  Что нужно сделать? Есть следующие варианты:
   Y или I : установить версию, предлагаемую сопровождающим пакета
   N или O : оставить установленную на данный момент версию
      D    : показать различия между версиями
      Z    : запустить оболочку командной строки для проверки ситуации
 По умолчанию сохраняется текущая версия файла настройки.
*** astra-syslog.conf (Y/I/N/O/D/Z) [по умолчанию N] ? N
```

<p class="callout warning">**Обратите внимание!**  
  
Если система ранее не обновлялась данный этап может длится от нескольких минут до получаса в зависимости от скорости канала, через который сервер подключается к официальным репозиториям. </p>

Установив обновления программа запустит процесс удаления неиспользуемых пакетов:

```bash
Удаление неиспользуемых пакетов...
Системе отправлена команда:
sudo apt-get autoremove -y
Чтение списков пакетов…
Построение дерева зависимостей…
Чтение информации о состоянии…
Следующие пакеты будут УДАЛЕНЫ:
  libgdk-pixbuf-xlib-2.0-0 libgdk-pixbuf2.0-0 libllvm11 libmariadb3 libsnmp30
  libxcb-util0 mariadb-common mysql-common
Обновлено 0 пакетов, установлено 0 новых пакетов, для удаления отмечено 8 пакетов, и 0 пакетов не обновлено.
После данной операции объём занятого дискового пространства уменьшится на 90,4 MB.
(Чтение базы данных … на данный момент установлено 129684 файла и каталога.)
Удаляется libgdk-pixbuf2.0-0:amd64 (2.40.2-2+b1) …
Удаляется libgdk-pixbuf-xlib-2.0-0:amd64 (2.40.2-2+b1) …
Удаляется libllvm11:amd64 (1:11.0.1-2+b1) …
Удаляется libsnmp30:amd64 (5.7.3+dfsg-5+deb10u4) …
Удаляется libmariadb3:amd64 (1:10.3.39-0+deb10u2) …
Удаляется libxcb-util0:amd64 (0.3.8-3) …
Удаляется mariadb-common (1:10.3.39-0+deb10u2) …
update-alternatives: используется /etc/mysql/my.cnf.fallback для предоставления /etc/mysql/my.cnf (my.cnf) в
автоматическом режиме
Удаляется mysql-common (5.8+1.0.5) …
Обрабатываются триггеры для libc-bin (2.28-10+deb10u3+ci202406111043+astra10) …
Неиспользуемые пакеты успешно удалены.
                                                                                                                 OK
```

Затем будут установлены утилиты необходимые для работы системы ***wiSLA 5***:

```bash
Выполняется установка необходимых пакетов...
Выполняется установка пакета: ntp
Системе отправлена команда:
sudo apt-get install -y ntp
Чтение списков пакетов…
Построение дерева зависимостей…
Чтение информации о состоянии…
Уже установлен пакет ntp самой новой версии (1:4.2.8p15+dfsg-1+ci202401221606+astra2).
Обновлено 0 пакетов, установлено 0 новых пакетов, для удаления отмечено 0 пакетов, и 0 пакетов не обновлено.
Пакет ntp установлен успешно.
                                                                                                                 OK
...

Выполняется установка пакета: iperf
Системе отправлена команда:
sudo apt-get install -y iperf
Чтение списков пакетов…
Построение дерева зависимостей…
Чтение информации о состоянии…
Уже установлен пакет iperf самой новой версии (2.0.12+dfsg1-2+b1).
Обновлено 0 пакетов, установлено 0 новых пакетов, для удаления отмечено 0 пакетов, и 0 пакетов не обновлено.
Пакет iperf установлен успешно.
                                                                                                                 OK
```

<details id="bkmrk-%D0%95%D1%81%D0%BB%D0%B8-%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B0-%D0%B7%D0%B0%D0%BF%D1%83%D1%89"><summary>Если программа запущена на Astra Linux</summary>

При запуске программы на ***Astra Linux*** дополнительно будет произведена установка пакетов `pv` и `lnav` из бинарных файлов, потому как они отсутствуют в официальных репозиториях дистрибутива.

Вывод в терминале будет следующего вида:

```bash
Выполняется изменение прав доступа для каталога "/home/wisla"...
Права доступа обновлены успешно!
                                                                                                                 OK
Извлечение временных файлов из архива...
                                                                                                                 OK
Выполняется установка необходимых пакетов из "./wisla-pkgs/astra-1-7/onlinst"...

Системе отправлена команда:
sudo dpkg -i --force-all ./wisla-pkgs/astra-1-7/onlinst/lnav_0.8.4-5_amd64.deb
(Чтение базы данных … на данный момент установлено 122453 файла и каталога.)
Подготовка к распаковке …/onlinst/lnav_0.8.4-5_amd64.deb …
Распаковывается lnav (0.8.4-5) на замену (0.8.4-5) …
Настраивается пакет lnav (0.8.4-5) …
Обрабатываются триггеры для man-db (2.8.5-2+b1) …

Системе отправлена команда:
sudo dpkg -i --force-all ./wisla-pkgs/astra-1-7/onlinst/pv_1.6.6-1_amd64.deb
(Чтение базы данных … на данный момент установлено 122453 файла и каталога.)
Подготовка к распаковке …/onlinst/pv_1.6.6-1_amd64.deb …
Распаковывается pv (1.6.6-1) на замену (1.6.6-1) …
Настраивается пакет pv (1.6.6-1) …
Обрабатываются триггеры для man-db (2.8.5-2+b1) …
                                                                                                                 WARNING
Выполняется попытка исправления зависимостей...
Чтение списков пакетов…
Построение дерева зависимостей…
Чтение информации о состоянии…
Обновлено 0 пакетов, установлено 0 новых пакетов, для удаления отмечено 0 пакетов, и 0 пакетов не обновлено.
Необходимые пакеты были успешно установлены.
                                                                                                                 OK
Программа выполняет удаление временных файлов, пожалуйста подождите...
Временные файлы были удалены.
                                                                                                                 OK
```

</details>На следующем этапе программа проверит статус сетевого фильтра `ufw` или `firewalld` и добавит правила необходимые для корректной работы системы мониторинга:

```bash
Выполняется добавление правил для фильтрации пакетов...
Сетевой фильтр UFW установлен.
                                                                                                                 OK
Сетевой фильтр UFW неактивен!
                                                                                                                 WARNING
Правила фильтрации успешно добавлены.
                                                                                                                 OK
```

<p class="callout warning">**Обратите внимание!**  
  
Программа добавит правила, даже если сетевой фильтр отключен. Данный подход должен обеспечить бесперебойную работы системы ***wiSLA 5*** при включении сетевого фильтра в будущем.  
</p>

При настройке одиночного сервера добавляются следующие правила:

1. `22/TCP` — OpenSSH-сервер;
2. `8080/TCP` — HTTP-порт сервера Wildfly;
3. `8443/TCP` — HTTPS-порт сервера Wildfly;
4. `8787/UDP` и `10862/UDP` — для работы программного агента Slamon.

После добавления правил фильтрации пакетов программа проверит состояние службы `openssh-server`, если служба отключена будет предпринята попытка её запуска, а также будет обновлён systemd-юнит для работы автозагрузки.

```bash
Проверка состояния службы openssh-server...
Служба openssh-server уже запущена.
                                                                                                                 OK
Добавление службы openssh-server в автозагрузку...
Служба openssh-server добавлена в автозагрузку.
                                                                                                                 OK
```

Обновив конфигурацию автозагрузки службы `ssh` программа сгенерирует SSH-ключ для пользователя `wisla` и запросит пароль.

```bash
Выполняется генерация SSH-ключа...
Generating public/private rsa key pair.
Your identification has been saved in /home/wisla/.ssh/id_rsa
Your public key has been saved in /home/wisla/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:CkwRXSK/K1EkRDKUakPcynkZM3ATT02Mk9/xgZpjfFU wisla@wisla
The key's randomart image is:
+---[RSA 3072]----+
|.o*BO+Oo. . .E   |
| ooB+X.+ o o     |
|o.o *.* + + .    |
|.* = . O o .     |
|. o + o S        |
|     o o         |
|    . o          |
|     .           |
|                 |
+----[SHA256]-----+

Сгенерирован SSH-ключ для пользователя wisla, узел wisla.
                                                                                                                 OK
Введите пароль для пользователя wisla чтобы продолжить.
Введите пароль:
```

Укажите пароль от учётной записи `wisla`, заданный ранее на этапе создания данного пользователя и нажмите на клавишу `Enter`, чтобы записать его на сервер.

<p class="callout warning">**Обратите внимание!**  
  
Если вы ранее вручную сгенерировали SSH-ключ для пользователя `wisla` он будет удалён и записан на сервер заново. Данный подход используется для предотвращения возможных проблем с уже существующими записями в файле `known_hosts`.</p>

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

```bash
Настройка беспарольного подключения по SSH...

Number of key(s) added: 1

Now try logging into the machine, with:   "ssh -o 'StrictHostKeyChecking=no' 'wisla@localhost'"
and check to make sure that only the key(s) you wanted were added.

                                                                                                                 OK
Проверка подключения к localhost...
Подключение к localhost выполнено успешно.
                                                                                                                 OK

/usr/bin/ssh-copy-id: WARNING: All keys were skipped because they already exist on the remote system.
                (if you think this is a mistake, you may want to use -f option)

                                                                                                                 OK
Проверка подключения к wisla...
Подключение к wisla выполнено успешно.
                                                                                                                 OK
```

После настройки беспарольного подключения программа изменит основную версию языка программирования `python3` для корректной работы инсталлятора wiSLA 5 и проверит его наличие в домашнем каталоге пользователя `wisla`.

```bash
Изменение основной версии python3...
Основная версия python3 успешно изменена.
                                                                                                                 OK
```

Если вы загрузили на сервер все три файла (архив с файлами программы, программу и инсталлятор wiSLA 5) будет произведено обновление прав доступа на инсталлятор для сервисной учётной записи `wisla`.

```bash
Найден файл установки ./wisla-5.2.11-2505210711.run.
Добавление прав на выполнение...
                                                                                                                 OK
```

Следующий шаг будет отличаться в зависимости от ОС, где была запущена программа.

Нажмите на блок с вашей ОС чтобы ознакомится с информацией:

<details id="bkmrk-debian-%C2%A0-%C2%A0-%D0%94%D0%B0%D0%BB%D0%B5%D0%B5-%D0%BF%D1%80%D0%BE"><summary>Debian</summary>

На этом этапе программа выполнит настройку локали, в терминале у вас появится окно с псевдографическим интерфейсом.

Вывод в терминале:

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/2ieimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/2ieimage.png)

 Выберете кодировку `ru_RU.UTF-8 UTF-8` и нажмите на кнопку `Ok` внизу.

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/YFHimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/YFHimage.png)

 Затем будет запущен процесс изменения локализации для пакетов в системе, также выберете `ru_RU.UTF-8 UTF-8` и нажмите на кнопку `Ok` внизу.

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/uvZimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/uvZimage.png)

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

Для просмотра журнала укажите значение `д` и нажмите клавишу `Enter`, затем укажите номер нужной утилиты для чтения файла и ещё раз нажмите на клавишу `Enter`.

Вывод в терминале будет следующего вида:

```bash
Выполняется настройка локализации...
Generating locales (this might take a while)...
  ru_RU.UTF-8... done
Generation complete.
Параметры локализации были обновлены.
                                                                                                                 OK
Generating locales (this might take a while)...
  ru_RU.UTF-8... done
Generation complete.
                                                                                                                 OK
Вы хотите ознакомиться с журналом программы? (д/н): д
Выберите программу для чтения журнала:
1) tail
2) less
3) lnav
Укажите подходящий вариант (1/2/3): 1

Выполняется чтение журнала с помощью tail...

16:02:51 [INFO] Ср 13 ноя 2024 16:02:51 MSK
16:02:51 [INFO] Запущена программа предварительной настройки узла wisla.
16:02:51 [INFO] Версия программы: 1.8.1.
16:02:51 [INFO] Версия ОС: Debian 12.7
16:02:51 [INFO] Файл /home/wisla/wisla-pkgs.zip существует.
16:03:12 [INFO] Выбран вариант установки с подключением к сети интернет.
16:03:16 [INFO] Кэш репозиториев обновлён успешно.
16:03:16 [INFO] Зависимости успешно исправлены.
16:04:40 [INFO] Обновление пакетов выполнено успешно.
16:04:41 [INFO] Неиспользуемые пакеты успешно удалены.
16:04:41 [INFO] Запущен механизм установки необходимых пакетов.
16:04:47 [INFO] Пакет ntp установлен успешно.
16:04:49 [INFO] Пакет pv установлен успешно.
16:04:52 [INFO] Пакет uuid установлен успешно.
16:04:56 [INFO] Пакет ntpdate установлен успешно.
16:04:56 [INFO] Пакет libsodium23 установлен успешно.
16:04:57 [INFO] Пакет liblzo2-2 установлен успешно.
16:05:00 [INFO] Пакет dialog установлен успешно.
16:05:03 [INFO] Пакет rsync установлен успешно.
16:05:03 [INFO] Пакет zip установлен успешно.
16:05:04 [INFO] Пакет unzip установлен успешно.
16:05:04 [INFO] Пакет wget установлен успешно.
16:05:04 [INFO] Пакет tar установлен успешно.
16:05:04 [INFO] Пакет python3 установлен успешно.
16:05:11 [INFO] Пакет python3-paramiko установлен успешно.
16:05:13 [INFO] Пакет python3-asn1crypto установлен успешно.
16:05:13 [INFO] Пакет python3-bcrypt установлен успешно.
16:05:14 [INFO] Пакет python3-cffi-backend установлен успешно.
16:05:14 [INFO] Пакет python3-cryptography установлен успешно.
16:05:14 [INFO] Пакет python3-nacl установлен успешно.
16:05:15 [INFO] Пакет fontconfig установлен успешно.
16:05:15 [INFO] Пакет curl установлен успешно.
16:05:46 [INFO] Пакет glusterfs-client установлен успешно.
16:05:59 [INFO] Пакет glusterfs-server установлен успешно.
16:06:01 [INFO] Пакет sshpass установлен успешно.
16:06:05 [INFO] Пакет ncat установлен успешно.
16:06:07 [INFO] Пакет net-tools установлен успешно.
16:06:10 [INFO] Пакет libpcrecpp0v5 установлен успешно.
16:06:12 [INFO] Пакет iperf установлен успешно.
16:06:13 [INFO] Пакет neofetch установлен успешно.
16:06:13 [INFO] Пакет lnav установлен успешно.
16:06:13 [INFO] Основная версия python3 была изменена.
16:06:13 [INFO] Сетевой фильтр UFW уже установлен в системе.
16:06:13 [INFO] Текущее состояние сетевого фильтра UFW: active
16:06:13 [INFO] Сетевой фильтр UFW активен.
16:06:13 [INFO] Добавлено правило для порта 8443 с протоколом tcp.
16:06:13 [INFO] Добавлено правило для порта 8080 с протоколом tcp.
16:06:14 [INFO] Добавлено правило для порта 443 с протоколом tcp.
16:06:14 [INFO] Добавлено правило для порта 22 с протоколом tcp.
16:06:14 [INFO] Добавлено правило для порта 8787 с протоколом udp.
16:06:14 [INFO] Добавлено правило для порта 10862 с протоколом udp.
16:06:14 [WARNING] Каталог /opt/wisla5 не найден!
16:06:14 [INFO] Создан общий каталог /opt/wisla5.
16:06:14 [INFO] Обновлены права доступа на каталог "/opt/wisla5" для пользователя "wisla".
16:06:14 [WARNING] Каталог /home/wisla/.ssh не найден!
16:06:14 [INFO] Создан общий каталог /home/wisla/.ssh.
16:06:14 [INFO] Обновлены права доступа на каталог "/home/wisla/.ssh" для пользователя "wisla".
16:06:15 [INFO] Сгенерирован SSH-ключ для пользователя wisla, узел wisla.
16:06:28 [INFO] Ключ успешно скопирован на узел wisla.
16:06:28 [INFO] Файл /etc/sudoers.d/wisla был обновлён.
16:06:28 [INFO] Файл /etc/security/limits.d/wisla был обновлён.
16:06:29 [INFO] Параметры локализации были обновлены.

Работа программы завершена.
```

</details><details id="bkmrk-ubuntu-%C2%A0-%D0%94%D0%B0%D0%BB%D0%B5%D0%B5-%D0%BF%D1%80%D0%BE%D0%B3%D1%80"><summary>Ubuntu</summary>

На этом этапе программа выполнит настройку локализации переключив её на `UTF-8`:

```bash
Выполняется настройка локализации...
Generating locales (this might take a while)...
  ru_RU.ISO-8859-5... done
Generation complete.
                                                                                                                 OK
Generating locales (this might take a while)...
  ru_RU.UTF-8... done
Generation complete.
Параметры локализации были обновлены.
                                                                                                                 OK
```

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

Для просмотра журнала укажите значение `д` и нажмите клавишу `Enter`, затем укажите номер нужной утилиты для чтения файла и ещё раз нажмите на клавишу `Enter`.

Вывод в терминале будет следующего вида:

```bash
Вы хотите ознакомиться с журналом программы? (д/н): д
Выберите программу для чтения журнала:
1) tail
2) less
3) lnav
Укажите подходящий вариант (1/2/3): 1

Выполняется чтение журнала с помощью tail...

13:31:12 [INFO] Ср 13 ноя 2024 13:31:12 UTC
13:31:12 [INFO] Запущена программа предварительной настройки узла template-ubuntu.
13:31:12 [INFO] Версия программы: 1.8.1.
13:31:12 [INFO] Версия ОС: Ubuntu 24.04.1 LTS
13:31:12 [INFO] Файл /home/wisla/wisla-pkgs.zip существует.
13:31:15 [INFO] Выбран вариант установки с подключением к сети интернет.
13:31:24 [INFO] Кэш репозиториев обновлён успешно.
13:31:24 [INFO] Зависимости успешно исправлены.
13:35:03 [INFO] Обновление пакетов выполнено успешно.
13:36:36 [INFO] Неиспользуемые пакеты успешно удалены.
13:36:36 [INFO] Запущен механизм установки необходимых пакетов.
13:36:41 [INFO] Пакет sntp установлен успешно.
13:36:44 [INFO] Пакет pv установлен успешно.
13:36:49 [INFO] Пакет uuid установлен успешно.
13:36:54 [INFO] Пакет ntpdate установлен успешно.
13:36:54 [INFO] Пакет libsodium23 установлен успешно.
13:36:54 [INFO] Пакет liblzo2-2 установлен успешно.
13:36:58 [INFO] Пакет dialog установлен успешно.
13:36:59 [INFO] Пакет rsync установлен успешно.
13:36:59 [INFO] Пакет zip установлен успешно.
13:37:00 [INFO] Пакет unzip установлен успешно.
13:37:00 [INFO] Пакет wget установлен успешно.
13:37:00 [INFO] Пакет tar установлен успешно.
13:37:01 [INFO] Пакет python3 установлен успешно.
13:37:04 [INFO] Пакет python3-paramiko установлен успешно.
13:37:07 [INFO] Пакет python3-asn1crypto установлен успешно.
13:37:07 [INFO] Пакет python3-bcrypt установлен успешно.
13:37:08 [INFO] Пакет python3-cffi-backend установлен успешно.
13:37:08 [INFO] Пакет python3-cryptography установлен успешно.
13:37:09 [INFO] Пакет python3-nacl установлен успешно.
13:37:09 [INFO] Пакет fontconfig установлен успешно.
13:37:09 [INFO] Пакет curl установлен успешно.
13:37:21 [INFO] Пакет glusterfs-client установлен успешно.
13:37:33 [INFO] Пакет glusterfs-server установлен успешно.
13:37:37 [INFO] Пакет sshpass установлен успешно.
13:37:45 [INFO] Пакет ncat установлен успешно.
13:37:49 [INFO] Пакет net-tools установлен успешно.
13:37:54 [INFO] Пакет libpcrecpp0v5 установлен успешно.
13:37:58 [INFO] Пакет iperf установлен успешно.
13:37:58 [INFO] Пакет neofetch установлен успешно.
13:37:58 [INFO] Пакет lnav установлен успешно.
13:37:59 [INFO] Пакет locales установлен успешно.
13:37:59 [INFO] Основная версия python3 была изменена.
13:37:59 [INFO] Сетевой фильтр UFW уже установлен в системе.
13:37:59 [INFO] Текущее состояние сетевого фильтра UFW: inactive
13:37:59 [INFO] Сетевой фильтр UFW неактивен.
13:37:59 [INFO] Добавлено правило для порта 8443 с протоколом tcp.
13:37:59 [INFO] Добавлено правило для порта 8080 с протоколом tcp.
13:37:59 [INFO] Добавлено правило для порта 443 с протоколом tcp.
13:37:59 [INFO] Добавлено правило для порта 22 с протоколом tcp.
13:37:59 [INFO] Добавлено правило для порта 8787 с протоколом udp.
13:37:59 [INFO] Добавлено правило для порта 10862 с протоколом udp.
13:37:59 [WARNING] Каталог /opt/wisla5 не найден!
13:37:59 [INFO] Создан общий каталог /opt/wisla5.
13:37:59 [INFO] Обновлены права доступа на каталог "/opt/wisla5" для пользователя "wisla".
13:37:59 [INFO] Каталог /home/wisla/.ssh существует.
13:37:59 [INFO] Обновлены права доступа на каталог "/home/wisla/.ssh" для пользователя "wisla".
13:38:01 [INFO] Сгенерирован SSH-ключ для пользователя schipper, узел template-ubuntu.
13:40:35 [INFO] Ключ успешно скопирован на узел template-ubuntu.
13:40:35 [INFO] Файл /etc/sudoers.d/wisla был обновлён.
13:40:35 [INFO] Файл /etc/security/limits.d/wisla был обновлён.
13:40:36 [INFO] Параметры локализации были обновлены.

Работа программы завершена.
```

</details><details id="bkmrk-astra-linux-%D0%9D%D0%B0-%D1%8D%D1%82%D0%BE%D0%BC-"><summary>Astra Linux</summary>

На этом шаге программа отключит опцию `KillUserProcesses` и создаст файл `systemd unit` для добавления ***wiSLA 5*** в автозагрузку.   
Вывод в терминале будет следующего вида:

```bash
Отключение опции KillUserProcesses...
Опция KillUserProcesses отключена.
                                                                                                          OK
Отключение мандатного контроля...
Мандатный контроль отключен.
                                                                                                          OK
Создаётся unit systemd для wiSLA 5...
Обновление конфигурации демонов...
                                                                                                          OK
Systemd unit создан успешно.
                                                                                                          OK
```

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

Для просмотра журнала укажите значение `д` и нажмите клавишу `Enter`, затем укажите номер нужной утилиты для чтения файла и ещё раз нажмите на клавишу `Enter`.

Вывод в терминале будет следующего вида:

```bash
Вы хотите ознакомиться с журналом программы? (д/н): д
Выберите программу для чтения журнала:
1) tail
2) less
3) lnav
Укажите подходящий вариант (1/2/3): 1

Выполняется чтение журнала с помощью tail...

14:14:45 [INFO] Пн мая 26 14:14:45 MSK 2025
14:14:45 [INFO] Запущена программа предварительной настройки узла wisla.
14:14:45 [INFO] Версия ОС: Astra Linux 1.7.7
14:14:45 [INFO] Версия Debian: 10.0
14:14:45 [WARNING] Файл /etc/sudoers.d/wisla был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/sudoers.d/wisla.
14:14:46 [INFO] Файл "/etc/sudoers.d/wisla" был обновлён.
14:14:46 [WARNING] Файл /etc/security/limits.d/wisla был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/security/limits.d/wisla.
14:14:46 [INFO] Файл "/etc/security/limits.d/wisla" был обновлён.
14:14:46 [WARNING] Файл /etc/logrotate.d/wisla был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/logrotate.d/wisla.
14:14:46 [INFO] Файл "/etc/logrotate.d/wisla" был обновлён.
14:14:46 [WARNING] Файл /etc/logrotate.d/zookeeper был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/logrotate.d/zookeeper.
14:14:46 [INFO] Файл "/etc/logrotate.d/zookeeper" был обновлён.
14:14:46 [WARNING] Файл /etc/logrotate.d/hadoop был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/logrotate.d/hadoop.
14:14:46 [INFO] Файл "/etc/logrotate.d/hadoop" был обновлён.
14:14:46 [WARNING] Файл /etc/logrotate.d/hbase был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/logrotate.d/hbase.
14:14:46 [INFO] Файл "/etc/logrotate.d/hbase" был обновлён.
14:14:46 [WARNING] Файл /etc/logrotate.d/postgres был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/logrotate.d/postgres.
14:14:46 [INFO] Файл "/etc/logrotate.d/postgres" был обновлён.
14:14:46 [WARNING] Файл /etc/logrotate.d/wildfly был удалён.
14:14:46 [INFO] Создан файл конфигурации /etc/logrotate.d/wildfly.
14:14:46 [INFO] Файл "/etc/logrotate.d/wildfly" был обновлён.
14:14:46 [INFO] Каталог /home/wisla/.ssh существует.
14:14:46 [INFO] Каталог /opt/wisla5 существует.
14:14:47 [INFO] Файл установки ./wisla-5.2.11-2505210711.run перемещён в каталог /home/wisla..
14:14:47 [INFO] Обновлены права доступа на каталог "/opt/wisla5" для пользователя "wisla".
14:14:47 [INFO] Обновлены права доступа на каталог "/home/wisla" для пользователя "wisla".
14:18:39 [INFO] Выбран вариант установки с подключением к сети интернет.
14:18:40 [INFO] Кэш репозиториев обновлён успешно.
14:18:40 [INFO] Зависимости успешно исправлены.
14:18:40 [INFO] Обновление пакетов выполнено успешно.
14:18:40 [INFO] Неиспользуемые пакеты успешно удалены.
14:18:40 [INFO] Запущен механизм установки необходимых пакетов.
14:18:40 [INFO] Пакет ntp установлен успешно.
14:18:41 [INFO] Пакет uuid установлен успешно.
14:18:41 [INFO] Пакет ntpdate установлен успешно.
14:18:41 [INFO] Пакет libsodium23 установлен успешно.
14:18:41 [INFO] Пакет liblzo2-2 установлен успешно.
14:18:41 [INFO] Пакет dialog установлен успешно.
14:18:41 [INFO] Пакет rsync установлен успешно.
14:18:41 [INFO] Пакет zip установлен успешно.
14:18:41 [INFO] Пакет unzip установлен успешно.
14:18:42 [INFO] Пакет wget установлен успешно.
14:18:42 [INFO] Пакет tar установлен успешно.
14:18:42 [INFO] Пакет python3 установлен успешно.
14:18:42 [INFO] Пакет python3-paramiko установлен успешно.
14:18:42 [INFO] Пакет python3-asn1crypto установлен успешно.
14:18:42 [INFO] Пакет python3-bcrypt установлен успешно.
14:18:42 [INFO] Пакет python3-cffi-backend установлен успешно.
14:18:42 [INFO] Пакет python3-cryptography установлен успешно.
14:18:42 [INFO] Пакет python3-nacl установлен успешно.
14:18:43 [INFO] Пакет fontconfig установлен успешно.
14:18:43 [INFO] Пакет curl установлен успешно.
14:18:43 [INFO] Пакет sshpass установлен успешно.
14:18:43 [INFO] Пакет ncat установлен успешно.
14:18:43 [INFO] Пакет netcat установлен успешно.
14:18:43 [INFO] Пакет libpcrecpp0v5 установлен успешно.
14:18:43 [INFO] Запущен механизм установки пакетов для Astra Linux.
14:18:45 [INFO] Сетевой фильтр UFW уже установлен в системе.
14:18:45 [INFO] Текущее состояние сетевого фильтра UFW: inactive
14:18:45 [INFO] Сетевой фильтр UFW неактивен.
14:18:45 [INFO] Добавлено правило для порта 22 с протоколом tcp.
14:18:45 [INFO] Добавлено правило для порта 8080 с протоколом tcp.
14:18:46 [INFO] Добавлено правило для порта 8443 с протоколом tcp.
14:18:46 [INFO] Добавлено правило для порта 8787 с протоколом udp.
14:18:46 [INFO] Добавлено правило для порта 10862 с протоколом udp.
14:18:46 [INFO] Сервис openssh-server уже активен.
14:18:47 [INFO] systemd unit для сервиса openssh-server создан успешно.
14:18:47 [INFO] Сгенерирован SSH-ключ для пользователя wisla, узел wisla.
14:18:58 [INFO] Ключ успешно скопирован на узел localhost.
14:18:59 [INFO] Ключ успешно скопирован на узел wisla.
14:18:59 [INFO] Основная версия python3 была изменена.
14:18:59 [INFO] Опция KillUserProcesses была отключена.
14:19:05 [INFO] Мандатный контроль отключен.
14:19:05 [WARNING] Файл /etc/systemd/system/wisla.service был удалён.
14:19:05 [INFO] Создан файл конфигурации /etc/systemd/system/wisla.service.
14:19:05 [INFO] Файл "/etc/systemd/system/wisla.service" был обновлён.
14:19:15 [INFO] Перезагрузка сервера не выполнена.
14:19:15 [INFO] Файл установки ./wisla-5.2.11-2505210711.run сделан исполняемым.
14:19:18 [INFO] Временные файлы были успешно удалены.
14:19:18 [INFO] Предварительная настройка узла wisla завершена.

```

Далее программа предложит перезагрузить сервер, чтобы применить изменения после отключения опции `KillUserProcesses`.

Отправьте сервер в перезагрузку передав значение `д` и нажав клавишу `Enter`:

```bash
Вы хотите перезагрузить сервер? (д/н): д
Отправлена команда на перезагрузку сервера...
                                                                                                          OK
Программа выполняет удаление временных файлов, пожалуйста подождите...
Временные файлы были удалены.
                                                                                                          OK
Работа программы завершена.

Remote side unexpectedly closed network connection
```

После перезагрузки сервера повторно подключитесь к нему по SSH, чтобы перейти к установке системы мониторинга ***wiSLA 5***.

</details><details id="bkmrk-red-os-%D0%9D%D0%B0-%D1%8D%D1%82%D0%BE%D0%BC-%D1%88%D0%B0%D0%B3%D0%B5-"><summary>Red OS</summary>

На этом шаге программа обновит конфигурацию `SELinux` и подавит его работу (выключит) до следующей перезагрузки сервера.

Вывод в терминале будет следующего вида:

```bash
Выполняется настройка SELinux...
Конфигурация SELinux обновлена успешно.
                                                                                                                 OK
Отключение SELinux...
SELinux отключен.
                                                                                                                 OK
```

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

Для просмотра журнала укажите значение `д` и нажмите клавишу `Enter`, затем укажите номер нужной утилиты для чтения файла и ещё раз нажмите на клавишу `Enter`.

Вывод в терминале будет следующего вида:

```bash
Вы хотите ознакомиться с журналом программы? (д/н): д
Выберите программу для чтения журнала:
1) tail
2) less
3) lnav
Укажите подходящий вариант (1/2/3): 1

Выполняется чтение журнала с помощью tail...

21:01:27 [INFO] Пн 18 ноя 2024 21:01:27 MSK
21:01:27 [INFO] Запущена программа предварительной настройки узла wisla.
21:01:27 [INFO] Версия программы: 1.8.6.
21:01:27 [INFO] Версия ОС: RED OS release (8.0) DESKTOP
21:01:27 [INFO] Файл /home/wisla/wisla-pkgs.zip существует.
21:01:27 [INFO] Файл /home/wisla/servers.list существует.
21:01:30 [INFO] localhost доступен.
21:01:34 [INFO] wisla доступен.
21:01:40 [INFO] Выбран вариант установки без подключения к сети интернет.
21:01:40 [INFO] Обновлены права доступа на каталог "/home/wisla" для пользователя "wisla".
21:01:42 [INFO] Запущен механизм установки необходимых библиотек из бинарных файлов.
21:01:52 [INFO] Запущен механизм установки пакетов языка программирования python3 из бинарных файлов.
21:01:53 [INFO] Запущен механизм установки необходимых утилит из бинарных файлов.
21:02:00 [INFO] Временные файлы были успешно удалены.
21:02:00 [INFO] Основная версия python3 была изменена.
21:02:00 [ERROR] Сетевой фильтр firewalld не установлен или не активен!
21:02:00 [INFO] Каталог /opt/wisla5 существует.
21:02:00 [INFO] Обновлены права доступа на каталог "/opt/wisla5" для пользователя "wisla".
21:02:00 [INFO] Сервис openssh-server уже активен.
21:02:00 [INFO] systemd unit для сервиса openssh-server создан успешно.
21:02:00 [INFO] Каталог /home/wisla/.ssh существует.
21:02:00 [INFO] Обновлены права доступа на каталог "/home/wisla/.ssh" для пользователя "wisla".
21:02:03 [INFO] Сгенерирован SSH-ключ для пользователя wisla, узел wisla.
21:02:06 [INFO] Ключ успешно скопирован на localhost.
21:02:06 [INFO] Выполнено подключение к localhost с использованием ключа.
21:02:06 [INFO] Ключ успешно скопирован на wisla.
21:02:06 [INFO] Выполнено подключение к wisla с использованием ключа.
21:02:06 [INFO] Файл /etc/sudoers.d/wisla был обновлён.
21:02:07 [INFO] Файл /etc/security/limits.d/wisla был обновлён.
21:02:08 [INFO] Запущен процесс настройки арбитра GlusterFS.
21:02:08 [INFO] Каталог /mnt/gluster/namenode существует.
21:02:08 [INFO] Каталог /mnt/gfs/brick существует.
21:02:08 [INFO] Обновлены права доступа на каталог "/mnt/gluster/namenode" для пользователя "wisla".
21:02:08 [ERROR] Сетевой фильтр firewalld не установлен или не активен!
21:02:08 [INFO] Сервис glusterd запущен.
21:02:09 [INFO] systemd unit для сервиса glusterd создан успешно.
21:02:09 [INFO] Узел wisla добавлен в кластер GlusterFS в качестве свидетеля!
21:02:09 [INFO] Обновлена конфигурация SELinux.
21:02:09 [INFO] SELinux отключен.

Работа программы завершена.
```

</details>После настройки дистрибутива будет произведено удаление временных файлов:

```bash
Программа выполняет удаление временных файлов, пожалуйста подождите...
Временные файлы были удалены.
                                                                                                          OK
Работа программы завершена.
```

Завершив настройку узла можно удалить файлы программы предварительной настройки:

```bash
sudo rm -rf ./preparing-os.start ./preparing.tar /tmp/preparing-os.log
```

Удалив файлы программы можно перейти к установке системы мониторинга **wiSLA 5**.

#### Установка системы мониторинга wiSLA 5

##### 1. Запуск программы установки

Завершив предварительную подготовку системы переключитесь на сервисную учётную запись `wisla`:

```bash
sudo su - wisla
```

<details id="bkmrk-%D0%95%D1%81%D0%BB%D0%B8-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D1%83%D0%B5%D1%82%D0%B5-%D0%B2%D0%B5%D1%80-1"><summary>Если используете версию 1.9.4 и ниже</summary>

1\. Загрузите на сервер программу установки ***wiSLA 5*** нужной версии с помощью утилиты `scp` или любым другим удобным для вас способом.

2\. Затем добавьте права на выполнение:

```bash
sudo chmod +x ./wisla-5.2.*.run
```

</details>
**Программа установки** обеспечивает выполнение всех основных операций с системой и её компонентами: установку, настройку, обновление, удаление, запуск и остановку. Она также поддерживает резервное копирование и восстановление данных, а также предоставляет централизованный доступ к журналам компонентов.

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

Изменения конфигурации работающей системы следует вносить исключительно через интерфейс программы установки. Это гарантирует корректное обновление соответствующих конфигурационных файлов и их сохранение при последующих обновлениях системы.

<p class="callout warning">**Обратите внимание!**   
Программа установки должна запускаться под сервисной учётной записью и в её окружении, в данном примере это пользователь `wisla`.</p>

<p class="callout info">**Информация**  
  
В ходе тестирования выявлено, что при развёртывании окна терминала на весь экран программа установки не запустится.   
**Чтобы запустить установку не разворачивайте окно терминала на весь экран!**</p>

Если установка системы будет аварийно прервана или завершена с ошибкой, журналы установки можно найти в каталоге с программой (`install*.log`, `runtime.log`). Информация о ходе установки также доступна в буфере эмулятора терминала.

Запустите программу установки от имени пользователя `wisla` выполнив команду ниже:

```bash
./wisla-5.2.*.run
```

<p class="callout success">Если программа установки не стартует попробуйте выполнить `export TERM=xterm` перед её запуском.</p>

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

<p class="callout info">**Информация**  
  
Навигация в программе установки осуществляется с помощью стрелок управления курсором, клавиш `Home`, `End`, `Tab`, `Esc` и `Enter`.   
Если требуется аварийно прервать работу программы, можно использовать комбинацию клавиш `CTRL+C`, для штатного завершения программы установки следует использовать кнопку `Exit`.</p>

##### 2. Работа с программой установки wiSLA 5

Во время установки в каталог `/opt/wisla5` будут добавлены следующие компоненты:

- ***Zookeeper***;
- ***Hadoop***;
- ***HBase***;
- ***PostgreSQL***;
- ***Java Runtime Environment***;
- ***WildFly Application Server***;
- ***wiSLA Portal***.

Процесс можно прервать, нажав `CTRL+C`, все настройки будут сброшены.

**1. Окно "Installer startup configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/Q90image.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/Q90image.png)

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

**2. Окно "Old installation was not found. Select an action"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/Smiimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/Smiimage.png)

Выберете вариант **"*Install*"** чтобы перейти к дальнейшей настройке.

**3. Окно "Topology configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/Sorimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/Sorimage.png)

При установке на сервер в одном экземпляре необходимо указать его `hostname` для всех модулей системы, при работе в кластере необходимо указать полную топологию.

Задав топологию запустится процесс инициализации модулей.

**4. Окно "Versions select"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/19Kimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/19Kimage.png)

Выберете нужную версию чтобы продолжить.

**5. Окно "Zookeeper Configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/qN1image.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/qN1image.png)

**6. Окно "Hadoop configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/WjDimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/WjDimage.png)

Проверьте имя ***hostname*** в "***Hadoop cluster name***" и порт, при развёртывании одного экземпляра укажите `localhost`.

**7. Окно "HBase configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/TuSimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/TuSimage.png)

Проверьте имя ***hostname*** в "***Zookeeper quorum***".

**8. Окно "Postgresql configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-05/scaled-1680-/WOFimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-05/WOFimage.png)

Нужно проверить и заполнить "***Trusted network/host"***, иначе будут проблемы с подключением ***Postgresql*** и патчами.

\* Чтобы принимать все подключения укажите значение `all` или `0.0.0.0/0`.

**9. Окно "Wildfly configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/IGiimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/IGiimage.png)

Проверьте значение "***Heap size"***, для локальной установки хватит стандартного значения `2048`, при мониторинге инфраструктуры с большим числом устройств рекомендуется увеличить данное значение. При работе в кластере минимальное значение должно быть `8192`.

**10. Окно "wiSLA Topology Configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/lhSimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/lhSimage.png)

**11. Окно "wiSLA Data Collection Configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/O32image.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/O32image.png)

Если планируется использование зондов ***wiProbe***, нужно прокрутить список и изменить настройку «***wiProbe destination***». В ней задаётся адрес, который будет использоваться зондом для отправки данных в систему ***wiSLA***, в форме ***URL***. Остальные параметры менять без необходимости не рекомендуется.

**12. Окно "wiSLA Resources Configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/tbfimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/tbfimage.png)

Убедитесь, что имя `hostname` указано в ***URL***.

**13. Окно "wiSLA Notification and ASI Configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-05/scaled-1680-/sf7image.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-05/sf7image.png)

На данном этапе необходимо указать параметры почтового клиента, если этого не сделать, тогда новые пользователи не смогут получать письма о добавлении учётной записи и другие уведомления, отсылаемые на email.

Также здесь можно включить отправку SNMP-уведомлений по определённым событиям.

**14. Окно "wiSLA Cloud System"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-05/scaled-1680-/5Vaimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-05/5Vaimage.png)


**15. Окно "Operator Portal Configuration"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/mJfimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/mJfimage.png)

<p class="callout warning">**Обратите внимание!**  
  
Если вы получаете доступ к порталу с помощью проброса портов или через прокси сервер, тогда вам необходимо отредактировать пункт ***HOST*** и в ***Whitelisted domains*** установить необходимые IP-адреса.</p>

**16. Окно "Confirm the installation"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/CJmimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/CJmimage.png)

На этом этапе вы ещё можете вернуться назад и внести исправления в настройки, после подтверждения начинается процесс установки.

**17. Окно "Add wiSLA to the autorun list"**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-11/scaled-1680-/Clqimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-11/Clqimage.png)

После установки системы будет предложено добавить службу в список автозагрузки, нажмите кнопку `Yes`, если вы установили её на `Debian` или `Ubuntu`.

<details id="bkmrk-astra-linux-%D0%95%D1%81%D0%BB%D0%B8-%D0%B2%D1%8B-"><summary>Astra Linux</summary>

Если вы используете ***Astra Linux*** нажмите кнопку `No`, т.к. `systemd unit` для ***wiSLA 5*** был создан ранее программой предварительной настройки узла.

После установки ***wiSLA 5*** вам необходимо вручную добавить службу в автозагрузку, для этого выполните приведённую ниже команду:

```bash
sudo systemctl enable wisla.service
```

</details>Система мониторинга ***wiSLA 5*** установлена на ваш сервер.

##### 3. Запуск wiSLA

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

```bash
less -f /opt/wisla5/wildfly/current/standalone/log/server.log
less -f /opt/wisla5/wildfly/current/standalone/log/communicator.log
```

Маркером успешного запуска является следующее сообщение в журнале (server.log):

```bash
INFO  [com.wellink.wisla.communicator.impl.state.AvailabilitySystemStateSingletonImpl] (http-0.0.0.0-0.0.0.0-8080-1) !***   THE ALL wiSLA
COMPONENTS ARE FULLY DEPLOYED, INTERCONNECTED AND READY TO WORK!   ***!
13:48:30,028 INFO  [com.wellink.wisla.communicator.impl.state.AvailabilitySystemStateSingletonImpl] (http-0.0.0.0-0.0.0.0-8080-1) !********************
**********************************************************************!
```

Теперь можно запустить веб-браузер и открыть страницу системы указав доменное имя или IP-адрес сервера и порт.

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-06/scaled-1680-/5moimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-06/5moimage.png)

<span style="color: #000000;">   
</span>В данном примере система будет доступна по адресу `https://wisla.it-superman.keenetic.pro`.

# Изменение одного или нескольких параметров wiSLA

<span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Если требуется внести изменения в настройки уже установленной системы wiSLA, следует:</span>

1. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Запустить программу установки. Перейти в основное меню. Внешний вид основного меню показан на рисунке 27. </span><span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-pllxurvo.png)</span>
    
    <span style="background-color: rgb(255, 255, 255); color: rgb(35, 111, 161);"><span style="font-size: 10pt; line-height: 120%; font-family: Arial, sans-serif;">Рис. </span><span style="font-size: 10pt; line-height: 120%; font-family: Arial, sans-serif;"><span style="mso-no-proof: yes;">27</span></span><span style="font-size: 10pt; line-height: 120%; font-family: Arial, sans-serif;"> Главное меню программы установки в случае обнаружения установленной wiSLA </span></span>
2. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);"><span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);"><span style="font-size: 10pt; line-height: 120%; font-family: Arial, sans-serif;">Выбрать пункт меню «Config update». Если этого пункта меню нет в списке, установка была  
    выполнена некорректно или на первом экране при запуске программы установки были  
    указаны ошибочные данные.  
    </span></span></span>
3. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);"><span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);"><span style="font-size: 10pt; line-height: 120%; font-family: Arial, sans-serif;">Найти, изменить требуемый параметр.  
    </span></span></span>
4. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);"><span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);"><span style="font-size: 10pt; line-height: 120%; font-family: Arial, sans-serif;">Выполнить перезапуск wiSLA.</span></span></span>

# Экранные формы хода установки (Работа с программой установки)

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

Внесение изменений в настройки работающей системы должно производиться через интерфейс программы установки. В этом случае они будут корректно внесены в соответствующие конфигурационные файлы системы и сохранены при обновлении системы. Программа установки должна выполняться от имени пользователя wisla и в его окружении. Для корректной работы программы не рекомендуется разворачивать окно на весь экран. Если установка wiSLA будет аварийно прервана или завершена с ошибкой, журналы установки можно найти в рабочем каталоге (install\*.log, runtime.log). Информация о ходе установки также доступна в буфере эмулятора терминала.

## Запуск программы установки

  
Для запуска программы установки требуется:  
1\. Выполнить вход от имени пользователя wisla с инициализацией переменных окружения:

```bash
su -l wisla
```

2\. Войти в каталог, куда была скопирована программа установки, и выполнить команду  
запуска:

```
./wisla*.run
```

Должно открыться окно, показанное на рисунке 9

![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-vx27jazm.png)

<span style="color: rgb(35, 111, 161);">Рис. 9 Интерфейс программы установки: окно предварительных настроек</span>

<span style="color: rgb(0, 0, 0);">Если показанное на рисунке 9 окно не открылось, следует проанализировать сообщения об ошибках и созданные в текущем каталоге log-файлы.</span>

<span style="color: rgb(0, 0, 0);">Навигация в программе установки осуществляется с помощью стрелок управления курсором, клавиш Home, End, Tab, Esc и Enter. Если требуется аварийно прервать работу программы, можно использовать комбинацию клавиш CTRL+C. Для штатного завершения программы установки следует использовать кнопку Exit. После выхода из программы установки экраны с историей выполнения доступны в буфере терминала.</span>

## <span style="color: rgb(0, 0, 0);">Перечень действий для установки wiSLA  
</span>

<span style="color: rgb(0, 0, 0);">Ниже будут описаны действия для установки wiSLA на один сервер. В примере сервер будет назван VM1.</span>

<span style="color: rgb(0, 0, 0);">1. Запустить программу установки.</span>

<span style="color: rgb(0, 0, 0);">2. На первом экране принять предложенные настройки, нажав Enter. Программа установки проанализирует окружение. Если это первый запуск, откроется меню, показанное на рисунке 10.  
</span><span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-1wyqbonw.png)</span>

<span style="color: rgb(0, 0, 0);"><span style="color: rgb(35, 111, 161);">Рис. 10 Интерфейс программы установки: меню при первом запуске</span>  
</span>

<span style="color: rgb(0, 0, 0);">Из заголовка окна видно, что система не обнаружила установленной wiSLA на данном сервере. В описании к действию Install отображается версия, которая будет установлена, и номер сборки. Номер сборки на рисунке (цифры после «build») приведён на момент написания документа и может отличаться, так как любое изменение программного кода сопровождается пересборкой дистрибутива. Для перехода к следующему шагу нужно нажать Enter (выполнив тем самым действие «Next»), на выделенной строке «Install».  
</span>

<span style="color: rgb(0, 0, 0);">3. На следующем экране задаётся топология будущего контура wiSLA. В примере, показанном на рисунке 11, установка всех компонентов проводится на один сервер VM1. В зависимости от размера окна некоторые настройки могут оказаться вне области видимости. Для доступа к ним нужно последовательно нажимать кнопку «вниз». По достижении самой нижней строки настройки на уровне границы окна под настройкой появляется отметка «100%».</span>

<span style="color: rgb(0, 0, 0);">Настройка топологии выполняется один раз при первой установке системы. Впоследствии смена топологии через настройки программы установки не приведёт к желаемому результату (потребуется скорректировать ряд настроек вручную или выполнить установку «с нуля» с восстановлением данных из резервной копии), поэтому рекомендуется внимательно проверять введённые данные на данном этапе установки. После выполнения настроек переход к следующему экрану осуществляется кнопкой Next.  
</span>

<span style="color: rgb(0, 0, 0);">Если требуется распределить компоненты по разным серверам, нужно указать соответствующие доменные или сетевые имена серверов. В этом случае нужно, чтобы между серверами был организован беспарольный доступ по ключу (SSH) для пользователя wisla.</span>

<p class="callout info"><span style="color: rgb(0, 0, 0);"> ноды для апп серверов(сбор данных c slamon агентов) можно сделать 6 штук + op,cont по 2 штуки </span></p>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-izwntjcj.png)</span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="color: #206ea7;"> </span><span style="mso-no-proof: yes;">11</span> Интерфейс программы установки: топология</span>

<span style="color: rgb(0, 0, 0);">4. После задания топологии система может запросить пароль пользователя wisla. Это нужно для выполнения команды создания рабочего каталога в /opt, что требует привилегий *sudo*.  
5\. После создания рабочего каталога будет выполнена инициализация необходимых модулей и распаковка дистрибутива во временный каталог. Время ожидания зависит от производительности дисковой подсистемы сервера.  
6\. На следующем экране (рисунок 12) требуется выбрать версию и архитектуру Java Runtime Environment (как правило, используется архитектура x86\_64, а версия представлена одна).</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-yvivy1t2.png)</span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">12</span> Интерфейс программы установки: выбор версии JRE</span>

<span style="color: rgb(0, 0, 0);">7. После распаковки и выбора версии JRE программа установки оценит параметры сервера и автоматически рассчитает значения по распределению оперативной памяти для различных компонентов системы. Впоследствии их можно будет изменить, однако это стоит делать только в том случае, когда администратору точно известно, что предложенные значения неоптимальны или ошибочны.  
8\. Настройка компонента Zookeper (рисунок 13). Рекомендуется оставить настройки, предложенные по умолчанию.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-92njb2d4.png)</span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">13</span> Интерфейс программы установки: настройки компонента Zookeeper</span>

<span style="color: rgb(0, 0, 0);">9. Настройка компонента Hadoop (рисунок 14). Рекомендуется оставить настройки, предложенные по умолчанию</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-5hthqfrc.png)</span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">14</span> Интерфейс программы установки: настройки компонента Hadoop</span>

<span style="color: rgb(0, 0, 0);">10. Настройка компонента HBase (рисунок 15). Рекомендуется оставить настройки, предложенные по умолчанию.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-mrkml3jn.png)</span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">15</span> Интерфейс программы установки: настройки компонента HBase</span>

<span style="color: rgb(0, 0, 0);">11. Настройка компонента PostgreSQL (рисунок 16). Требуется прокрутить список настроек и изменить параметр «Trusted network/host». В примере сервер БД будет принимать все подключения от адресов 10.0.2.x. В случае неудачной настройки параметра установка wiSLA завершится ошибкой, так как сервер БД не сможет инициализировать БД.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-roh9lwty.png)</span>

<span style="color: rgb(35, 111, 161);">Рис. <span style="mso-no-proof: yes;">16</span> Интерфейс программы установки: настройки компонента PostgreSQL</span>

<span style="color: rgb(0, 0, 0);">12. Настройка компонента Wildfly (рисунок 17). Рекомендуется оставить настройки, предложенные по умолчанию.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-9nys5d0d.png)</span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">17</span> Интерфейс программы установки: настройки сервера приложений <span lang="EN-US" style="mso-ansi-language: EN-US;">Wildfly</span></span>

<span style="color: rgb(0, 0, 0);"><span lang="EN-US" style="mso-ansi-language: EN-US;">13. Настройка топологии wiSLA. В примере все компоненты устанавливаются на сервер с именем VM1 (рисунок 18).</span></span>

<span style="color: rgb(0, 0, 0);"><span lang="EN-US" style="mso-ansi-language: EN-US;">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-newyspyd.png)</span></span>

<span style="color: rgb(35, 111, 161);">Рис. <span style="mso-no-proof: yes;">18</span> Интерфейс программы установки: настройки топологии wiSLA</span>

<span style="color: rgb(0, 0, 0);">14. Настройки модуля сбора данных. Если планируется использование зондов wiProbe, нужно прокрутить список и изменить настройку «wiProbe destination». В ней задаётся адрес, который будет использоваться зондом для отправки данных в систему wiSLA, в форме URL (рисунок 19). Остальные параметры менять без необходимости не рекомендуется.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-nmp5nmrd.png)</span>

<span style="color: rgb(35, 111, 161);">Рис. <span style="mso-no-proof: yes;">19</span> Интерфейс программы установки: настройки модуля сбора данных  
  
</span>

<span style="color: rgb(0, 0, 0);">15. Настройки интеграции LDAP (в том числе, Active Directory), рисунок 20. Если LDAP не планируется использовать, рекомендуется оставить значения по умолчанию.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-m6yxlzfq.png)</span>

<span style="color: rgb(35, 111, 161);">Рис. 20 Интерфейс программы установки: настройки интеграции LDAP</span>

<span style="color: rgb(0, 0, 0);">16. Настройки дополнительных ресурсов wiSLA. Рекомендуется оставить значения по умолчанию (рисунок 21).</span>

<p class="callout warning"><span style="color: rgb(0, 0, 0);">При необходимости ограничения исторических данных рекомендуется изучить рисунок 21.1</span></p>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-w98b1rz9.png)</span>

<span style="color: rgb(35, 111, 161);">Рис. 21 Интерфейс программы установки: настройки дополнительных ресурсов</span>

**a. "Store metrics data only for this period"** - Данный параметр отвечает за период в течении которого будет осуществляться хранение данных. Указывается в днях. Стандартное значение не указано. Минимально возможное значение 0 дней. Дробные значения и значения &lt;0 недопустимы.

<p class="callout warning">Не рекомендуется устанавливать параметр **"Store metrics data only for this period"** **= 0**, в таком случае будут удалены все исторические данные показателей.  
</p>

**b. "Metrics eraser schedule period"** - Данный параметр отвечает за периодичность запуска механизма удаления данных из нереляционной базы Hbase. Указывается в днях. Стандартное значение - 7 дней. Минимально возможное значение 1 день. Дробные значения и значения &lt;0 недопустимы.

<p class="callout warning">Не рекомендуется устанавливать параметр **"Metrics eraser schedule period"** **= 0**, в таком случае механизм удаления данных не будет запускаться.  
</p>

*\*Реализована возможность гибкой настройки параметров удаления данных. Например, можно удалять данные раз в год, оставляя при этом данные за последний месяц (Значение для первого параметра = 30, для второго параметра = 365)*

[![11.png](https://wiki.wellink.ru/uploads/images/gallery/2023-06/scaled-1680-/11.png)](https://wiki.wellink.ru/uploads/images/gallery/2023-06/11.png)  
Рис. 21.1. Экран инсталлятора wiSLA (Вкладка wiSLA Resources Configuration)

<span style="color: rgb(0, 0, 0);">17. Настройка рассылки уведомлений (рисунок 22). На этом экране, как минимум, требуется указать параметры подключения к почтовому серверу. Если этого не сделать, новые пользователи не смогут получать письма о добавлении учётной записи и другие уведомления, отсылаемые на адрес электронной почты. Также здесь можно включить отправку SNMP-уведомлений по определённым событиям. Обязательные для настройки параметры перечислены в таблице 3.</span>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-wv6fakn5.png)</span>

Рис.<span style="mso-no-proof: yes;">22</span> Интерфейс программы установки: настройка рассылки уведомлений

<span style="color: rgb(35, 111, 161);">Таблица 3 – Параметры подключения к почтовому серверу.</span>

<table border="1" cellpadding="0" cellspacing="0" class="MsoTableGrid" id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80-%D0%9D%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-" style="border-collapse: collapse; width: 100%; border-width: 1px; border-spacing: 0px;"><thead><tr><td style="width: 120.5pt; border: 1pt solid black; padding: 0cm 5.4pt; height: 26.7292px;" valign="top" width="161">**Параметр**

</td><td style="width: 191.35pt; border-top: 1pt solid black; border-right: 1pt solid black; border-bottom: 1pt solid black; border-image: initial; border-left: none; padding: 0cm 5.4pt; height: 26.7292px;" valign="top" width="255">**Назначение**

</td><td style="width: 99.25pt; border-top: 1pt solid black; border-right: 1pt solid black; border-bottom: 1pt solid black; border-image: initial; border-left: none; padding: 0cm 5.4pt; height: 26.7292px;" valign="top" width="132">**Пример значения**

</td></tr></thead><tbody><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 27.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Notification enabled</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 27.7292px;" valign="top" width="255">Включает рассылку по электронной почте

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 27.7292px;" valign="top" width="132"><span lang="EN-US" style="mso-ansi-language: EN-US;">true</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail host</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255"><span lang="EN-US" style="mso-ansi-language: EN-US;">IP</span> или <span lang="EN-US" style="mso-ansi-language: EN-US;">DNS</span>-адрес почтового сервера

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132"><span lang="EN-US" style="mso-ansi-language: EN-US;">smtp.gmail.com</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail port</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255">Порт, прослушиваемый почтовым сервером

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132">5<span lang="EN-US" style="mso-ansi-language: EN-US;">87</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail protocol</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255">Протокол, используемый почтовым сервером

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132"><span lang="EN-US" style="mso-ansi-language: EN-US;">smtps</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail SMTP auth</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255">Включается, если почтовый сервер поддерживает <span lang="EN-US" style="mso-ansi-language: EN-US;">smtp</span>-авторизацию

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132"><span lang="EN-US" style="mso-ansi-language: EN-US;">true</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail SMTP STARTTLS</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255">Включается, если почтовый сервер поддерживает <span lang="EN-US" style="mso-ansi-language: EN-US;">SMTP</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">STARTTLS</span>

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132"><span lang="EN-US" style="mso-ansi-language: EN-US;">true</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail user</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255">Имя пользователя, от имени которого выполняется рассылка

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132"><span lang="EN-US" style="mso-ansi-language: EN-US;">wisla.vm1</span>

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Mail password</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="255">Пароль пользователя, от имени которого выполняется рассылка

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 23.7292px;" valign="top" width="132">пароль

</td></tr><tr><td style="width: 120.5pt; border-right: 1pt solid black; border-bottom: 1pt solid black; border-left: 1pt solid black; border-image: initial; border-top: none; padding: 0cm 5.4pt; height: 68.5208px;" valign="top" width="161"><span lang="EN-US" style="mso-ansi-language: EN-US;">Tickets per notification</span>

</td><td style="width: 191.35pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 68.5208px;" valign="top" width="255">Используется для группировки писем по инцидентам в блоки по <span lang="EN-US" style="mso-ansi-language: EN-US;">N</span> штук. Если установлена единица, на каждый инцидент отправляется по одному письму

</td><td style="width: 99.25pt; border-top: none; border-left: none; border-bottom: 1pt solid black; border-right: 1pt solid black; padding: 0cm 5.4pt; height: 68.5208px;" valign="top" width="132">1

</td></tr></tbody></table>

18\. Настройки wiSLA.Cloud (рисунок 23) позволяют включить или выключить облачный режим системы wiSLA и выполнить его настройку. Подробно данный режим работы рассмотрен в разделе «Облачный режим wiSLA».

![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-zra1ss12.png)

<span style="color: rgb(35, 111, 161);">Рис.<span style="color: #206ea7;"> </span><span style="mso-no-proof: yes;">23</span> Интерфейс программы установки: настройки wiSLA.Cloud</span>

<span style="color: rgb(0, 0, 0);">19. Настройки портала оператора (Рис. 24) позволяют настроить URL для работы системы и задать, сколько дней актуален сохранённый профиль пользователя (имеется в виду сохранение, которое проводится флажком «Запомнить меня» на портале).</span>

<p class="callout warning"><span style="color: rgb(0, 0, 0);">Обращаем ваше внимание, если вы получаете доступ к порталу с помощью проброса портов или через прокси сервер, то вам необходимо отредактировать пункт HOST и в Whitelisted domains установить необходимые IP-адреса.</span></p>

<span style="color: rgb(0, 0, 0);">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-9oguiewx.png)</span>

<span style="color: rgb(35, 111, 161);"><span style="mso-bookmark: _Ref61997573;">Рис. </span><span style="mso-bookmark: _Ref61997611;"><span style="mso-bookmark: _Ref61997573;"><span style="mso-no-proof: yes;">24</span></span></span><span style="mso-bookmark: _Ref61997573;"> Настройки портала оператора</span></span>

<span style="color: rgb(0, 0, 0);"><span style="mso-bookmark: _Ref61997573;">20. Подтверждение настроек (рисунок 25). Программа установки отображает топологию. На этом этапе можно вернуться назад и внести забытые настройки. После подтверждения начинается процесс установки.</span></span>

<span style="color: rgb(0, 0, 0);"><span style="mso-bookmark: _Ref61997573;">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-h9zrmc4w.png)</span></span>

<span style="color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">25</span> Интерфейс программы установки: просмотр топологии и подтверждение настроек</span>

<span style="color: rgb(0, 0, 0);">21. Если установка прошла удачно, программа выведет запрос на добавление сервиса wisla в автозагрузку. Данное действие возможно только в том случае, если пользователь wisla был добавлен в sudoers. В противном случае требуется отказаться от действия.  
</span>

<span style="color: rgb(0, 0, 0);">22. После установки система автоматически запускается. Ход запуска можно отслеживать в журналах работы (Logs viewer – wiSLA logs) и статусах (Status). Признаком успешного запуска является сообщение в журнале server.log, выделенное на рисунке 26. Для полного запуска новой системе без инфраструктуры обычно требуется до 5 минут.</span>

<span style="color: rgb(0, 0, 0);"><span style="mso-bookmark: _Ref61997573;">![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-8k0y8fig.png)</span></span>

<span style="background-color: rgb(255, 255, 255); color: rgb(35, 111, 161);">Рис.<span style="mso-no-proof: yes;">26</span> Сообщение об успешном запуске системы wiSLA в communicator.log</span>

<span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">23. После запуска сервера приложений можно начинать работу с порталом. По умолчанию в системе присутствует пользователь Administrator с паролем Admin@123. Зайдя с этими учётными данными, можно создать пользователя с ролью «Системный администратор», который сможет далее создавать инфраструктуру. Необходимо сменить пароль <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Administrator</span> при первом входе в целях безопасности.  
24\. Если система в ходе установки добавлялась в список автозагрузки, рекомендуется выполнить пробный перезапуск сервера с целью проверки механизма автоматического запуска wiSLA.</span>

# Активация модуля автокорреляции

Для активации модуля автокорреляции необходимо:

<p class="callout info">Автокоррелятор wiCore должен быть установлен и запущен (см. [Руководство администратора wiCore](https://wiki.wellink.ru/books/rukovodstvo-administratora-wicore "Руководство администратора wiCore")).</p>

1\. Запустить программу установки. Перейти в основное меню. Внешний вид основного меню показан на рисунке 1.

![](https://wiki.wellink.ru/uploads/images/gallery/2024-01/embedded-image-pllxurvo.png)

Рис. 1 Главное меню программы установки в случае обнаружения установленной wiSLA

2\. Выбрать пункт меню «Config update». Если этого пункта меню нет в списке, установка была  
выполнена некорректно или на первом экране при запуске программы установки были  
указаны ошибочные данные.  
3\. Перейти на экран wiSLA Resources Configuration.

За активацию автокоррелятора отвечают два параметра:

- **Auto correlator url** (по умолчанию значение locahost:8083),
- **Enabling auto correlator** (по умолчанию значение false).

[![image-1680716978406.png](https://wiki.wellink.ru/uploads/images/gallery/2023-04/scaled-1680-/image-1680716978406.png)](https://wiki.wellink.ru/uploads/images/gallery/2023-04/image-1680716978406.png)

Для активации:

- указать ссылку модуля автокорреляции "**Auto correlator url**" (доменное имя + порт, если в наличии),
- указать значение "**Enabling auto correlator**" как **true.**

[![image-1680717866828.png](https://wiki.wellink.ru/uploads/images/gallery/2023-04/scaled-1680-/image-1680717866828.png)](https://wiki.wellink.ru/uploads/images/gallery/2023-04/image-1680717866828.png)

  
4\. Подтвердить настройки.

5\. Выполнить перезапуск wiSLA.

# Действия при неудачной попытке установки и восстановление работоспособности в случае сбоя

## <span style="color: rgb(0, 0, 0);">Действия при неудачной попытке установки wiSLA</span>  


<span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">В случае если установка wiSLA завершилась c ошибкой, требуется:</span>

1. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Проанализировать причину сбоя установки. Для этого можно использовать log-файлы программы установки в текущем каталоге, а также прокрутку в окне для просмотра хода установки.</span>
2. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Завершить все процессы, связанные с java.</span>
3. <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Выйти из программы установки и удалить новые каталоги в /home/wisla (hadoop, hbase, postgresql, zookeeper).</span>

<span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Повторить попытку установки с исправленными настройками.</span>

## <span style="color: rgb(0, 0, 0);">Регламент по восстановлению работоспособности системы wiSLA в случае сбоя</span>

<span style="color: rgb(0, 0, 0);">Как правило, внешние проявления не дают информации об основной причине сбоя. Ими могут быть: </span>

- <span style="color: rgb(0, 0, 0);">повторяющиеся проблемы при открытии страниц портала;</span>
- <span style="color: rgb(0, 0, 0);">нехарактерное поведение элементов интерфейса;</span>
- <span style="color: rgb(0, 0, 0);">ошибки при сохранении объектов инфраструктуры;</span>
- <span style="color: rgb(0, 0, 0);">отсутствие данных от всех измерительных зондов;</span>
- <span style="color: rgb(0, 0, 0);">отсутствие писем о неисправностях;</span>
- <span style="color: rgb(0, 0, 0);">ошибочные даты на календарях;</span>
- <span style="color: rgb(0, 0, 0);">ошибочная дата и время в событиях;</span>
- недоступный портал.

<span style="color: rgb(0, 0, 0);">При возникновении одного или нескольких проявлений требуется провести первичную диагностику для установления причины сбоя (таблица 5).</span>

<span style="color: rgb(35, 111, 161);">Таблица 5 – Первичная диагностика и устранение проблемы.</span>

<table border="1" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-%D0%92%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%B0%D1%8F-%D0%BF%D1%80%D0%B8%D1%87%D0%B8%D0%BD%D0%B0-%D1%81%D0%B1" style="border-collapse: collapse; width: 100%; border-width: 1px; border-spacing: 0px;" width="614"><thead><tr style="mso-yfti-irow: 0; mso-yfti-firstrow: yes;"><td style="width: 28.1659%; border: 1pt solid windowtext;" valign="top" width="162">**Возможная причина сбоя**

</td><td style="width: 34.9969%; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-image: initial; border-left: none;" valign="top" width="218">**Действия по выявлению**

</td><td style="width: 36.8684%; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-image: initial; border-left: none;" valign="top" width="234">**Устранение проблемы**

</td></tr></thead><tbody><tr style="mso-yfti-irow: 1;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">1\. Отказ одного из компонентов wiSLA (не является самостоятельной причиной, требует продолжения диагностики)

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Просмотр статусов компонентов wiSLA в программе установки

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Поиск основной причины сбоя, перезапуск всех компонентов wiSLA

</td></tr><tr style="mso-yfti-irow: 2;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">2\. Резкий скачок времени на сервере

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Проверка времени на каждом из узлов, где установлена wiSLA.

Проверка работоспособности службы NTP

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Установка корректных даты и времени, запуск NTP, перезапуск всех компонентов wiSLA. Если база данных испорчена некорректными данными, потребуется выполнить восстановление из резервной копии (обратитесь в службу технической поддержки)

</td></tr><tr style="mso-yfti-irow: 3;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">3\. Продолжительный разрыв связи между узлами wiSLA

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Определение доступности серверов, изучение журналов работы системы, опрос системных администраторов

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Перезапуск всех компонентов wiSLA

</td></tr><tr style="mso-yfti-irow: 4;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">4\. Аварийная перезагрузка одного или нескольких узлов

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Сравнение времени непрерывной работы серверов wiSLA, изучение журналов работы операционной системы сервера с наименьшим временем непрерывной работы

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Перезапуск всех компонентов wiSLA

</td></tr><tr style="mso-yfti-irow: 5;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">5\. Исчерпано свободное место на одном из дисков

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Получение информации об использовании дискового пространства на всех серверах wiSLA

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Очистка дисков, добавление дисков, перезапуск всех компонентов wiSLA. Если перезапуск не решает проблему, возможно, повреждена база данных или программные файлы. В этом случае потребуется восстановить систему из резервной копии или выполнить полную переустановку системы (обратитесь в службу технической поддержки)

</td></tr><tr style="mso-yfti-irow: 6;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">6\. Вмешательство в работу сервера (изменение настроек сети, файловой системы и т.п. при работающей wiSLA)

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Опрос системных администраторов

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Перезапуск всех компонентов wiSLA

</td></tr><tr style="mso-yfti-irow: 7;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">7\. Неудачное обновление wiSLA

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Чтение журнальных файлов после обновления

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Обратитесь в службу технической поддержки

</td></tr><tr style="mso-yfti-irow: 8; mso-yfti-lastrow: yes;"><td style="width: 28.1659%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" valign="top" width="162">8\. Аппаратные проблемы на сервере

</td><td style="width: 34.9969%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="218">Определение проблемного сервера, перезагрузка, просмотр данных POST, изучение журналов операционной системы, проверка диска, тестирование ОЗУ, замена компонентов на заведомо исправные и т.д. Выходит за рамки настоящего Руководства

</td><td style="width: 36.8684%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" valign="top" width="234">Действия зависят от характера сбоя. Если потери данных не было, будет достаточно перезапустить все компоненты wiSLA.

Если в ходе перезапуска возникли проблемы или требуется восстановить программные файлы, обратитесь в службу технической поддержки

</td></tr></tbody></table>

# Восстановление из backup

Система wisla использует 2 СУБД - Postgresql и Hbase.

В установщике присутствует ряд возможностей по backup и восстановлению из него:

[![backup.PNG](https://wiki.wellink.ru/uploads/images/gallery/2024-01/backup.PNG)](https://wiki.wellink.ru/uploads/images/gallery/2024-01/SAYimage.png)

Backup HBase DB - создает backup-файл hb\_2024-01-09.tar.gz - в нем содержится информация о данных в HBase.

<p class="callout info">Restore HBase DB было переименовано в Restore HBase DB into existing tables в версии 72115</p>

<p class="callout info">Clear HBase DB tables and restore dump было переименовано в Restore HBase DB: clear and insert new tables в версии 72115</p>

Restore HBase DB: clear and insert new tables / Clear HBase DB tables and restore dump(старое название) - очищает таблицы HBase и загружает данные из указанного backup-файла

Clear HBase DB tables - Очистить HBase таблицы и не восстанавливать backup

Restore HBase DB into existing tables / Restore HBase DB(старое название) - восстанавливает данные в те же таблицы хранилища, не удаляя предыдущие данные. Этот режим нужен для восстановления из инкрементальных резервных копий, когда несколько файлов за разные периоды времени загружаются в одно хранилище.

<p class="callout warning">Если использовать "Restore HBase DB \[into existing tables\]" для разных наборов данных (например, при замене БД на alfa-test на базу заказчика), получаем испорченное хранилище и проблему запуска wiSLA. Для данных из разных источников нужно использовать режим "Restore HBase DB: clear and insert new tables": существующие таблицы будут переименованы и созданы новые, в них будут восстановлены данные.</p>

Backup Postgres DB - создает backup-файл wisla\_backup\_2024\_01\_09.backup - в нем содержится информация о данных в Postgres.

Restore Postgres DB - загружает данные из указанного backup-файла

<p class="callout warning">После успешного Restore Postgres рекомендуется выполнить пункт patch database из подменю Maintenance/Postgres</p>

Backup installation info - создает архив INSTALLER\_CONFIG\_2024\_01\_09.tar с файлами CONFIG, APPLICATIONS,TOPOLOGY из папки конфигураций /opt/wisla5/current\_version/

<p class="callout warning">Не рекомендуется изменять вручную эти параметры, так как не всегда установщик сможет их применить, особенно это касается файла TOPOLOGY - топологию можно только поменять при полной переустановки</p>

# Действия по обслуживанию wiSLA

Основные действия по обслуживанию wiSLA перечислены в таблице 4.

<span style="color: rgb(35, 111, 161);">Таблица 4 – Действия по обслуживанию системы wiSLA.</span>

<table border="1" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-%D0%A7%D1%82%D0%BE-%D1%82%D1%80%D0%B5%D0%B1%D1%83%D0%B5%D1%82%D1%81%D1%8F-%D1%81%D0%B4%D0%B5%D0%BB%D0%B0%D1%82" style="border-collapse: collapse; width: 100%; border-width: 1px; border-spacing: 0px;" width="605"><thead><tr style="mso-yfti-irow: 0; mso-yfti-firstrow: yes;"><td style="width: 35.5583%; border: 1pt solid windowtext;" width="180">**<span style="font-family: 'Arial',sans-serif;">Что требуется сделать?</span>**

</td><td style="width: 64.4729%; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-image: initial; border-left: none;" width="425">**<span style="font-family: 'Arial',sans-serif;">Последовательность действий</span>**

</td></tr></thead><tbody><tr style="mso-yfti-irow: 1;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">1\. Просмотреть информацию о статусах всех компонентов wiSLA

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">1\. Запустить программу установки wiSLA.

2\. Выбрать и открыть "Status".

3\. Выбрать "All ".

Незапущенные компоненты можно определить по наличию <span lang="EN-US" style="mso-ansi-language: EN-US;">"\[FAIL\]" </span>и<span lang="EN-US" style="mso-ansi-language: EN-US;"> "NOT STARTED" </span>в<span style="mso-ansi-language: EN-US;"> </span>строке<span lang="EN-US" style="mso-ansi-language: EN-US;">.</span>

</td></tr><tr style="mso-yfti-irow: 2;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">2\. Остановить все компоненты wiSLA с помощью программы установки

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">1\. Запустить программу установки wiSLA.

2\. В программе установки wiSLA выбрать "Maintenance" - "Stop All".

3\. Проверить результат. Посмотреть информацию по статусам всех компонентов wiSLA.

</td></tr><tr style="mso-yfti-irow: 3;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">3\. Управление запуском <span lang="EN-US" style="mso-ansi-language: EN-US;">wiSLA</span> с помощью скрипта запуска (для варианта установки всех компонентов на 1 сервер)

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">Для управления запуском следует получить доступ к консоли сервера <span lang="EN-US" style="mso-ansi-language: EN-US;">wiSLA</span>, пользователь “<span lang="EN-US" style="mso-ansi-language: EN-US;">wisla</span>".

Запуск всех компонентов:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">sudo systemctl start wisla5</span>

или

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh start</span>

Остановка всех компонентов:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">sudo systemctl stop wisla5</span>

или

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh stop</span>

Проверка статусов всех компонентов:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">sudo systemctl status wisla5</span>

или

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh status</span>

Запуск<span style="mso-ansi-language: EN-US;"> </span>только<span style="mso-ansi-language: EN-US;"> </span>сервера<span style="mso-ansi-language: EN-US;"> </span>приложений<span lang="EN-US" style="mso-ansi-language: EN-US;">:</span>

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh start-wildfly</span>

Остановка<span style="mso-ansi-language: EN-US;"> </span>только<span style="mso-ansi-language: EN-US;"> </span>сервера<span style="mso-ansi-language: EN-US;"> </span>приложений<span lang="EN-US" style="mso-ansi-language: EN-US;">:</span>

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh stop-wildfly</span>

Перезапуск<span style="mso-ansi-language: EN-US;"> </span>только<span style="mso-ansi-language: EN-US;"> </span>сервера<span style="mso-ansi-language: EN-US;"> </span>приложений<span lang="EN-US" style="mso-ansi-language: EN-US;">:</span>

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh restart-wildfly</span>

Проверка<span style="mso-ansi-language: EN-US;"> </span>состояния<span style="mso-ansi-language: EN-US;"> </span>сервера<span style="mso-ansi-language: EN-US;"> </span>приложений<span lang="EN-US" style="mso-ansi-language: EN-US;">:</span>

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">sudo /opt/wisla5/scripts/wisla5.sh status-wildfly</span>

</td></tr><tr style="mso-yfti-irow: 4;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180"><span lang="EN-US" style="mso-ansi-language: EN-US;">4</span>. Перезапустить все компоненты wiSLA

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">1\. Запустить программу установки wiSLA.

2\. В программе установки wiSLA выбрать "Maintenance" - "Stop All", дождаться завершения выполнения команды.

3\. Выбрать в меню "Start All".

4\. Дождаться полного запуска системы.

5\. Проверить статусы компонентов.

</td></tr><tr style="mso-yfti-irow: 5;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">5\. Узнать, что система полностью запущена

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">1\. Запустить программу установки.

2\. Выбрать в меню программы установки раздел**<span style="font-family: 'Arial',sans-serif;"> </span>**"Log <span lang="EN-US" style="mso-ansi-language: EN-US;">v</span>iewer" - "wiSLA” – “<span lang="EN-US" style="mso-ansi-language: EN-US;">Server</span>.log <span lang="EN-US" style="mso-ansi-language: EN-US;">at</span>..."

3\. Нажать SHIFT+F для автоматического обновления файла.

Запись<span style="mso-ansi-language: EN-US;"> </span>об<span style="mso-ansi-language: EN-US;"> </span>удачном<span style="mso-ansi-language: EN-US;"> </span>запуске<span lang="EN-US" style="mso-ansi-language: EN-US;">:</span>

<span lang="EN-US">wiSLA COMPONENTS ARE FULLY DEPLOYED, INTERCONNECTED AND READY TO WORK.</span>

4\. Завершить просмотр файла: CTRL+C, затем q.

5\. Проверить статусы всех компонентов.

</td></tr><tr style="mso-yfti-irow: 6;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180"><span lang="EN-US" style="mso-ansi-language: EN-US;">6</span>. Перезапустить сервер приложений

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">1\. Запустить программу установки wiSLA.

2\. В программе установки wiSLA выбрать "Maintenance" – “<span lang="EN-US" style="mso-ansi-language: EN-US;">wiSLA</span>” – "Stop All", дождаться завершения выполнения команды.

3\. Выбрать в меню "Start All", выполнить команду.

4\. Дождаться полного запуска системы.

5\. Проверить статус <span lang="EN-US" style="mso-ansi-language: EN-US;">wiSLA</span>.

</td></tr><tr style="mso-yfti-irow: 7;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">7\. Получить информацию о свободном месте на диске

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">В ssh-сессии выполнить команду:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">df -h</span>

</td></tr><tr style="mso-yfti-irow: 8;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">8\. Получить информацию о времени непрерывной работы сервера

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">В ssh-сессии выполнить команду:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">uptime</span>

</td></tr><tr style="mso-yfti-irow: 9;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">9\. Просмотреть журналы работы операционной системы

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">В <span lang="EN-US" style="mso-ansi-language: EN-US;">SSH</span>-сессии выполнить команду:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">less /var/log/messages</span>

</td></tr><tr style="mso-yfti-irow: 10;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">10\. Просмотреть журналы работы системы wiSLA

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">1\. Запустить программу установки.

2\. Открыть "Logs viewer".

3\. Выбрать компонент системы.

4\. Выбрать журнал для просмотра.

</td></tr><tr style="mso-yfti-irow: 11;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">11\. Проверить время и дату в операционной системе

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">В ssh-сессии выполнить команду:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">date</span>

Обратить внимание не только на год, месяц, день, часы, минуты и секунды, но и на часовой пояс.

</td></tr><tr style="mso-yfti-irow: 12;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">1<span lang="EN-US" style="mso-ansi-language: EN-US;">2</span>. Проверить работу службы NTP

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">В <span lang="EN-US" style="mso-ansi-language: EN-US;">SSH</span>-сессии выполнить команду:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">sudo systemctl status ntpd</span>

Если служба запущена, проверить доступность NTP-серверов для синхронизации и статус синхронизации:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">ntpq –npcrv</span>

</td></tr><tr style="mso-yfti-irow: 13;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">1<span lang="EN-US" style="mso-ansi-language: EN-US;">3</span>. Добавить новый плагин

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">Для добавления нового плагина требуется:

1\. Скопировать файл плагина в каталог /opt/wisla5/<span lang="EN-US" style="mso-ansi-language: EN-US;">wildfly</span>/current/wisla\_plugins/.

2\. Выдать пользователю wisla права на файл:

<span style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span style="color: black; mso-color-alt: windowtext;">chown wisla.wisla \*.jar</span>

3\. Запустить программу установки wiSLA.

4\. Перейти в меню <span lang="EN-US" style="mso-ansi-language: EN-US;">«Maintenance» - «wiSLA» </span>и<span style="mso-ansi-language: EN-US;"> </span>выполнить<span lang="EN-US" style="mso-ansi-language: EN-US;"> «Reload\_plugins».</span>

</td></tr><tr style="mso-yfti-irow: 14; mso-yfti-lastrow: yes;"><td style="width: 35.5583%; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-left: 1pt solid windowtext; border-image: initial; border-top: none;" width="180">1<span lang="EN-US" style="mso-ansi-language: EN-US;">4</span>. Загрузить модуль коллектора <span lang="EN-US" style="mso-ansi-language: EN-US;">Netflow</span>

</td><td style="width: 64.4729%; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext;" width="425">Для загрузки коллектора <span lang="EN-US" style="mso-ansi-language: EN-US;">Netflow</span> требуется:

1\. Получить в службе поддержки или найти в комплекте поставки файл модуля коллектора wisla-netflow-collector-web-5.1-SNAPSHOT.war.

<span lang="EN-US" style="mso-ansi-language: EN-US;">2. </span>Скопировать<span style="mso-ansi-language: EN-US;"> </span>файл<span style="mso-ansi-language: EN-US;"> </span>в<span style="mso-ansi-language: EN-US;"> </span>каталог

<span lang="EN-US" style="mso-ansi-language: EN-US;">/opt/wisla5/wildfly/current/standalone/deployments</span>

3\. Перезапустить сервер приложений.

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

<span lang="EN-US" style="mso-fareast-font-family: 'Courier New'; mso-bidi-font-family: 'Courier New'; mso-ansi-language: EN-US; font-weight: normal;"><span style="mso-list: Ignore;">$<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US" style="color: black; mso-color-alt: windowtext; mso-ansi-language: EN-US;">touch /opt/wisla5/wildfly/current/standalone/deployments/wisla-netflow-collector-web-5.1-SNAPSHOT.war.dodeploy</span>

После получения доступа на портал оператора потребуется добавить коллектор в качестве зонда «<span lang="EN-US" style="mso-ansi-language: EN-US;">Netflow</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">collector</span>» с <span lang="EN-US" style="mso-ansi-language: EN-US;">IP</span>-адресом 127.0.0.1 (раздел «Зонды», кнопка «+ Создать», тип «<span lang="EN-US" style="mso-ansi-language: EN-US;">Netflow</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">collector</span>»).

</td></tr></tbody></table>

# Установка wiSLA в контейнер podman

Установка wiSLA может быть произведена с помощью самораспаковывающегося архива.

Необходимо создать не root пользователя и настроить использование sudo без пароля

Необходимые действия:

1)Установить podman и zstd

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/IFOimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/IFOimage.png)

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/13zimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/13zimage.png)

2)Скачать executable tarball

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/rCjimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/rCjimage.png)

3)Задать права для исполняемого файла

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/vczimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/vczimage.png)

```bash
chmod +x podmanizedWisla.sh
```

4)Запустить

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/EsRimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/EsRimage.png)

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/I9Zimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/I9Zimage.png)

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/6eXimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/6eXimage.png)

```bash
./podmanizedWisla.sh
```

5)Будет создан и запущен podman контейнер wisla-app

Имеется возможность управлять wiSLA с помощью systemd сервиса:

Проверить статус сервиса

```bash
systemctl --user status wisla-podman
```

Запустить сервис

```bash
systemctl --user start wisla-podman
```

Остановить сервис

```bash
systemctl --user stop wisla-podman
```

Дополнительно имеется возможность управлять wiSLA с помощью скрипта **tool.sh** (устанавливается в домашнюю папку пользователя)

изменить внешний хост с портом

```bash
./tool.sh change-external-host 10.9.0.1 80 443
```

изменить адрес для подключения зонда к wisla

```bash
./tool.sh change-wiprobe-dst 10.9.0.1 80
```

запустить скрипт wisla5.sh для остановки и запуска wisla (необходимо остановить перед остановкой контейнера)

```bash
./tool.sh wisla-script start
```

открыть логи application server и дождаться следующего сообщения

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2024-05/scaled-1680-/wecimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2024-05/wecimage.png)

```bash
./tool.sh wisla-wildfly-log
```

запустить скрипт wisla5.sh для остановки и запуска wisla (необходимо остановить перед остановкой контейнера)

```bash
./tool.sh wisla-script stop
```

остановить контейнер

```bash
./tool.sh stop-container
```

запустить контейнер

```bash
./tool.sh start-container
```

# Скрипты для взаимодействия с wiSLA

## **<span style="font-family: 'Arial',sans-serif;">Поддерживаемые параметры установщика Wisla</span>**

<span style="font-family: 'Arial',sans-serif;">Чтобы узнать доступные параметры установщика Wisla, выполнить команду:</span>

```
./wisla-5.2.9-2502251017.run --help
```

<span style="font-family: 'Arial',sans-serif;">Будет следующий вывод:</span>

```
wiSLA 5.2.9 build 2502251017 installer
usage: ./wisla-5.2.9-2502251017.run <options>
This script installs the wiSLA system cluster.
OPTIONS:
    Installer options
    -h      Show this message
    -t      Text mode only
    --hadoop-install                        Install hadoop system only
    --silent-install                        Silent install
    --silent-update                         Silent update
    --silent-fast-update                    Silent update without backup stage
    --silent-fast-update-with-new-db <Postrgres DB dump path>  Silent update without backup stage with new database restoring
    --silent-fast-update-replace-db-n-hbase <Postgres DB dump path> <HBase data dump path>  Silent update without backup stage with complete data overwrite
    
    Package options
    -x      Unpack distribution from self
    -v      Display version information

ENVIRONMENT:
    INSTALL_TEMP - directory used to store temporary files. Default: /tmp/
    INSTALL_LOG  - installation log name. Default: install.YYYY-MM-dd_HH:mm:ss.log
    EXTERNAL_DISTRIBUTION_FILE - used to specify external distribution file
    SCENARIO - used to switch default scenario

```

## **<span style="font-family: 'Arial',sans-serif;">Варианты обновления системы</span>**

<span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">1. Установка wisla с нуля </span>**</span>

<span style="font-family: 'Arial',sans-serif;">Убедиться что в системе отсутствуют установленные ранее папки : hadoop, postgresql, zookeeper, hbase. Иначе будет полуавтоматический режим установки, где необходимо будет подтверждать очистку каталогов, а при попытке нажать No процесс установки будет прерван.</span>

```
./wisla-5.2.9-xxxxxxxx.run --silent-install
```

<span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">2. Стандартное обновление (с резервным копированием)</span>**</span>

```
./wisla-5.2.9-xxxxxxxx.run --silent-update
```

<span style="font-family: 'Arial',sans-serif;">Этот режим выполняет обновление системы с сохранением резервных копий данных.</span>

<span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">3. Быстрое обновление без резервного копирования</span>**</span>

```
./wisla-5.2.9-xxxxxxxx.run --silent-fast-update
```

<span style="font-family: 'Arial',sans-serif;">Этот режим пропускает этап создания резервных копий, ускоряя процесс обновления.</span>

<span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">4. Быстрое обновление с восстановлением новой базы данных PostgreSQL</span>**</span>

```
./wisla-5.2.9-xxxxxxxx.run --silent-fast-update-with-new-db /path/to/postgres_dump.sql
```

<span style="font-family: 'Arial',sans-serif;">Здесь </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif;">/path/to/postgres_dump.sql</span>`<span style="font-family: 'Arial',sans-serif;"> — путь к файлу дампа PostgreSQL, который будет использован для восстановления данных.</span>

<span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">5. Полная замена базы данных и HBase</span>**</span>

```
./wisla-5.2.9-xxxxxxxx.run --silent-fast-update-replace-db-n-hbase /path/to/postgres_dump.sql /path/to/hbase_data
```

<span style="font-family: 'Arial',sans-serif;">Где:</span>

- `<span lang="EN-US" style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-US;">/path/to/postgres_dump.sql</span>`<span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> — </span><span style="font-family: 'Arial',sans-serif;">путь</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">к</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">дампу</span><span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> PostgreSQL.</span>
- `<span lang="EN-US" style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-US;">/path/to/hbase_data</span>`<span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> — </span><span style="font-family: 'Arial',sans-serif;">путь</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">к</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">данным</span><span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> HBase</span>**<span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;">.</span>**

<span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">6. Установка только Hadoop</span>**</span>

```
./wisla-5.2.9-xxxxxxxx.run --hadoop-install
```

## **<span style="font-family: 'Arial',sans-serif;">Дополнительно:</span>**

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Просмотр логов</span>**</span>

<span style="font-family: 'Arial',sans-serif;">По умолчанию логи установки сохраняются в файл </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif;">install.YYYY-MM-dd_HH:mm:ss.log</span>`<span style="font-family: 'Arial',sans-serif;">. Изменить имя лога можно так:</span>

```
export INSTALL_LOG=my_install_log.txt
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Изменение временной директории</span>**</span>

```
export INSTALL_TEMP=/custom/temp/dir
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Режим текстового интерфейса</span>**</span>

```
./wisla-5.2.9-xxxxxxxx.run -t
```

##  

## **<span style="font-family: 'Arial',sans-serif;">Управление всеми сервисами Wisla</span>**

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Проверка статуса запущенных сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla5.sh status
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Остановка всех сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla5.sh stop
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Запуск всех сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla5.sh start
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Перезапуск</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">всех сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla5.sh restart
```

##  

## **<span style="font-family: 'Arial',sans-serif;">Управление только сервисом Wisla</span>**

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Проверка статуса запущенных сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla.sh status
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Остановка всех сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla.sh stop
```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Запуск всех сервисов</span>**</span>

```
/opt/wisla5/scripts/wisla.sh start
```

- **<span style="font-family: 'Arial',sans-serif;">Перезапуск</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">сервиса</span><span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> Wisla</span>**

```
/opt/wisla5/scripts/wisla.sh restart
```

Скрипт:

```bash
#!/bin/bash

# Source function library.
WILDFLY_WORK=/opt/wisla5/wildfly/current
wildfly_pid_calc=$(pgrep -u wisla -f "jboss.home.dir=${WILDFLY_WORK}" | wc -l)

keyphrase_blank_wildfly_started="WildFly .* started in"

function start_blank_wildfly() {
	# анализ log-файла
	[ -r $WILDFLY_WORK/standalone/log/server.log ] && basic_blank_wildfly_started_counter=$(egrep -c "keyphrase_blank_wildfly_started" $WILDFLY_WORK/standalone/log/server.log)
	[ -z "basic_blank_wildfly_started_counter" ] && basic_blank_wildfly_started_counter=0
	# запуск пустого Wildfly
	cd $WILDFLY_WORK/bin
	nohup ./standalone.sh > /dev/null 2>&1&
}

function start_deploy() {
	cd $WILDFLY_WORK/standalone/deployments
	for file in *.?ar;
	do
		touch "$file".dodeploy
	done
}

function wait_for_blank_wildfly() {
    timeout=300
    blank_wildfly_counter_started=0
    blank_wildfly_current_counter_started=0
    if [ ! -e "$WILDFLY_WORK/standalone/log/server.log" ] ; then
        touch "$WILDFLY_WORK/standalone/log/server.log"
    fi
    basic_blank_wildfly_started_counter=$(egrep -c "$keyphrase_blank_wildfly_started" $WILDFLY_WORK/standalone/log/server.log)
    for i in $(seq 1 $timeout);
    do
	blank_wildfly_started_counter=$(egrep -c "$keyphrase_blank_wildfly_started" $WILDFLY_WORK/standalone/log/server.log)
	((total_wildfly_start_time = total_wildfly_start_time + 1))
	if [ $blank_wildfly_started_counter -eq $((basic_blank_wildfly_started_counter+1)) ]
	then
	    echo "Starting blank Wildfly..."
	    return
	fi
    sleep 1
    done
    echo "Error during blank Wildfly start!"
}

function start() {
	wildfly_pid_calc=$(pgrep -u wisla -f "jboss.home.dir=${WILDFLY_WORK}" | wc -l)
	if [ "$wildfly_pid_calc" -eq 0 ]
	then
		total_wildfly_start_time=0
		# очистка каталогов deployments (кроме war, ear) и tmp перед запуском
		find $WILDFLY_WORK/standalone/deployments -regextype posix-egrep ! -regex ".*(ear|war)" -type f -exec rm -f {} \;
		rm -rf $WILDFLY_WORK/standalone/tmp/*
		rm -rf /tmp/workspace_*-*-*-*-*
		cd $WILDFLY_WORK/standalone
		# запуск пустого wildfly
		echo "Waiting for the blank Wildfly application server to start (up to 5 minutes)... "
		start_blank_wildfly
		# ожидание запуска пустого Wildfly
		wait_for_blank_wildfly
		# начало деплоя артефактов (в порядке, выбранном Wildfly)
		start_deploy
	else
        echo "Error. Wildfly is already running!"
		return 1
	fi
}


function stop() {
    echo "wiSLA is stopping..."
    kill `pgrep -f "jboss.home.dir=${WILDFLY_WORK}"` &> /dev/null
    ATTEMPTS=0
    while [[ ! -z `pgrep -f "jboss.home.dir=${WILDFLY_WORK}"` ]]; do
        echo "Waiting for the Wildfly application server to stop..."
        (( ATTEMPTS = ATTEMPTS + 1 ))
        if [ $ATTEMPTS -gt 10 ]
            then
            echo "60 seconds is elapsed, trying to stop the process with -9 signal"
            kill -9 `pgrep -f "jboss.home.dir=${WILDFLY_WORK}"`
        fi
        sleep 5
    done
}

function status() {
    PID=`pgrep -f "jboss.home.dir=${WILDFLY_WORK}"`
    [[ ! -z $PID ]] && echo "Started with PID : $PID" || echo "Stopped"
}

case "$1" in
    start)
        start
        ;;
    stop)
        stop
        ;;
    restart)
        stop
        start
        ;;
    try-restart)
        stop
        start
        ;;
    status)
        status
        ;;
    *) exit 1
esac

exit 0

```

##  

## **<span style="font-family: 'Arial',sans-serif;">Реиндексация</span>**

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Стандартная реиндексация (требует запущенной системы)</span>**</span>

```
/opt/wisla5/scripts/wi-reindex.sh
```

Скрипт:

```bash
#!/bin/bash
# Source function library.
JRE_WORK="/opt/wisla5/jre/current"

echo "Reindexing wisla engine lucene database..."
${JRE_WORK}/bin/java -jar /opt/wisla5/util/jmx/cmdline-jmxclient-0.10.3.jar - localhost:1090 "wisla-engine:name=nodeReindexer" reindexFullTextSearch

exit 0

```

###  

- **<span style="font-family: 'Arial',sans-serif;">Независимая реиндексация (не зависит от состояния деплоя)</span>**

```
/opt/wisla5/scripts/wi-reindex-standalone.sh
```

Скрипт:

```bash
#!/bin/bash
# Source function library.
JRE_WORK="/opt/wisla5/jre/current"
POSTGRES_HOST="alfa-test"
DB_NAME="wisla"
USER="wisla"

echo "Reindexing database"
${JRE_WORK}/bin/java -jar -Dhibernate.connection.username="${USER}" \
-Dhibernate.search.base_indexes_directory="/opt/wisla5/wildfly/current/bin/searchindexes/engine/" \
-Dhibernate.connection.url="jdbc:postgresql://${POSTGRES_HOST}:5462/${DB_NAME}" \
-Dcom.sun.xml.bind.v2.bytecode.ClassTailor.noOptimize=true \
/opt/wisla5/util/reindexer/wisla-reindexer.jar
echo "Reindex finished"
exit 0

```

##  

## **<span style="font-family: 'Arial',sans-serif;">Создание резервных копий баз данных</span>**

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">PostgreSQL</span>**</span>

<span style="font-family: 'Arial',sans-serif;">Файл</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">шаблона</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">скрипта</span><span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;">: </span>`<span lang="EN-US" style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;">/opt/wisla5/backup_scripts/postgres_backup_template.sh</span>`

<span style="font-family: 'Arial',sans-serif;">Пример</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">запуска</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">резервного</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">копирования</span><span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;">:</span>

```
pg_dump --host "wisla" --port 5432 --username "wisla" --format custom --blobs --no-owner --encoding UTF8 --verbose --file /home/wisla/backup/wisla.backup
```

<span style="font-family: 'Arial',sans-serif;">Альтернативный способ через шаблонный скрипт:</span>

```
sed "s|{{FILE-NAME}}|/home/wisla/backup/wisla.backup|" /opt/wisla5/backup_scripts/postgres_backup_template.sh | bash
```

Скрипт:

```bash
#!/bin/bash
pg_dump --host "alfa-test" --port 5432 --username "wisla" --format custom --blobs --no-owner --encoding UTF8 --verbose --file {{FILE-NAME}} wisla
ssh {{LOGIN}}@{{BACKUP-SERVER}} "mkdir -p {{DESTINATION}}"
scp ./{{FILE-NAME}} {{LOGIN}}@{{BACKUP-SERVER}}:{{DESTINATION}}
rm -f ./{{FILE-NAME}}
```

###   


- <span style="color: rgb(0, 0, 0);">**<span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;">HBase</span>**</span>

<span lang="EN-US" style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"><span style="font-family: 'Arial',sans-serif;">Файл</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">шаблона</span><span style="font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;"> </span><span style="font-family: 'Arial',sans-serif;">скрипта</span>: `<span lang="EN-US" style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-ansi-language: EN-US;">/opt/wisla5/backup_scripts/<span lang="EN-US" style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">hbase</span><span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">_</span><span lang="EN-US" style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">backup</span><span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">_</span><span lang="EN-US" style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">template</span><span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">.</span><span lang="EN-US" style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">sh</span></span>`</span><span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif;">, но корректность работы проверить не удалось, пробовал<span style="mso-spacerun: yes;"> </span>переписать скрипт, но возникает проблема при выполнении команды импорта снимков в папку.</span>

```bash
#!/bin/bash

BACKUP_DIR=$(mktemp -d -t -p ~/ hbase_backup.XXXXXXXX)
mkdir ${BACKUP_DIR}/backup
BACKUP_PARRENT_DIR=${BACKUP_DIR}
BACKUP_DIR=${BACKUP_DIR}/backup

hbase org.apache.hadoop.hbase.mapreduce.Export -D mapred.output.compress=true {{TABLE-PREFIX}}-tsdb {{TABLE-PREFIX}}-tsdb-backup 1 {{START-TIMESTAMP}} {{END-TIMESTAMP}}
hbase org.apache.hadoop.hbase.mapreduce.Export -D mapred.output.compress=true {{TABLE-PREFIX}}-tsdb-uid {{TABLE-PREFIX}}-tsdb-uid-backup 1 {{START-TIMESTAMP}} {{END-TIMESTAMP}}
hbase org.apache.hadoop.hbase.mapreduce.Export -D mapred.output.compress=true {{TABLE-PREFIX}}-tsdb-nf {{TABLE-PREFIX}}-tsdb-nf-backup 1 {{START-TIMESTAMP}} {{END-TIMESTAMP}}
hbase org.apache.hadoop.hbase.mapreduce.Export -D mapred.output.compress=true {{TABLE-PREFIX}}-tsdb-uid-nf {{TABLE-PREFIX}}-tsdb-uid-nf-backup 1 {{START-TIMESTAMP}} {{END-TIMESTAMP}}
hbase org.apache.hadoop.hbase.mapreduce.Export -D mapred.output.compress=true {{TABLE-PREFIX}}-tsdb-lts {{TABLE-PREFIX}}-tsdb-lts-backup 1 {{START-TIMESTAMP}} {{END-TIMESTAMP}}

hdfs dfs -copyToLocal /user/wisla/{{TABLE-PREFIX}}-tsdb-backup ${BACKUP_DIR}/{{TABLE-PREFIX}}-tsdb
hdfs dfs -copyToLocal /user/wisla/{{TABLE-PREFIX}}-tsdb-uid-backup ${BACKUP_DIR}/{{TABLE-PREFIX}}-tsdb-uid
hdfs dfs -copyToLocal /user/wisla/{{TABLE-PREFIX}}-tsdb-nf-backup ${BACKUP_DIR}/{{TABLE-PREFIX}}-tsdb-nf
hdfs dfs -copyToLocal /user/wisla/{{TABLE-PREFIX}}-tsdb-uid-nf-backup ${BACKUP_DIR}/{{TABLE-PREFIX}}-tsdb-uid-nf
hdfs dfs -copyToLocal /user/wisla/{{TABLE-PREFIX}}-tsdb-lts-backup ${BACKUP_DIR}/{{TABLE-PREFIX}}-tsdb-lts

cd ${BACKUP_DIR}/..
tar -czvf {{FILE-NAME}} backup
hdfs dfs -rm -r /user/wisla/{{TABLE-PREFIX}}-tsdb-backup
hdfs dfs -rm -r /user/wisla/{{TABLE-PREFIX}}-tsdb-uid-backup
hdfs dfs -rm -r /user/wisla/{{TABLE-PREFIX}}-tsdb-nf-backup
hdfs dfs -rm -r /user/wisla/{{TABLE-PREFIX}}-tsdb-uid-nf-backup
hdfs dfs -rm -r /user/wisla/{{TABLE-PREFIX}}-tsdb-lts-backup

ssh {{LOGIN}}@{{BACKUP-SERVER}} "mkdir -p {{DESTINATION}}"
scp ./{{FILE-NAME}} {{LOGIN}}@{{BACKUP-SERVER}}:{{DESTINATION}}

rm -f ./{{FILE-NAME}}
cd ../
rm -r ${BACKUP_PARRENT_DIR}

```

<span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif;">**!!!Но для выполнения скрипта надо настраивать hbase и hadoop**</span>

<span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif;">  
</span>

### **<span style="font-family: 'Arial',sans-serif;">Дополнительно:</span>**

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Перезагрузка плагинов в приложении wiSLA</span>**</span>

```
/opt/wisla5/scripts/reload-plugins.sh
```

Скрипт:

```bash
#!/bin/bash
# Source function library.
JRE_WORK=/opt/wisla5/jre/current

${JRE_WORK}/bin/java -jar /opt/wisla5/util/jmx/cmdline-jmxclient-0.10.3.jar - localhost:1090 "wisla-engine:name=pluginManager" reloadPlugins

exit 0

```

- <span style="color: rgb(0, 0, 0);">**<span style="font-family: 'Arial',sans-serif;">Удаление старых лог файлов</span>**</span>

```
/opt/wisla5/scripts/remove-old-logs.sh
```

Скрипт:

```bash
#!/bin/bash
DAYS=10
LOG_DIR=/opt/wisla5/wildfly/current/standalone/log
for file in "$( find ${LOG_DIR}/ -maxdepth 1 -type f -mtime +${DAYS} )"
do
    rm -f ${file}
done

```

###  

<span style="font-size: 10.0pt; line-height: 107%; font-family: 'Arial',sans-serif;">  
</span>

# Инструкция по полуавтоматическому обновлению wiSLA (alfa-test)

#### <span style="font-family: 'Arial',sans-serif;">1. Подготовка к обновлению</span>

<span style="font-family: 'Arial',sans-serif;">**1.1 -** Альфа запущена (либо остановлена)</span>

<span style="font-family: 'Arial',sans-serif;">**1.2 -** Для структурирования папок, необходимо проверить наличие актуальной папки общей версии в каталоге </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">/home/wisla/wisla_distr</span>`<span style="font-family: 'Arial',sans-serif;"> (например, </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">5210</span>`<span style="font-family: 'Arial',sans-serif;">).</span>

<span style="font-family: 'Arial',sans-serif;">**1.3 -** Если папки нет, создать новую, иначе перейти в существующую (</span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">/home/wisla/wisla_distr/5210</span>`<span style="font-family: 'Arial',sans-serif;">).</span>

[ ![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-03/scaled-1680-/eF8image.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-03/eF8image.png)

<span style="font-family: 'Arial',sans-serif;">**1.4 -** Внутри создать папку с наименованием версии дистрибутива wisla (</span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">/home/wisla/wisla_distr/5210/2503121748</span>`<span style="font-family: 'Arial',sans-serif;">). Возможен вариант создания по порядку (1,2,3...), учитывая пропуски.</span>

 [![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-03/scaled-1680-/YO4image.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-03/YO4image.png)

<span style="font-family: 'Arial',sans-serif;">**1.5 -** Если в каталоге </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">/home/wisla/wisla_distr/5210/</span>`<span style="font-family: 'Arial',sans-serif;"> больше 15 папок, удалить старые до 7 штук (можно вручную).</span><span style="font-family: 'Arial',sans-serif;">(Для этого написан скрипт, если количество папок накопилось от 15 шт, то удалять ранее созданные папки, фильтруя по дате изменений, оставляя только 7 последних обновленных)</span>

```bash
#!/bin/bash

# Перейти в каталог /home/wisla/529/111
cd /home/wisla/529/111

# Получить количество папок в каталоге
folder_count=$(find . -maxdepth 1 -type d | wc -l)

# Если количество папок больше 15, удалить старые 8 папок
if [ $folder_count -gt 15 ]; then
    old_folders=$(ls -dt */ | tail -n +8)
    echo "$old_folders" | xargs rm -rf
    remaining_folders=$(ls -dt */ | head -n 7)
    echo "Оставлены следующие папки:"
    echo "$remaining_folders"
fi

```

<span style="font-family: 'Arial',sans-serif;">**1.6 -** В созданную папку, с наименованием версии, загрузить актуальную версию дистрибутива (например, </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin;">wisla-5.2.10-2503121748.run</span>`<span style="font-family: 'Arial',sans-serif;">). Перейти в данную папку.</span>

 [![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-03/scaled-1680-/wbFimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-03/wbFimage.png)

<span style="font-family: 'Arial',sans-serif;">Проверить процесс загрузки файла по наименованию файла, об этом сигнализирует изменение имени </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif;">wisla-5.2.10-2503121748.run.filepart</span>`<span style="font-family: 'Arial',sans-serif;"> на </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif;">wisla-5.2.10-2503121748.run</span>`<span style="font-family: 'Arial',sans-serif;">).</span>

<span style="font-family: 'Arial',sans-serif;">**1.7 -** </span>Далее дать разрешение на запуск файла, выполнив команду:

```
chmod +x wisla-5.2.10-2503121748.run
```


#### <span style="font-family: 'Arial',sans-serif;">2. Запуск обновления</span>

**<span style="font-family: 'Arial',sans-serif;">1. Запустить автоматическое обновление:</span>**

```
./wisla-5.2.10-2503121748.run --silent-update
```

<span style="font-size: 11.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">Обновление включает формирование дампов PostgreSQL, HBase и конфигурационных файлов. Перед окончанием выполнения скрипта обновления, система выполнит реиндекс, в консоли будет соответствующее сообщение </span> **«Reindexing wisla engine lucene database..».**

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-03/scaled-1680-/JN5image.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-03/JN5image.png)

<span style="font-size: 11.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">После выполнения всех сценариев закроет установщик, перейдет в командную строку.</span>

<span style="font-size: 11.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">В каталоге ожидается наличие всех дампов:</span>

[![image.png](https://wiki.wellink.ru/uploads/images/gallery/2025-03/scaled-1680-/Q2Bimage.png)](https://wiki.wellink.ru/uploads/images/gallery/2025-03/Q2Bimage.png)

**<span style="font-size: 11.0pt; font-family: 'Arial',sans-serif; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;"> 2. </span><span style="font-family: 'Arial',sans-serif;">Проверить статус обновления возможно выполнив API-запрос:</span>**

```
GET https://alfa-test.wellink.ru/engine/api/v1/system/state
```

**<span style="font-family: 'Arial',sans-serif;">Обновление завершено, когда:</span>**

<span style="font-family: 'Arial',sans-serif;">1) статус сменится с </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif;">404</span>`<span style="font-family: 'Arial',sans-serif;"> на </span>`<span style="font-size: 10.0pt; font-family: 'Arial',sans-serif;">200 </span>`,

2\) в server.log будет строка указывающая что реиндекс завершен:

```
INFO  [com.wellink.wisla.core.model.NodeReindexerImpl] (RMI TCP Connection(2)-10.11.11.20) slaOpFullTextReindexer reindex procedure complete.
```

3\) в install....log завершение строкой:

```
Update complete!
```

**Ссылки на дополнительную документацию:**

**-** [Ручная установка и обновление wisla](https://wiki.wellink.ru/books/rukovodstvo-administratora-wisla-5/page/podgotovka-sistemy-ustanovka-i-obnovlenie-wisla-rucnaia#bkmrk-%D0%95%D1%81%D0%BB%D0%B8-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D1%89%D0%B8%D0%BA-%D0%BD%D0%B5-%D0%B7:~:text=9C%25D0%25AB-,%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B,-%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%2D%D0%B0%D0%BF%D0%BF%D0%B0%D1%80%D0%B0%D1%82%D0%BD%D1%8B%D0%B5%20%D1%82%D1%80%D0%B5%D0%B1%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)

\- [Скрипты для взаимодействия с wiSLA](https://wiki.wellink.ru/books/rukovodstvo-administratora-wisla-5/page/skripty-dlia-vzaimodeistviia-s-wisla)