Обновление#

Изменения в системных требованиях#

Изменения в системных требованиях отсутствуют.

Изменения в параметрах настройки#

Изменения в параметрах настройки отсутствуют.

Сценарий обновления СПО SOWA#

Шаги обновления#

Администраторам СПО требуется загрузить новую версию дистрибутива из доверенного источника.

Внимание! Обновление СПО необходимо производить под пользователем sowaspo.

В случае обновления SOWA с версии меньше 4.0.0 на версию 4.0.0 или выше необходимо произвести обновление в соответствии с подразделом [«Особенности обновления СПО SOWA при переходе с версии меньше 4.0.0 на версию 4.0.0 или выше»](#Особенности обновления СПО SOWA при переходе с версии меньше 4.0.0 на версию 4.0.0 или выше).

Для обновления СПО SOWA необходимо выполнить следующие шаги:

  1. Остановить все запущенные профили, используя команду:

    sowa-config --stopall

  2. Удалить уже установленный дистрибутив. Процесс удаления подробно описан в разделе «Удаление СПО SOWA».

  3. Установить новый дистрибутив, используя инструкцию, приведенную в разделе «Установка SOWA».

  4. Переконфигурировать профили.

  5. Запустить остановленные ранее профили.

    sowa-config --runall

Обновление СПО SOWA завершено.

Особенности обновления СПО SOWA с версии меньше 4.0.0 на версию 4.0.0 или выше#

В рамках релиза 4.0.0 был осуществлен переход с java версии 1.8 на java версии 17.

В инсталляционных скриптах происходит установка rpm java 17, но переключить используемую версию необходимо самостоятельно после установки основного дистрибутива SOWA и до переконфигурирования профилей (рекомендуется до установки плагина ГОСТ proxy), например, с помощью команд:

j_name=ls /usr/lib/jvm/ | grep java-17.*.x86_64
j_path="/usr/lib/jvm/${j_name}/bin/java"
sudo update-alternatives —set java ${j_path}
jc_path="/usr/lib/jvm/${j_name}/bin/javac"
sudo update-alternatives —set javac ${jc_path}

Предупреждение

В некоторых версиях ОС (например, rhel 7.9) rpm пакет java-17-openjdk называется java-latest-openjdk, поэтому в примере ищется путь до java17 и именно он используется в команде update-alternatives.

Для обновления СПО SOWA с версии меньше 4.0.0 на версию 4.0.0 или выше в случае, если не используется плагин GOST Proxy, необходимо выполнить следующие шаги:

  1. Остановить все запущенные профили, используя команду:

    sowa-config --stopall

  2. Удалить уже установленный дистрибутив. Процесс удаления подробно описан в разделе «Удаление СПО SOWA».

  3. Установить новый дистрибутив, используя инструкцию, приведенную в разделе «Установка SOWA».

  4. Переключить используемую версию java, например, с помощью команды

    update-alternatives

  5. Переконфигурировать профили.

  6. Запустить остановленные ранее профили.

    sowa-config --runall

Обновление СПО SOWA завершено.

Особенности обновления СПО SOWA с версии меньше 5.2.0 на версию 5.2.0#

В рамках релиза SOWA версии 5.2.0 был произведен рефакторинг прав прикладных пользователей. Для корректной работы уже существующих профилей после обновления СПО требуется выполнить следующий скрипт адаптации привилегированным пользователем:

for prof in `ls /sowa | grep -vE "^owned-distrib$|^party-distrib$|^distrib$"`; do find /sowa/$prof ! -type l -exec chown sowacfg:sowacfg {} \;; done
for prof in `ls /sowa | grep -vE "^owned-distrib$|^party-distrib$|^distrib$"`; do find /sowa/$prof -type l -exec chown -h sowacfg:sowacfg {} \;; done
for prof in `ls /sowarun`; do find /sowarun/$prof -type d -exec chown sowacfg:sowacfg {} \;; done && rm -rf /sowarun/.*.lock
for prof in `ls /sowalogs`; do find /sowalogs/$prof -type d -exec chown sowacfg:sowacfg {} \;; done
for prof in `sowa-config --show-profiles|grep -v 'Profiles:'|sed 's/,.*//'`; do sowa-config --prepare $prof; chown -R sowacfg:sowacfg /mnt/profiles/sowa-storage-$prof; sowa-config --prepare $prof; done

Особенности обновления GOST Proxy плагина и библиотек КриптоПро#

Если уже используется GOST Proxy плагин, то предстоит миграция на новую версию КриптоПро. В процессе обновления КриптоПро рекомендуется также рассмотреть возможность перехода на реализацию GOST SSPI. У данной реализации выше скорость работы, а также она позволяет без java настраивать GOST TLS на уровне http_proxy и main_proxy. Подробное описание использования GOST SSPI приведено в разделе «Установка и настройка компонентов для использования GOST SSPI», а так же в описании sspi_ директив соответствующих сервисов.

В рамках обновления СПО SOWA на версию 4.0.0 или выше при использовании GOST Proxy плагина необходимо также обновить и перенастроить компоненты КриптоПро. Это обусловлено тем, что компоненты КриптоПро имеют различные версии для java версии меньше 10 и java версии 10 и выше (с постфиксом -A в версии).

Основные отличия обновленной версии компонентов КриптоПро:

  • Переход от инсталляции java компонентов КриптоПро в JAVA, к подключению их в ClassPath.

    В JCP отсутствует скрипт setup-console.sh, в JCSP в рамках setup-console.sh устанавливаются только нативные компоненты.

    Изменился порядок вызова классов утилит КриптоПро, необходимо добавлять параметр -p <path_to_jcp|jcsp_libs>.

  • Переход от systemprefs к userprefs

    Изменился порядок вызова классов утилит КриптоПро, необходимо добавлять параметр -Djava.util.prefs.userRoot=/sowarun.

    Например, если раньше вызов команды проверки лицензии JCSP выглядел так:

     java -Djava.util.prefs.systemRoot=/sowarun/.java ru.CryptoPro.JCSP.JCSPLicense

    Теперь будет выглядеть так:

    java -cp <path_to_jscp_folder>/*:<path_to_jscp_folder>/dependencies/* -Djava.util.prefs.systemRoot=/sowarun/.java -Djava.util.prefs.userRoot=/sowarun ru.CryptoPro.JCSP.JCSPLicense

  • Добавилась возможность регистрации провайдеров на уровне приложения.

    Если раньше в рамках инсталляции КриптоПро вносились изменения в java.security для регистрации провайдеров, то сейчас регистрация происходит на уровне плагина GOST proxy, java.security не требует редактирования.

Основные отличия обновленной версии плагина GOST Proxy:

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

  • –GOSTProviderPath - путь к папке с java компонентами КриптоПро;

  • –GOSTProviderType - тип провайдера. Допустимые значения - JCP|JCSP.

Пример вызова скрипта инсталляции плагина GOST Proxy:

cd owned-distrib/bin/altlinux
sudo im-sowa ./installPlugin.sh -i -f "GOST Proxy"  --GOSTProviderPath /sowa/jcp-2.0.41940-A --GOSTProviderType JCP

Предупреждение

Указание провайдера КриптоПро происходит в момент инсталляции плагина GOST Proxy, поэтому в профиле SOWA на уровне сервиса GOST параметр provider стал depricated.

Для обновления СПО SOWA с версии меньше 4.0.0 на версию 4.0.0 или выше в случае, если используется плагин GOST Proxy, необходимо выполнить следующие шаги:

  1. Остановить все запущенные профили, используя команду:

    sowa-config --stopall

  2. Удалить уже установленный дистрибутив. Процесс удаления подробно описан в разделе «Удаление СПО SOWA».

  3. Установить новый дистрибутив, используя инструкцию, приведенную в разделе «Установка SOWA». Не устанавливать плагин GOST Proxy на этом шаге!

  4. Переключить используемую версию java, например, с помощью команды

    update-alternatives

  5. Установить компоненты КриптоПро и плагин GOST Proxy согласно инструкции «Установка плагина GOST Proxy и компонентов КриптоПро».

  6. Переконфигурировать профили.

  7. Запустить остановленные ранее профили.

    sowa-config --runall

Обновление СПО SOWA завершено.

Проверка обновления#

Для проверки обновления необходимо переконфигурировать и перезапустить профиль.

Сценарий обновления ППО#

Шаги обновления#

Если профиль, для которого требуется обновить конфигурацию, запущен, то нужно произвести остановку профиля.

sowa-config --stop <profile_name>

Если ресурсы для нового конфигурационного файла менялись, следует скопировать новые ресурсы в ресурсный каталог, в соответствующие подкаталоги.

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

sowa-config --config path_to_new_file_<profile_name>.yml

Запуск профиля:

sowa-config --run <profile_name>

Для проверки того, запущен ли профиль, необходимо ввести команду:

sowa-config --status <profile_name>

В результате, если профиль запущен успешно, в поле Active будет значение running.

Для проверки подключения необходимо ввести команду:

sudo netstat -ntulp | grep <port>

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

Обновление ППО SOWA завершено.

Проверка обновления#

Для проверки обновления необходимо переконфигурировать и перезапустить профиль.