<a id="adc082-update"></a>

# Обновление Angie ADC

Поддерживается обновление Angie ADC следующих версий:

- с версии [0.8.x до 0.8.2](#adc082-update-0-8-x-to-0-8-2);
- с версии [0.8.0 до 0.8.1](#adc082-update-0-8-0-to-0-8-1);
- с версии [0.7.x до 0.8.1](#adc082-update-0-7-x-to-0-8-1);
- с версии [0.7.x до 0.7.3](https://angie.software//adc/docs-0.7.3/install/update.md#adc073-update-0-7-x-to-0-7-3);
- с версии [0.6.0 до версии 0.7.3](https://angie.software//adc/docs-0.7.3/install/update.md#adc073-update-0-6-0-to-0-7-3);
- с версии [0.5.x до версии 0.6.0](https://angie.software//adc/docs-0.6.0/install/update.md#adc060-update);
- с версии 0.5.0 до версии 0.5.2;
- с версии 0.4.0 до версии 0.5.0.

Обновление Angie ADC выполняется
с помощью файла (файлов) обновления, которые находятся
по ссылке [https://download.angie.software/adc/updates/](https://download.angie.software/adc/updates/).

<a id="adc082-update-0-8-x-to-0-8-2"></a>

## Обновление с версии 0.8.x до версии 0.8.2

Обновление Angie ADC с версии 0.8.x до версии 0.8.2 выполняется последовательно
с помощью двух файлов обновления:

- `adc-update-0.8.x-to-0.8.2.stage1.angie`;
- `adc-update-0.8.x-to-0.8.2.stage2.angie`.

#### IMPORTANT
Сначала необходимо запустить первый файл обновления (до запуска второго файла),
иначе обновление завершится ошибкой.

### Предварительные действия

- Скачайте файлы обновления `adc-update-0.8.x-to-0.8.2.stage1.angie`
  и `adc-update-0.8.x-to-0.8.2.stage2.angie` из репозитория
  по ссылке [https://download.angie.software/adc/updates/](https://download.angie.software/adc/updates/).
- Убедитесь, что файлы обновления имеют права 755, т.е. полный доступ (чтение, запись, выполнение)
  есть только у владельца, а у группы и остальных — доступ на чтение и запуск.
- Расформируйте пару высокой доступности, если она была создана,
  иначе обновление пары завершится ошибкой.

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

1. Запустите [интерфейс командной строки](https://angie.software//adc/docs-0.8.2/management/cli-commands.md#adc082-starting-cli) на порту 2222
   и скопируйте файлы обновления
   в корневую папку Angie ADC, сохраняя права файлов.
   ```none
   $ scp -p -P 2222 adc-update-0.8.x-to-0.8.2.stage* admin@adc.example.com:/
   ```

   #### NOTE
   Если нет возможности скопировать файлы обновления с сохранением прав,
   то права можно скорректировать на целевой системе клиентом **sftp**.

   Пример для `adc-update-0.8.x-to-0.8.2.stage1.angie`:
   ```none
   sftp -P 2222 admin@adc.example.com
   admin@adc.example.com's password:
   Connected to adc.example.com.
   sftp> ls -l
   ----------    1 0        0        379487220 Mar 26 10:07 adc-update-0.8.x-to-0.8.2.stage1.angie
   sftp> chmod 755 adc-update-0.8.x-to-0.8.2.stage1.angie
   Changing mode on /adc-update-0.8.x-to-0.8.2.stage1.angie
   sftp> ls -l
   -rwxr-xr-x    1 0        0        379487220 Mar 26 10:07 adc-update-0.8.x-to-0.8.2.stage1.angie
   sftp>
   ```
2. Запустите первый файл обновления `adc-update-0.8.x-to-0.8.2.stage1.angie`:
   ```none
   ssh -p 2222 admin@adc.example.com
   admin@adc.example.com's password:
   $$ system
   (system)$$ upgrade adc-update-0.8.x-to-0.8.2.stage1.angie

   WARNING!
   ==========
   You are about to upgrade the ADC system.
   This operation may cause service interruption.
   IMPORTANT: Once started, the upgrade process CANNOT be interrupted!
   Please make sure you have:
     1. Scheduled maintenance window
     2. Backed up your data
     3. Notified relevant stakeholders

   Do you want to proceed with the upgrade? [y/N] y
   Checking script signature...
   Verified OK
   [2026-03-26 10:32:23] ADC Update Package
   ...
   ```
3. Запустите второй файл обновления `adc-update-0.8.x-to-0.8.2.stage2.angie`:
   ```none
   ssh -p 2222 admin@adc.example.com
   admin@adc.example.com's password:
   $$ system
   (system)$$ upgrade adc-update-0.8.x-to-0.8.2.stage2.angie

   WARNING!
   ==========
   You are about to upgrade the ADC system.
   This operation may cause service interruption.
   IMPORTANT: Once started, the upgrade process CANNOT be interrupted!
   Please make sure you have:
     1. Scheduled maintenance window
     2. Backed up your data
     3. Notified relevant stakeholders

   Do you want to proceed with the upgrade? [y/N] y
   Checking script signature...
   Verified OK
   [2026-03-26 10:42:23] ADC Update Package
   ...
   ```

В процессе обновления соединение с CLI Angie ADC может прерваться.
В таком случае через несколько минут заново подключитесь к CLI.

Чтобы просмотреть процесс обновления, перейдите в журнал событий обновления.
Если в сообщениях есть строка `Upgrade completed successfully`,
то обновление прошло успешно:

```none
$$ logs
(logs)$$ upgrade
...
[2026-03-26 11:43:17] Upgrade completed successfully
[2026-03-26 11:43:17] WARNING: All cli sessions may be terminated within the next 3 minutes to complete the upgrade procedure.
(logs)$$
```

<a id="adc082-update-0-8-0-to-0-8-1"></a>

## Обновление с версии 0.8.0 до версии 0.8.1

Обновление Angie ADC с версии 0.8.0 до версии 0.8.1 выполняется последовательно
с помощью двух файлов обновления:

- `adc-update-0.8.0-to-0.8.1.stage1.angie`;
- `adc-update-0.8.0-to-0.8.1.stage2.angie`.

#### IMPORTANT
Сначала необходимо запустить первый файл обновления (до запуска второго файла),
иначе обновление завершится ошибкой.

### Предварительные действия

- Скачайте файлы обновления `adc-update-0.8.0-to-0.8.1.stage1.angie`
  и `adc-update-0.8.0-to-0.8.1.stage2.angie` из репозитория
  по ссылке [https://download.angie.software/adc/updates/](https://download.angie.software/adc/updates/).
- Убедитесь, что файлы обновления имеют права 755, т.е. полный доступ (чтение, запись, выполнение)
  есть только у владельца, а у группы и остальных — доступ на чтение и запуск.
- Расформируйте пару высокой доступности, если она была создана,
  иначе обновление пары завершится ошибкой.

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

1. Запустите [интерфейс командной строки](https://angie.software//adc/docs-0.8.2/management/cli-commands.md#adc082-starting-cli) на порту 2222
   и скопируйте файлы обновления
   в корневую папку Angie ADC, сохраняя права файлов.
   ```none
   $ scp -p -P 2222 adc-update-0.8.0-to-0.8.1.stage* admin@adc.example.com:/
   ```

   #### NOTE
   Если нет возможности скопировать файлы обновления с сохранением прав,
   то права можно скорректировать на целевой системе клиентом **sftp**.

   Пример для `adc-update-0.8.0-to-0.8.1.stage1.angie`:
   ```none
   sftp -P 2222 admin@adc.example.com
   admin@adc.example.com's password:
   Connected to adc.example.com.
   sftp> ls -l
   ----------    1 0        0        379487220 Mar 26 10:07 adc-update-0.8.0-to-0.8.1.stage1.angie
   sftp> chmod 755 adc-update-0.8.0-to-0.8.1.stage1.angie
   Changing mode on /adc-update-0.8.0-to-0.8.1.stage1.angie
   sftp> ls -l
   -rwxr-xr-x    1 0        0        379487220 Mar 26 10:07 adc-update-0.8.0-to-0.8.1.stage1.angie
   sftp>
   ```
2. Запустите первый файл обновления `adc-update-0.8.0-to-0.8.1.stage1.angie`:
   ```none
   ssh -p 2222 admin@adc.example.com
   admin@adc.example.com's password:
   $$ system
   (system)$$ upgrade adc-update-0.8.0-to-0.8.1.stage1.angie

   WARNING!
   ==========
   You are about to upgrade the ADC system.
   This operation may cause service interruption.
   IMPORTANT: Once started, the upgrade process CANNOT be interrupted!
   Please make sure you have:
     1. Scheduled maintenance window
     2. Backed up your data
     3. Notified relevant stakeholders

   Do you want to proceed with the upgrade? [y/N] y
   Checking script signature...
   Verified OK
   [2026-03-26 10:32:23] ADC Update Package
   ...
   ```
3. Запустите второй файл обновления `adc-update-0.8.0-to-0.8.1.stage2.angie`:
   ```none
   ssh -p 2222 admin@adc.example.com
   admin@adc.example.com's password:
   $$ system
   (system)$$ upgrade adc-update-0.8.0-to-0.8.1.stage2.angie

   WARNING!
   ==========
   You are about to upgrade the ADC system.
   This operation may cause service interruption.
   IMPORTANT: Once started, the upgrade process CANNOT be interrupted!
   Please make sure you have:
     1. Scheduled maintenance window
     2. Backed up your data
     3. Notified relevant stakeholders

   Do you want to proceed with the upgrade? [y/N] y
   Checking script signature...
   Verified OK
   [2026-03-26 10:42:23] ADC Update Package
   ...
   ```

В процессе обновления соединение с CLI Angie ADC может прерваться.
В таком случае через несколько минут заново подключитесь к CLI.

Чтобы просмотреть процесс обновления, перейдите в журнал событий обновления.
Если в сообщениях есть строка `Upgrade completed successfully`,
то обновление прошло успешно:

```none
$$ logs
(logs)$$ upgrade
...
[2026-03-26 11:43:17] Upgrade completed successfully
[2026-03-26 11:43:17] WARNING: All cli sessions may be terminated within the next 3 minutes to complete the upgrade procedure.
(logs)$$
```

<a id="adc082-update-0-7-x-to-0-8-1"></a>

## Обновление с версии 0.7.x до версии 0.8.1

Обновление Angie ADC с версии 0.7.x до версии 0.8.1 выполняется последовательно
с помощью двух файлов обновления:

- `adc-update-0.7.x-to-0.8.1.stage1.angie`;
- `adc-update-0.7.x-to-0.8.1.stage2.angie`.

#### IMPORTANT
Сначала необходимо запустить первый файл обновления (до запуска второго файла),
иначе обновление завершится ошибкой.

### Предварительные действия

- Скачайте файлы обновления `adc-update-0.7.x-to-0.8.1.stage1.angie`
  и `adc-update-0.7.x-to-0.8.1.stage2.angie` из репозитория
  по ссылке [https://download.angie.software/adc/updates/](https://download.angie.software/adc/updates/).
- Убедитесь, что файлы обновления имеют права 755, т.е. полный доступ (чтение, запись, выполнение)
  есть только у владельца, а у группы и остальных — доступ на чтение и запуск.
- Расформируйте пару высокой доступности, если она была создана,
  иначе обновление пары завершится ошибкой.

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

1. Запустите [интерфейс командной строки](https://angie.software//adc/docs-0.8.2/management/cli-commands.md#adc082-starting-cli) на порту 2222
   и скопируйте файлы обновления
   в корневую папку Angie ADC, сохраняя права файлов.
   ```none
   $ scp -p -P 2222 adc-update-0.7.x-to-0.8.1.stage* admin@adc.example.com:/
   ```

   #### NOTE
   Если нет возможности скопировать файлы обновления с сохранением прав,
   то права можно скорректировать на целевой системе клиентом **sftp**.

   Пример для `adc-update-0.7.x-to-0.8.1.stage1.angie`:
   ```none
   sftp -P 2222 admin@adc.example.com
   admin@adc.example.com's password:
   Connected to adc.example.com.
   sftp> ls -l
   ----------    1 0        0        379487220 Mar 26 10:07 adc-update-0.7.x-to-0.8.1.stage1.angie
   sftp> chmod 755 adc-update-0.7.x-to-0.8.1.stage1.angie
   Changing mode on /adc-update-0.7.x-to-0.8.1.stage1.angie
   sftp> ls -l
   -rwxr-xr-x    1 0        0        379487220 Mar 26 10:07 adc-update-0.7.x-to-0.8.1.stage1.angie
   sftp>
   ```
2. Запустите первый файл обновления `adc-update-0.7.x-to-0.8.1.stage1.angie`:
   ```none
   ssh -p 2222 admin@adc.example.com
   admin@adc.example.com's password:
   $$ system
   (system)$$ upgrade adc-update-0.7.x-to-0.8.1.stage1.angie

   WARNING!
   ==========
   You are about to upgrade the ADC system.
   This operation may cause service interruption.
   IMPORTANT: Once started, the upgrade process CANNOT be interrupted!
   Please make sure you have:
     1. Scheduled maintenance window
     2. Backed up your data
     3. Notified relevant stakeholders

   Do you want to proceed with the upgrade? [y/N] y
   Checking script signature...
   Verified OK
   [2026-03-26 10:32:23] ADC Update Package
   ...
   ```
3. Запустите второй файл обновления `adc-update-0.7.x-to-0.8.1.stage2.angie`:
   ```none
   ssh -p 2222 admin@adc.example.com
   admin@adc.example.com's password:
   $$ system
   (system)$$ upgrade adc-update-0.7.x-to-0.8.1.stage2.angie

   WARNING!
   ==========
   You are about to upgrade the ADC system.
   This operation may cause service interruption.
   IMPORTANT: Once started, the upgrade process CANNOT be interrupted!
   Please make sure you have:
     1. Scheduled maintenance window
     2. Backed up your data
     3. Notified relevant stakeholders

   Do you want to proceed with the upgrade? [y/N] y
   Checking script signature...
   Verified OK
   [2026-03-26 10:42:23] ADC Update Package
   ...
   ```

В процессе обновления соединение с CLI Angie ADC может прерваться.
В таком случае через несколько минут заново подключитесь к CLI.

Чтобы просмотреть процесс обновления, перейдите в журнал событий обновления.
Если в сообщениях есть строка `Upgrade completed successfully`,
то обновление прошло успешно:

```none
$$ logs
(logs)$$ upgrade
...
[2026-03-26 11:43:17] Upgrade completed successfully
[2026-03-26 11:43:17] WARNING: All cli sessions may be terminated within the next 3 minutes to complete the upgrade procedure.
(logs)$$
```