Aruba AirWave升级步骤

概述

AirWave 运行在作为后端操作系统的 CentOS 7 上。由于 CentOS 7 将于 2024 年 6 月 30 日结束支持，因此 AirWave 8.3.0 将使用 RHEL 8.6 版本发布，并且所有未来的 AirWave 8.3.x 版本只会与 RHEL 8.6 或更高版本一起发布。

准备资料

准备	用途	备注
SCP Server	用于传输升级文件和备份文件	本文案例使用CentOS Server
AirWave8.2.15.2升级文件	用于升级8.2.15.1版本
AirWave8.3.0.1 ISO文件	用于重新安装RHEL8.0版本的AirWave

升级路径

您的升级工作流程取决于您当前使用的AirWave版本：

1. 要从8.2.15.2之前的AirWave版本升级，请按照《迁移到AirWave 8.3.0.1》中的所有步骤进行操作。
2. 要从8.2.15.2迁移到AirWave 8.3.0.1，请从第2步开始按照步骤操作：备份AirWave 8.2.15.1数据，然后进行迁移到AirWave 8.3.0.1。

请根据您当前的AirWave版本以及相应的步骤进行升级或迁移操作。

迁移到AirWave 8.3.0.1版本。

如果您的AirWave版本早于8.2.15.2版本，迁移过程包括：

1. 升级到AirWave 8.2.15.2
2. 备份数据
3. 导出备份文件
4. 然后在服务器上使用RHEL 8（64位）操作系统进行全新安装AirWave 8.3.0.1
5. 最后将备份数据还原到该服务器。

Note:有关创建数据备份的更多信息，请参考AirWave用户指南中的系统页面部分。有关执行AirWave 8.3.0.1的全新安装的信息，请参考AirWave安装指南。

在开始之前

在迁移之前，请导航到主页 > 许可证并保存许可证密钥的副本。AirWave许可证与服务器IP地址关联。所有AirWave的新安装都有90天的许可证宽限期。

在处理AirWave许可证时，请记住以下几点考虑事项：

1. 如果您计划重用相同的IP地址，则在恢复AirWave 8.2.15.2备份后再应用许可证密钥。
2. 如果您计划将数据迁移到新的服务器，可以与Aruba支持团队合作，或使用许可证门户提前生成新的许可证，然后按照迁移路径应用新的许可证密钥。请注意，您可能需要调整一些设备（如Instant AP和发送AMON或syslog消息至AirWave的设备）以便这些设备能够发送更新到新的IP地址。

Note:在从AirWave 8.2.15.2迁移到8.3.0.1后，NTP配置将自动配置。

Note:不支持从CentOS版本升级到RHEL（Red Hat Enterprise Linux）。

步骤1：升级到AirWave 8.2.15.2版本

1. 使用ampadmin用户名和密码登录AirWave服务器。如果您之前更改了ampadmin用户名和密码，请输入当前凭据。

2.上传8.2.15.2升级包

3.输入 4 选择系统选项。

4. 在下一个提示符中，输入 1 选择升级，然后从列出的AMP版本中选择 8.2.15.2，如果AMP升级的 tar.gz 文件已经上传到此AMP服务器。

5. 选择 8.2.15.2 的选项。

6.等待版本升级

步骤2：备份您的 AirWave 8.2.15.2 数据

1.登录AirWave到AMP Setup--->Network--->Network Time(NTP)在8.2.15.1备份之前记录NTP的配置。使用 ampadmin 用户名和密码登录到 AirWave 服务器。如果您之前更改过 ampadmin 用户名和密码，请输入当前凭据。

2. 输入 2 选择备份。

AirWave Management Platform 8.2.15.2 on lhm-airwave

  1  Files >

  2  Backups >

  3  Configuration >

  4  System >

  5  Users >

  6  Support >

  7  Security >

  8  Advanced >

  q  >> Quit

Your choice: 2

1. 输入 1 打开备份菜单。

Backups

  1  Backup >

  2  Restore >

  b  >> Back

Your choice: 1

4. 输入 1 选择立即备份选项。

Backup

  1  Backup Now

  2  Configure Automatic Transfer

  3  Local Backup Retention

  b  >> Back

Your choice: 1

5.输入Y确认备份

Running Backup Now

The backup file will be named ampbackup_2023-09-07_17-23-40.tar.gz.

Are you sure? (y/n): y

(starting postgres backup)

Thu Sep  7 17:23:42 CST 2023

Thu Sep  7 17:24:03 CST 2023

(finished postgres backup)

Thu Sep  7 17:24:04 2023:: Starting VisualRF backup ...

Thu Sep  7 17:24:35 2023:: Backup filename visualrf_backup_lhm-airwave.zip, in dir /var/airwave-backup.

Thu Sep  7 17:24:36 2023:: Successfully completed VisualRF backup!

linking /var/airwave-backup/visualrf_backup_lhm-airwave.zip to /var/ampcli/user/visualrf_backup_lhm-airwave.zip

linking /var/airwave-backup/visualrf_backup_lhm-airwave.digest to /var/ampcli/user/visualrf_backup_lhm-airwave.digest

(starting tar)

Thu Sep  7 17:24:44 CST 2023

Thu Sep  7 17:25:16 CST 2023

(finished tar)

Hit enter to continue, 's' to show output, 'r' to show return code.

步骤3: 导出备份数据

1. 创建完备份后，输入 b 返回到上一个备份菜单。

Backup

  1  Backup Now

  2  Configure Automatic Transfer

  3  Local Backup Retention

  b  >> Back

Your choice: b

Backups

  1  Backup >

  2  Restore >

  b  >> Back

Your choice: b    

2.使用 SCP 连接到您的远程存储库，将 AirWave 8.2.15.2 备份文件从 AirWave/user 目录移动到远程服务器。

AirWave Management Platform 8.2.15.2 on lhm-airwave

  1  Files >

  2  Backups >

  3  Configuration >

  4  System >

  5  Users >

  6  Support >

  7  Security >

  8  Advanced >

  q  >> Quit

Your choice: 1

Files

  1  Upload File

  2  Download File

  3  Delete File

  b  >> Back

Your choice: 2

Running Download File

Download File

  1  ampbackup_2023-09-07_17-23-40.tar.gz      69,155,210 bytes  2023-09-07 17:25:16

  c  >> Cancel

Your choice: 1

SCP Destination (user@host:path): root@172.16.100.101:/home/scp

Password:xxxxxxxx

Downloading to root@172.16.100.101:/home/scp

ampbackup_2023-09-07_17-23-40.tar.gz                                                                                                     100%   66MB  33.0MB/s   00:02    

Hit Return to continue ...

步骤4：迁移到RHEL 8，重新安装8.3.0.1

1. 确保在 ILO 管理 -> 启动顺序页面中将引导模式设置为统一固件接口（UEFI）模式，并点击应用。
2. 进行 AirWave 8.3.0.1 的全新安装：

        通过选择本地驱动器中的 .iso 文件，使用 ILO CD/DVD 选项进行安装。

Note：在安装过程中，“下载软件包”步骤可能需要 15 到 45 分钟的时间，在物理服务器上更长。请耐心等待，直到完成。

Note：要了解在您的服务器上安装 AirWave 8.3.0 的新实例的更多信息，请参考 AirWave 8.3.0 安装指南和预安装检查清单。

创建虚拟机

启动顺序页面中将引导模式设置为统一固件接口（UEFI）模式，并点击应用。

1. 输入用户名：root，密码：admin
2. 选择1配置时间和日期

1. 选择2配置时区，选择4)Asia---10)China---1)Beijing Time，然后输入1确认

4、输入0进行下一步

5、系统自动进行AMP安装的第二和第三个步骤（其中第三个步骤需要较长时间，根据系统性能差异，通常需要大约等待10~15分钟）

按照以下步骤进行全新安装：

可以Ctrl+Alt+F9查看详细信息

可以Ctrl+Alt+F1返回此屏幕

6、创建恢复用户和Admin用户

1. 创建恢复用户

在此步骤中，AirWave在创建recover user帐户时配置AMP CLI。在提示符下，输入恢复用户的用户名。如果你不输入用户名，AirWave使用默认的恢复用户called“amprecovery”。

1. 创建Admin用户

在提示符下，输入admin CLI用户帐号的用户名和密码。如果您不输入用户名，
AirWave使用默认的管理用户，称为“ampadmin”。

通过菜单设置网管服务器的IP地址、网关和DNS服务器地址，并输入9进行确认

a. 选择“1”，输入网络信息，按“enter”。
b.选择2，输入子网掩码，按“enter”。
c.选择3，输入网关，按“enter”。
d.选择“6”，输入主DNS地址，按“enter”。
e输入9，按“Enter”，提交修改。若要放弃更改，请键入0，然后按下“Enter”。
f.输入y，重新启动配置的网

8、可以设置AMP服务器的名称（这里也可以不设置，日后能够通过Web页面进行修改），缺省是Airwave Management Platform

9、选择是否采用域名来生成自签发数字证书（该证书只用于网管客户端的浏览器与网管服务器之间的HTTPS会话），如果选择no，则基于IP地址生成数字证书。通常选择no就可以了，不影响网管的正常使用

10、安装完成

步骤5：上传备份

按照以下步骤之一上传备份至 AirWave 8.3.0.1：

1. 如果使用 SCP，请输入 1-1 打开 "File" 和 "Upload File" 菜单。使用 FIPS 批准的加密提供 SCP 服务器的用户名、主机和路径。

AirWave Management Platform 8.3.0.1 on localhost.localdomain

  1  Files >

  2  Backups >

  3  Configuration >

  4  System >

  5  Users >

  6  Support >

  7  Security >

  8  Advanced >

  q  >> Quit

Your choice: 1

Files

  1  Upload File

  2  Download File

  3  Delete File

  b  >> Back

Your choice: 1

Running Upload File

SCP Source (user@host:path): root@172.16.100.101:/home/scp/ampbackup_2023-09-07_17-23-40.tar.gz

Password: xxxxxxx

Uploading root@172.16.100.101:/home/scp/ampbackup_2023-09-07_17-23-40.tar.gz

Warning: Permanently added '172.16.100.101' (ECDSA) to the list of known hosts.

ampbackup_2023-09-07_17-23-40.tar.gz                                                                                                     100%   66MB 181.4MB/s   00:00    

Hit Return to continue ...

Root为scp服务器登录的用户名，xxxxxxx为scp服务器密码

步骤 6：还原数据，需要等20分钟左右

请按照以下步骤在 AirWave 8.3.0.1 上恢复备份：

1. 从 AMP CLI 输入 2-2 打开“Backups”和“Restore”菜单。

2. 输入 1 以从上传的备份中恢复服务器。

AirWave Management Platform 8.3.0.1 on localhost.localdomain

  1  Files >

  2  Backups >

  3  Configuration >

  4  System >

  5  Users >

  6  Support >

  7  Security >

  8  Advanced >

  q  >> Quit

Your choice:

Your choice: 2

Backups

  1  Backup >

  2  Restore >

  b  >> Back

Your choice: 2

Restore

  1  AMP Restore

  2  VisualRF Restore

  b  >> Back

Your choice: 1

Running AMP Restore

AMP Restore

  1  ampbackup_2023-09-07_17-23-40.tar.gz      69,155,210 bytes  2023-09-07 18:39:31 

  c  >> Cancel

Your choice: 1

Restoring AMP from ampbackup_2023-09-07_17-23-40.tar.gz

Are you sure? (y/N): y

[Thu Sep 7 18:41:21 CST 2023] Redhat OS Version ... 8

[Thu Sep 7 18:41:21 CST 2023] If you are restoring the backup on new AMP server, please make sure the disk space is equal or higher than the disk space from the AMP server where the backup is taken.

[Thu Sep 7 18:41:21 CST 2023] Checking available disk space ...

[Thu Sep 7 18:41:27 CST 2023] Verifying completeness of /var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz ...

[Thu Sep 7 18:41:29 CST 2023] Checking backup version ...

*** FAILED TO STOP docker *** at /usr/local/airwave/lib/perl/Mercury/Utility/AMPEnableDisable.pm line 47.

Shutting down rabbitmq-server:

warning: the VM is running with native name encoding of latin1 which may cause Elixir to malfunction as it expects utf8. Please ensure your locale is set to UTF-8 (which can be verified by running "locale" in your shell)

Shutting down Erlang Port Mapper Daemon (epmd):

rabbitmq-server: no process found                          [  OK  ]

*** FAILED TO STOP rabbitmq-server *** at /usr/local/airwave/lib/perl/Mercury/Utility/AMPEnableDisable.pm line 47.

[Thu Sep 7 18:52:29 CST 2023] Restoring AMP from file /var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz

+ '[' 0 -eq 1 ']'

+ find /var/airwave -follow -not -regex '/var/airwave/license.*' -and -not -regex '/var/airwave/gnupg.*' -and -not -regex '/var/airwave/support.*' -and -not -path /var/airwave/secure/security -and -not -path /var/airwave/service_watcher_limits -and -not -regex '/var/airwave/git.*' -type f -exec /bin/rm -f '{}' ';'

+ print '/bin/tar --keep-directory-symlink --use-compress-program=/usr/bin/pigz -xf "/var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz" -C / >> /tmp/amp_restore_2414.log 2>&1'

++ date

+ printf -v MSG '[%s] %s' 'Thu Sep  7 18:52:37 CST 2023' '/bin/tar --keep-directory-symlink --use-compress-program=/usr/bin/pigz -xf "/var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz" -C / >> /tmp/amp_restore_2414.log 2>&1'

+ echo '[Thu' Sep 7 18:52:37 CST '2023]' /bin/tar --keep-directory-symlink --use-compress-program=/usr/bin/pigz -xf '"/var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz"' -C / '>>' /tmp/amp_restore_2414.log '2>&1'

[Thu Sep 7 18:52:37 CST 2023] /bin/tar --keep-directory-symlink --use-compress-program=/usr/bin/pigz -xf "/var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz" -C / >> /tmp/amp_restore_2414.log 2>&1

+ echo '[Thu' Sep 7 18:52:37 CST '2023]' /bin/tar --keep-directory-symlink --use-compress-program=/usr/bin/pigz -xf '"/var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz"' -C / '>>' /tmp/amp_restore_2414.log '2>&1'

+ /bin/tar --keep-directory-symlink --use-compress-program=/usr/bin/pigz -xf /var/ampcli/user/ampbackup_2023-09-07_17-23-40.tar.gz -C / --files-from=/tmp/include_from_backup --exclude-from=/tmp/exclude_from_restore

+ set +x

Thu Sep  7 18:52:39 CST 2023

[Thu Sep 7 18:52:39 CST 2023] (finished /bin/tar)

stop_postgresql_hard: stop postgres via service

stop_postgresql_hard: done

waiting for server to start....LOG:  00000: listening on IPv4 address "127.0.0.1", port 5432

LOCATION:  StreamServerPort, pqcomm.c:593

LOG:  00000: listening on Unix socket "/tmp/.s.PGSQL.5432"

LOCATION:  StreamServerPort, pqcomm.c:587

LOG:  00000: ending log output to stderr

HINT:  Future log output will go to log destination "syslog".

LOCATION:  PostmasterMain, postmaster.c:1299

 done

server started

[Thu Sep 7 18:52:45 CST 2023] Restoring database from alternative/postgres_dump_323

stop_postgresql_hard: stop postgres via service

3885 3884 3883 3882 3881 3880 3878

stop_postgresql_hard: postmaster process still exists! send SIGTERM now ...

3884 3883 3880 3878

stop_postgresql_hard: postmaster process lingering; try SIGTERM again ...

stop_postgresql_hard: done

make: Nothing to be done for '/root/.pgpass'.

Upgrading database (update_db.pl)

OUI stuff took 3.59s

license specific stuff took 0.02s

firmware version stuff took 0.40s

regulatory domain took 0.80s

  (update_db.pl ready_all/wait_all took 13.32s)

Generate DB procedures

Upgrading VisualRF database

Running Visualrf schema upgrade

18:55:13.401 [main] DEBUG org.reflections.Reflections - going to scan these urls:

jar:file:/usr/local/airwave/lib/java/lib/airwave.mbus.jar!/

jar:file:/usr/local/airwave/lib/java/lib/airwave.ge.jar!/

jar:file:/usr/local/airwave/lib/java/airwave.visualrf.jar!/

18:55:13.729 [main] INFO  org.reflections.Reflections - Reflections took 324 ms to scan 3 urls, producing 390 keys and 2142 values

Checking Visualrf grid sizes et al

No floorplans with incorrect grid size found.

Upgrading IGC database

Thu Sep  7 18:56:15 2023: Dropping 'Test' database if exists....

DROP DATABASE

Thu Sep  7 18:56:15 2023: Creating 'Test' database....

CREATE DATABASE

ALTER DATABASE

Thu Sep  7 18:56:25 2023: Retrieving expected database schema....

Thu Sep  7 18:56:45 2023: Retrieving actual database schema....

Thu Sep  7 18:58:01 2023: Comparing schemas....

Thu Sep  7 18:59:10 2023: Deleting 'Test' database....

DROP DATABASE

Thu Sep  7 18:59:10 2023: Database schema looks ok....

Checking sequence values....

Finished checking sequence values....

restore root crontab success.

restarting postfix success.

enable_amp success.

AMP_Restore success.