
<note tip>Рекомендуется перед переходом на каждую версию делать полный snapshot сервера, и backup security server.</note>

<note tip>Рекомендуется перед обновление удалить все неиспользуемые сертификаты с RuToken!</note>

====== Пошаговая инструкция по обновлению сервера безопасности с версии 6.21.1 до версии 6.26.3 на Ubuntu 18.04======

===== 1 Введение  =====

Целевой аудиторией руководства по установке являются <color #ed1c24>системные администраторы</color> серверов безопасности Тундук ответственные за установку и сопровождение программного обеспечения X-Road.  
<color #ed1c24>
Документ предназначен для читателей со знаниями администрирования Linux серверов и компьютерных сетей.</color>
 
===== 2 Подготовка =====
==== 2.1 Поддерживаемые платформы ====
Сервер Безопасности работает под управлением операционной системы Ubuntu Server 18.04 Long-Term Support (LTS) на 64 разрядной платформе. Дистрибутив Сервера Безопасности распространяется в пакетах формата .deb через официальное хранилище которое расположено по адресу https://deb.tunduk.kg 
Программное обеспечение может быть развернуто как на физическом, так и на виртуализированном оборудовании.

===== 3 Обновление =====

====Как обновиться с версии 6.21.1 на 6.23.0====

<note tip>Полагается что команды будут выполнены под пользователем root.</note>

Импортировать GPG ключ репозитория
<code>
$ sudo wget -qO - https://deb.tunduk.kg/key.pub | apt-key add - 
</code>
Удалить репозиторий https://deb.tunduk.kg/ubuntu18.0 из файла /etc/apt/sources.list.d/xroad.list
<code>
$ sudo rm /etc/apt/sources.list.d/xroad.list
</code>
Добавить репозиторий в список источников пакетов ОС
<code>
$ echo "deb https://deb.tunduk.kg/ubuntu18.04-6.23.0 /" | sudo tee -a /etc/apt/sources.list.d/xroad.list
</code>
Произвести обновление обновление системы
<code>
$ sudo apt update && apt full-upgrade
</code>

Установка выполнена успешно, если запущены системные службы и пользовательский интерфейс отвечает. чтобы убедится что сервисы X-Road находятся в запущенном состоянии:
<code>
$ sudo systemctl list-units "xroad*"
$ dpkg -l | grep "xroad"
</code>

<note tip>При обновлении системы рекомендуется модифицировать конфигурационные файлы.</note>

{{ :1.jpg |}} 

{{ :2.jpg |}}

{{ :3.jpg |}}

====Как обновить Сервер Безопасности с версии 6.23.0 до версии 6.25.2====

Удалить репозиторий https://deb.tunduk.kg/ubuntu18.0-6.23.0 из файла /etc/apt/sources.list.d/xroad.list
<code>
$ sudo rm /etc/apt/sources.list.d/xroad.list
</code>
Добавить репозиторий в список источников пакетов ОС
<code>
$ echo "deb https://deb.tunduk.kg/ubuntu18.04-6.25.2 /" | sudo tee -a /etc/apt/sources.list.d/xroad.list
</code>
Произвести обновление обновление системы
<code>
$ sudo apt update && apt full-upgrade
</code>

<note tip>При обновлении системы рекомендуется модифицировать конфигурационные файлы.</note>

{{ :4.jpg |}}

{{ :5.jpg |}}

{{ :6.jpg |}}

{{ :7.jpg |}}

<note warning>
В Ubuntu 18.04 LTS для обновления Security Server с версии 6.23.0 до версии 6.25.2 требуются команды полного обновления apt. 
Выполнение apt upgrade недостаточно при обновлении с версии 6.23.0 до версии 6.25.2, так как команда не удаляет пакеты xroad-jetty и xroad-nginx, 
которые удаляются при обновлении.</note>

Далее необходимо удалить пакеты xroad-nginx and xroad-jetty9
<code>
$ sudo apt purge xroad-jetty9 xroad-nginx
$ sudo apt autoremove
$ sudo systemctl reset-failed
</code>

Установка выполнена успешно, если запущены системные службы и пользовательский интерфейс отвечает. чтобы убедится что сервисы X-Road находятся в запущенном состоянии:
<code>
$ sudo systemctl list-units "xroad*"
$ dpkg -l | grep "xroad"
</code>

<note important>
Переходя в браузер, в адресной строке не должно быть лишних символов, только https://your_ip_address:4000</note>


====Как обновить Сервер Безопасности с версии 6.25.2 до версии 6.26.3====

Удалить репозиторий https://deb.tunduk.kg/ubuntu18.0-6.25.2 из файла /etc/apt/sources.list.d/xroad.list
<code>
$ sudo rm /etc/apt/sources.list.d/xroad.list
</code>
Добавить репозиторий в список источников пакетов ОС
<code>
$ echo "deb https://deb.tunduk.kg/ubuntu18.04-6.26.3 /" | sudo tee -a /etc/apt/sources.list.d/xroad.list
</code>
Произвести обновление обновление системы
<code>
$ sudo apt update && apt full-upgrade
</code>

Установка выполнена успешно, если запущены системные службы и пользовательский интерфейс отвечает. чтобы убедится что сервисы X-Road находятся в запущенном состоянии:
<code>
$ sudo systemctl reset-failed 
$ sudo systemctl list-units "xroad*"
$ dpkg -l | grep "xroad"
</code>

<note tip>Следующий шаг - [[обновление_сервера_безопасности_убунту2004|Обновление Security Server Ubuntu 18.04 до 20.04 на месте]]</note>

<note warning>Перед обновлением Ubuntu18.04 на Ubuntu20.04 настоятельно рекомендуется снять snapshot сервера, и backup версии 6.26.3!</note>

----

Автор Даниил Горбенко, Евгений Порядин, Тоомас Мёльдер, Ян Райк