# Ручное обновление — Windows

На этой странице описан процесс ручного обновления платформы Navixy On-premise на Windows. Используйте эту инструкцию, если вам необходимо иметь полный контроль над процессом обновления или если вы используете нестандартные пути сервисов. В противном случае в большинстве случаев рекомендуется обратиться к [автоматическому обновлению](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/installation/update/update-windows/automatic-update-windows).

В целом обновление платформы Navixy состоит из трех частей:

1. Обновление базы данных.
2. Обновление файлов java-сервисов.
3. Обновление файлов веб-сервисов.

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

1. **Java Development Kit 21**\
   Начиная с марта 2025 года платформа устарела версия 17 и старее.
2. **MySQL 8.0**\
   Начиная с марта 2024 года платформа устарела MySQL 5.7. Эта версия достигла конца жизненного цикла (EOL) и больше не поддерживается.

{% hint style="danger" %}
Несоответствие требуемому программному обеспечению приведет к тому, что новая версия платформы не сможет запуститься. Однако предварительное обновление зависимостей позволит сохранить работоспособность платформы.
{% endhint %}

Обновление не пройдет на более старых версиях MySQL и завершится с ошибкой.

## Начало обновления

Распакуйте дистрибутив платформы, полученный от Navixy, как правило это `.tar.gz` файл. Вы можете использовать любой архиватор, способный работать с tar.gz файлами, например <https://www.7-zip.org/>. Внутри распакованного архива вы найдете каталог "navixy-package", содержащий все файлы платформы. Вы можете переместить его в любое другое место, чтобы пути установки были короче. В дальнейшем это будет основной каталог дистрибутива. Перед обновлением настоятельно рекомендуется [остановить java-сервисы Navixy](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/maintenance/restarting-instance) в меню "Services". Для on-premise инстансов на Windows нет автоматизированных скриптов обновления. Все обновление выполняется вручную.

## Процесс обновления

### Шаг 1: обновление базы данных

Откройте командную строку и перейдите в папку, куда вы распаковали дистрибутив Navixy. Например, если вы распаковали пакет в папку Downloads, команда для перехода в каталог db пакета может выглядеть так:

```
cd C:\Users\Administrator\Downloads\navixy-package\db
```

Выполните **updates.sql** файл следующей командой:

```
mysql -uroot -p$ROOTPASSWORD google < updates.sql
```

(где **$ROOTPASSWORD** — пароль root для MySQL)

Удалите updates.sql и google.sql из папки db. Это необходимо, чтобы не перезаписать базу данных на следующем шаге.

```
del updates.sql
del google.sql
```

Убедитесь, что эти файлы удалены, затем выполните все остальные sql-файлы:

```
type *.sql | mysql -uroot -p$ROOTPASSWORD google
```

### Шаг 2: обновление Java-сервисов

Обновление Java-сервисов включает замену файлов в директориях сервисов, расположенных в C:\java, а именно api-server, sms-server и tcp-server.

Чтобы обновить эти сервисы, найдите соответствующие директории в navixy-package и замените все файлы в папке conf, за исключением **config.properties** и **db.properties**.

Перед заменой **config.properties** файлов сравните существующие с файлами из нового дистрибутива, чтобы убедиться, что любые новые параметры добавлены в существующую конфигурацию.

### Шаг 3: обновление веб-сервисов

Перейдите в *C:\nginx\www* каталог. Замените все файлы в ***panel-v2*** и ***pro-ui*** директориях файлами из соответствующих директорий пакета дистрибутива. Это не повредит никакие настройки, так как конфигурационные файлы в пакете имеют имена, такие как *example*, и не перезапишут существующие.

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

* panel-v2\\**Config.js**
* pro-ui\\**PConfig.js**
* pro-ui\static\\**app\_config.js**

Если в примерах есть новые параметры, добавьте их в соответствующие файлы в вашей установке Navixy.

## Конфигурация Windows-сервисов

Если вы обновляетесь до Java 21 с предыдущей версии, вам потребуется переустановить сервисы Navixy, так как wrapper-приложение из предыдущей версии не будет работать с Java 21. Для этого возьмите папку Wrapper из установочного пакета и выполните те же шаги, что и при первоначальной установке. Подробнее: [Install on Windows.](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/installation/advanced-installation/windows-installation)

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

## Финальные шаги

Чтобы завершить процесс обновления, перезапустите Java-сервисы Navixy в меню "Services". Убедитесь, что сервисы успешно перезапустились и работают как минимум одну минуту.