Arbor Enterprise Manager

Upgrade Guide for Appliances

Version 7.0.0.0
Legal Notice
The information contained within this document is subject to change without notice. NETSCOUT SYSTEMS, INC.
makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. NETSCOUT SYSTEMS, INC. shall not be liable for errors
contained herein or for any direct or indirect, incidental, special, or consequential damages in connection with the
furnishings, performance, or use of this material.
Use of this product is subject to the End User License Agreement available at
http://www.NetScout.com/legal/terms-and-conditions or which accompanies the product at the time of shipment
or, if applicable, the legal agreement executed by and between NetScout Systems, Inc. or one of its wholly-owned
subsidiaries (“NETSCOUT”) and the purchaser of this product (“Agreement”).
Government Use and Notice of Restricted Rights: In U.S. government (“Government”) contracts or subcontracts,
Customer will provide that the Products and Documentation, including any technical data (collectively “Materials”),
sold or delivered pursuant to this Agreement for Government use are commercial as defined in Federal
Acquisition Regulation (“FAR”) 2.101and any supplement and further are provided with RESTRICTED RIGHTS. All
Materials were fully developed at private expense. Use, duplication, release, modification, transfer, or disclosure
(“Use”) of the Materials is restricted by the terms of this Agreement and further restricted in accordance with FAR
52.227-14 for civilian Government agency purposes and 252.227- 7015 of the Defense Federal Acquisition
Regulations Supplement (“DFARS”) for military Government agency purposes, or the similar acquisition
regulations of other applicable Government organizations, as applicable and amended. The Use of Materials is
restricted by the terms of this Agreement, and, in accordance with DFARS Section 227.7202 and FAR Section
12.212, is further restricted in accordance with the terms of NETSCOUT’S commercial End User License
Agreement. All other Use is prohibited, except as described herein.
This Product may contain third-party technology. NETSCOUT may license such third-party technology and
documentation (“Third-Party Materials”) for use with the Product only. In the event the Product contains Third-
Party Materials, or in the event you have the option to use the Product in conjunction with Third-Party Materials
(as identified by NETSCOUT in the Documentation provided with this Product), then such third-party materials are
provided or accessible subject to the applicable third-party terms and conditions contained either in the “Read
Me” or “About” file located in the Software or on an Application CD provided with this Product, or in an appendix
located in the documentation provided with this Product. To the extent the Product includes Third-Party Materials
licensed to NETSCOUT by third parties, those third parties are third-party beneficiaries of, and may enforce, the
applicable provisions of such third-party terms and conditions.
Open-Source Software Acknowledgement: This product may incorporate open-source components that are
governed by the GNU General Public License (“GPL”) or licenses that are compatible with the GPL license (“GPL
Compatible License”). In accordance with the terms of the GNU GPL, NETSCOUT will make available a complete,
machine-readable copy of the source code components of this product covered by the GPL or applicable GPL
Compatible License, if any, upon receipt of a written request. Please identify the product and send a request to:
NetScout Systems, Inc.
GNU GPL Source Code Request
310 Littleton Road
Westford, MA 01886
Attn: Legal Department
No portion of this document may be copied, photocopied, reproduced, translated, or reduced to any electronic
medium or machine form without prior consent in writing from NETSCOUT. The information in this document is
subject to change without notice and does not represent a commitment on the part of NETSCOUT.
The products and specifications, configurations, and other technical information regarding the products
described or referenced in this document are subject to change without notice and NETSCOUT reserves the right,
at its sole discretion, to make changes at any time in its technical information, specifications, service, and support
programs. All statements, technical information, and recommendations contained in this document are believed
to be accurate and reliable but are presented “as is” without warranty of any kind, express or implied. You must
take full responsibility for their application of any products specified in this document. NETSCOUT makes no
implied warranties of merchantability or fitness for a purpose as a result of this document or the information
described or referenced within, and all other warranties, express or implied, are excluded.
Except where otherwise indicated, the information contained in this document represents the planned
capabilities and intended functionality offered by the product and version number identified on the front of this
document. Screen images depicted in this document are representative and intended to serve as example images
only.

© 2023 NETSCOUT All rights reserved. Confidential and Proprietary.

www.netscout.com
Document Number: AEM-Upgrade-7000-2023/05
03 May, 2023
Contents

About Upgrading AEM 6.9.0.0 to Version 7.0.0.0 4

Requirements 4
About Upgrading Virtual AEM 4
Upgrade Process 5
Verifying the ArbOS Version 5
Upgrading the Host ArbOS 6
Backing Up the AEM Data Before the Upgrade 7
Downloading the AEM Upgrade Files 7
Upgrading the AEM Guest VM to Version 7.0.0.0 7
Backing Up the AEM 7.0.0.0 Data 8
Preparing the Appliance for Native AEM Installation 9
Installing AEM Natively on the Appliance 9
Restoring from the 7.0.0.0 Backup 12

© NETSCOUT Confidential and Proprietary 3

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

About Upgrading AEM 6.9.0.0 to Version 7.0.0.0

Important
Because this upgrade process is complex, it is recommended that you contact your
account representative or the Arbor Technical Assistance Center (ATAC) for assistance
with the upgrade.
You can contact ATAC as follows:
n Phone US toll free — +1 877 272 6721

n Phone worldwide — +1 781 362 4301

n Support portal — https://my.netscout.com

AEM version 6.9.0.0 ran as a virtual machine along with an Edge Defense Manager (EDM)
virtual machine on a single appliance (AEM 7000 and AEM 8000 appliances).

In version 7.0.0.0, you install AEM on an appliance without a virtual machine and without
EDM. Therefore, this upgrade process is more complex than those for previous releases.

Before you begin the AEM upgrade, review the current release notes for any additional
preparations or steps that might be required for this upgrade.

Requirements
Your system must be running the following software versions:
n ArbOS version 7.2-METD on the host VM
This ArbOS version may have been installed with AEM version 6.9.0.0. However, if you
are running an earlier version, then you need to upgrade the ArbOS host VM.
n AEM version 6.9.0.0 on the AEM guest VM
If you are running an earlier version, then you need to upgrade to version 6.9.0.0
before you can upgrade to version 7.0.0.0.
For upgrade instructions, see the AEM 6.9.0.0 Release Notes.

About Upgrading Virtual AEM

If you are using Virtual AEM (vAEM), then follow the procedure for upgrading AEM on a
virtual machine that is not based on an AEM 7000 or AEM 8000 appliance. See “About
Upgrading Virtual AEM” in the Arbor Enterprise Manager Release Notes, Version 7.0.0.0.

© NETSCOUT Confidential and Proprietary 4

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

Upgrade Process
During the upgrade, you perform the following tasks:

Upgrading AEM 6.9.0.0 to version 7.0.0.0

Step Description

1 Verify the ArbOS version to determine if you must upgrade the ArbOS host.
ArbOS is the operating system for AEM.

2 If your host system is running an ArbOS version earlier than 7.2-METD, then
upgrade ArbOS on the host VM.
This step is required to properly transfer your existing AEM license to the
native AEM installation.

3 Download the AEM upgrade files.

4 Back up the AEM guest VM. If you have problems during the upgrade
procedure, then you might need to revert AEM to its pre-upgrade state.

5 Upgrade the AEM guest VM to version 7.0.0.0.

This step allows you to back up your data on an AEM 7.0.0.0 installation so
that you can restore it on the native AEM installation. This step and the next
step are important because you must create and restore a backup on the
same AEM software version.

6 Back up the data on the upgraded AEM guest VM. This backup is required so
that you can migrate the AEM data from the AEM guest VM to the native
installation.

7 Install the AEM serial .iso package on the host system.

8 Prepare the appliance for the native AEM installation.

9 Install AEM 7.0.0.0 on the appliance and configure the network settings and
license.

10 Restore the AEM data from the backup.

To begin the upgrade process, perform the following procedures in order.

Verifying the ArbOS Version

1. Log in to the CLI on the host VM with your administrator user name and password.
2. To view the installed packages, enter / system files show
3. Note the ArbOS version that appears under Installed packages.
4. Is the host running ArbOS version arbos 7.2-METD?
n No — Go to “Upgrading the Host ArbOS” on the next page.
n Yes — Go to “Downloading the AEM Upgrade Files” on page 7.

© NETSCOUT Confidential and Proprietary 5

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

Upgrading the Host ArbOS

To ensure the proper transfer of your existing AEM license to the native AEM installation,
the ArbOS host must be running version 7.3-MJO8 or later. Version 7.3-MJO8 was installed
with AEM 6.9.0.0.

To upgrade the host ArbOS:

1. Download the following files from the Arbor Technical Assistance Center (ATAC) at
https://my.netscout.com to a location that the AEM host system can access:
n arbos-7.2-METD-x86_64
n comsh-local-kvm-METD-x86_64.tar
For instructions, see “Downloading the AEM Upgrade Files” on the next page.
2. On the host system, log in to the AEM CLI with your administrator user name and
password.
3. Copy the files that you downloaded in step 1 to the AEM host system.
4. To verify that the files are in the correct location on the host, enter / system files
directory disk:
5. Enter / system hardware and make a note of the serial number that the system
displays. You will use this number to verify that it remains the same after the ArbOS
upgrade.
6. To install the ArbOS package, enter / system files install disk:arbos-7.2-
METD-x86_64
The changes to ArbOS will take effect after the next reload.
7. After the package is installed, go to shell and enter the following commands to move
the comsh .tar file:
a. shell
b. mv comsh-local-kvm-METD-x86_64.tar /base/comsh-local-kvm.tar
c. exit
8. To reload the system, enter / reload now
9. After the system reloads, enter the following commands to connect to the AEM guest
system from the host’s shell:
a. shell
b. /base/data/files# telnet localhost 2001:
It might take a few moments for the guest operating system to start.
c. exit
10. At the AEM login prompt, log in to the AEM CLI with your administrator user name
and password.
11. To verify the serial number, enter / system hardware
The serial number should match the one that you noted earlier in this procedure. If
the serial numbers do not match, then contact your account representative.

© NETSCOUT Confidential and Proprietary 6

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

Backing Up the AEM Data Before the Upgrade

Back up the data on the AEM guest VM. You might need this backup if you have problems
during the AEM upgrade.

To back up the AEM data:

1. Log in to the UI for AEM 6.9.0.0 with your administrator user name and password.
2. Select Administration > Backup.
3. On the Backup Settings page, in the Local Backups of AEM Configuration and Data
section, click Back Up Now.
4. When the backup finishes and appears in the Backups list, click its Download button
to download it to your computer.
5. Copy the backup file to a location that AEM can access.
6. Log out of the UI.

Downloading the AEM Upgrade Files

To download the AEM files:

1. To access the downloads page, go to https://my.netscout.com and log in with your

user name and password.
2. On the my.NETSCOUT home page, click LICENSING & DOWNLOADS on the top menu.
3. On the LICENSING & DOWNLOADS page, in the Security list, click Arbor Enterprise
Manager.
4. At the top of the Arbor Enterprise Manager page, select the version.
5. Scroll down the page, select Software Downloads, and then click Arbor Enterprise
Manager. Wait a few moments while your account is verified.
6. On the Product Information page for Arbor Enterprise Manager, select the General
Availability tab and then click the link for Arbor Enterprise Manager 7.0.0.0.
7. Click the links to download the following files to a location that the AEM guest VM can
access:
n The ArbOS upgrade package: arbos-7.3-XXXX-x86_64
n The AEM upgrade package: Arbor-Enterprise-Manager-7.0.0.0-XXXX-x86_64
n The AEM software image: Arbor-Enterprise-Manager-7.0.0.0-XXXX-x86_64-
serial.iso
XXXX = the product build number

Upgrading the AEM Guest VM to Version 7.0.0.0

Upgrade the AEM guest VM so that you can create a backup to restore on the native AEM
installation.

To upgrade the AEM guest VM to version 7.0.0.0:

1. On the AEM guest VM, log in to the CLI with your administrator user name and
password.

© NETSCOUT Confidential and Proprietary 7

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

2. Enter / system hardware and make a note of the serial number that the system
displays. You need this number to verify that it remains the same after the AEM guest
VM upgrade.
3. To copy the package files to the guest system, enter the following commands:
n / system files copy http://path/arbos-7.3-XXXX-x86_64 disk:

n / system files copy http://path/Arbor-Enterprise-Manager-7.0.0.0-

XXXX-x86_64 disk:
path = the full path to where you copied the files after you downloaded them
XXXX = the product build number
4. To verify that the files are in the correct location on the AEM guest VM, enter
/ system files show
5. To stop AEM services, enter / services aps-console stop
6. Enter config write
7. To uninstall your existing AEM, enter the following command:
/ system files uninstall Arbor-Enterprise-Manager-x.x.x.x
x.x.x.x = the version number to uninstall
8. To install the new ArbOS on the guest system, enter the following command:
/ system files install disk:arbos-7.3-XXXX-x86_64
XXXX = the product build number
9. Important
Before you reload the guest operating system in the next step, verify the serial
number by entering / system hardware
The serial number should match the one that you noted earlier in this procedure. If
the serial numbers do not match, then contact your account representative before
you proceed further.
10. To reload the guest operating system, enter reload now
11. When the reload finishes, install AEM version 7.0.0.0 by entering the following
command:
/ system files install disk:Arbor-Enterprise-Manager-7.0.0.0-XXXX-x86_
64
XXXX = the product build number
12. When the installation process finishes, enter / services aem start
13. Enter / system license show and make a note of the AEM license key. You need
this license key when you reinstall AEM later.
14. To save the configuration, enter / config write

Backing Up the AEM 7.0.0.0 Data

Back up the data on the AEM 7.0.0.0 guest VM so that you can migrate it to the native
installation.

To back up the AEM data:

1. Log in to the AEM guest VM UI with your administrator user name and password.
2. Select Administration > Backup.

© NETSCOUT Confidential and Proprietary 8

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

3. On the Backup Settings page, in the Local Backups of AEM Configuration and Data
section, click Back Up Now.
4. When the backup finishes and appears in the Backups list, click its Download button
to download it to your computer.
5. Copy the backup file to a location that AEM can access.
6. Log out of the UI.

Preparing the Appliance for Native AEM Installation

To prepare the appliance, you run flashinit. The flashinit process removes the ArbOS host
system and the guest VMs for AEM and EDM, and then loads the AEM software on the
appliance.

To reinstall from flash:

1. On the host system, log in to the AEM CLI with your administrator user name and
password.
2. To prepare for flashinit, copy the 7.0.0.0 serial.iso file to the host system by entering
the following command:
/ system files copy http://path/Arbor-Enterprise-Manager-7.0.0.0-XXXX-
x86_64-serial.iso disk:
path = the full path to where you copied the file after you downloaded it
XXXX = the product build number
3. Go to shell and enter the following commands to run flashinit:
a. shell
b. flashinit Arbor-Enterprise-Manager-7.0.0.0-XXXX-x86_64-serial.iso
XXXX = the product build number
The flashinit process takes a few minutes.
c. exit
4. In the host system CLI, enter reload now to reload the system.
5. While the system reloads, go to the next procedure and be prepared to start step 1 as
soon as the reload finishes.

Installing AEM Natively on the Appliance

After the system reload, you respond to the installation prompts and then use the AEM
CLI commands to finish the configuration.

Note
During this procedure, you must change the administrator password.

To install and configure AEM:

1. After the system reload, when the Press any key to continue prompt appears,
press a key within five seconds.
Important
If the system continues before you can press a key, then turn off the appliance and
start over.

© NETSCOUT Confidential and Proprietary 9

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

2. At the GRUB menu, press the up arrow key or down arrow key to stop the 10-second
countdown.
Important
If the system continues before you can stop the countdown, then turn off the
appliance and start over.
3. Select the following option on the GRUB menu and then press ENTER:
(re)install from on-board flash (Serial Console)
4. Enter y in response to the following prompt:
Do you want to begin the install process?
This will remove all current data and configuration [n]
The installation initializes the system, installs the software, and builds the databases.
These processes take some time.
5. When the installation processes finish, respond to the prompts as follows:

Prompt Description
System hostname? Enter a unique name to identify the AEM appliance on the
network. The system name must meet the following
requirements:
n It starts with a letter and ends with a letter or number.
n It contains any combination of letters, numbers, and
hyphens.
n It does not contain underscores or spaces.
n If it is a simple host name, then it contains no more than
63 characters and does not contain a period.
n If it is an FQDN, then it contains periods with no more
than 63 characters between each period, and no more
than 253 characters in total.
n The case matches all instances in which the system
name appears. We recommend lowercase letters.

Set admin To change the administrator password, enter y. At the

password? password prompts, enter the new password.

IP address for Enter the IP address for management port 0. For example:
interface mgt0 198.51.100.2 or 2001:DB8::2

Netmask for (IPv4 addresses only) Enter the netmask in dotted-quad

interface mgt0 format for management port 0. For example: 255.255.255.0

Media for Accept the default setting.

interface mgt0

IP address for Skip the configuration for interface mgt1 by pressing ENTER
interface mgt1 at this prompt and the next two prompts.

Default route Enter the IPv4 address for the default gateway. For
example: 198.51.100.1

© NETSCOUT Confidential and Proprietary 10

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

Prompt Description
{bgp | http | At each of these prompts, enter the IPv4 address range
https | ping | from which you want to allow communications to a service.
snmp | ssh} access For example: 198.51.100.0/24
from which To skip a prompt, press ENTER.
network?
For security reasons, AEM does not allow IP access rules
that specify numeric ports. If you enter an IP access rule for
0.0.0.0/0 or ::/0, then AEM displays a warning message and
prompts you to confirm the entry.
Caution
We strongly recommend that you do not use 0.0.0.0/0 or
::/0, because these address ranges allow unrestricted
access to a service. To restrict access, specify the
narrowest address range that you can.
After you pass through these prompts, a new SSH host key
file is generated.

DNS server IP Enter the IP address for your DNS server or press ENTER to
address skip this prompt.

Current time and Accept the default values or enter a new time and date in
date the format YYYY-MM-DD HH:MM:SS (year, month, day, hour,
minutes, seconds).

NTP server IP Enter the IP address for your NTP server or press ENTER to
address skip this prompt.

6. When you complete the prompts, wait for the system to reload.

Important
When the system restarts, do not press a key or respond to any other prompts until the
login prompt appears.

7. At the login prompt, enter the default user name of admin.

8. At the password prompt, enter the new admin password that you entered earlier in
this procedure.

Important
The license key command below is case sensitive. Enter the license key exactly as it
appears in the next step, including any spaces and punctuation.

9. Enter / system license set Pravail “APS-CONSOLE”license_key

license_key = the AEM license key that you noted in step 13 of the procedure
for “Upgrading the AEM Guest VM to Version 7.0.0.0” on page 7.
10. To verify the license key, enter / system license show
11. To initialize the AEM database, enter / services aem data init
12. When the initialization process finishes, go to “Restoring from the 7.0.0.0 Backup” on
the next page.

© NETSCOUT Confidential and Proprietary 11

 AEM Upgrade Guide for Appliances, Version 7.0.0.0

Restoring from the 7.0.0.0 Backup

This procedure requires access to the backup file that you downloaded to your computer
in “Backing Up the AEM 7.0.0.0 Data” on page 8.

To complete the installation:

1. Still in the AEM CLI, copy the backup file to AEM by entering the following command:
/ system files copy http://path/file_name
path = the path to which you copied the backup file after you ran the backup
file_name = the name of the backup file
2. To move the backup file to the backup directory, enter the following commands:
a. shell
b. mv APS_CONSOLE_BACKUP_202210192333 /base/data/backup/
c. exit
3. To restore the backup data, enter / services aem restore local
4. Respond to the system prompts as follows:
a. Enter the number that corresponds to the backup to restore.
b. Enter 3 to restore the configuration and data, but keep the current IP settings.
c. To confirm your choice, enter y
d. To restart the system with the configuration restored, enter y
5. After the system restarts, enter / services aem start
If a message with the error Module type unrecognized logged appears, you can ignore
it. This error is a known issue.

The AEM 7.0.0.0 upgrade is complete.

© NETSCOUT Confidential and Proprietary 12