AirWave Failover Guide 8.2.6
AirWave Failover Guide 8.2.6
6
AirWave Failover Guide
Overview
This guide describes how to configure the AirWave failover server to monitor your network. This guide also
describes using AirWave to manage the failover process.
Contacting Support
Before setting up your failover server, you must have completed the AirWave installation. For instructions on
how to install AirWave, refer to the AirWave 8.2.6 Installation Guide.
The setup workflow includes:
l "Adding the Failover License" on page 2
l "Upgrading the Software Version" on page 2
c. Enter y to enable AirWave to connect to a proxy server. Or, you can enter N to bypass this step and go to
step d on page 5 to download the software. At the next prompt:
(1) Enter the server address and port number (for example, test.proxy.com and port 22).
(2) Enter y to enter the proxy user name and password (for example, testuser and password).
(2) Enter 1 to upload the file from the AMP server to a source location using SCP to transfer the file.
(3) At the prompt, enter the location of the source file (for example, user@host:path. User is the name
of the account on the host computer, host is the hostname of the computer on which the source
file exists, and path is the location of the directory that contains the upgrade package).
Minimum Requirements
Ensure that you have sufficient disk storage, memory, and hardware or software versions. As additional features
are added to AirWave, increased hardware resources become necessary and hardware requirements vary by
version. For the most recent hardware requirements, refer to the AirWave 8.2.4 Server Sizing Guide on the Home
> Documentation page.
You can set up a failover server to monitor watched AirWave servers after you install the AirWave Failover
license. For information about installing licenses, see "Before You Begin" on page 1.
Master Console and Failover services require an access account to the managed AMPs. You typically add this
account into the Master Console and Failover local databases, and don't tie it to anyone’s personal access
account. As such, local database users don't respond to certificate authentication and fail when certificate
authentication is required. For more information, see "Disabling the Certificate Authentication Requirement"
on page 14.
The following sections will help you get started using AirWave server:
l "About the Failover Server" on page 7
l "Test the Failover Configuration" on page 8
l "Failover Monitoring" on page 11
Chapter 3
6. Click Add. The AirWave server you added displays in the Watched AMPs table, as shown in Figure 4.
These procedures will completely erase your existing AirWave installation and operating system and data from
your server. Any custom scripts, files, and backups MUST be saved to another server.
4. Configure the backup file transfer from the AirWave server to an external location:
a. Select 2 to configure the automatic transfer and press Enter.
b. Select 1 to set the backup destination and press Enter.
c. At the prompt, type the path of backup destination and press Enter.
d. At the prompt, type the password for the user account and Enter.
Failover Monitoring
AirWave Failover is a pared down version of AirWave. The starting point where you can monitor your network is
the Home > Overview page. The header statistics at the top of the page display the status of your network,
while the navigation pane on the left provides access to several pages.
Here are some of the tasks you can do from the WebUI:
l Add watched AirWave servers. On the Home > Watched AMPs page, click Edit to add an AirWave server to the
watched list. For more information, see "Adding a Watched AirWave Server" on page 8.
l Configure SNMP polling. On the Home > Watched AMPs page, click to change the HTTP timeout, polling interval,
and missed poll threshold. For more information, see "Setting the SNMP Polling Period" on page 12.
l Manage your AirWave licenses. For more information, see "Adding the Failover License" on page 2.
l Update your user information. For information about changing the settings on the Home > User Info page, refer to
the AirWave8.2.6 User Guide.
l Manage triggers. On the System > Triggers page, click Add to create the Watched AMP Down trigger. For help
creating a failover trigger, see "Watched AMP Down Trigger" on page 12.
l Acknowledge alerts. For information about viewing and acknowledging alerts on the System > Alerts page, refer to
the AirWave8.2.6 User Guide.
l Select a backup. For information, see "Backup Files and Rotations" on page 11.
The Watched AMP Down trigger displays in the Triggers table, as shown in Figure 12.
The Watched AMP Down trigger displays in the Triggers table, as shown in Figure 12.
CLI Access
A change introduced in AirWave 8.2.4 prevents the root user from being able to connect to the CLI. You can
access the CLI through an SSH connection by logging in to the AirWave server with the admin user created when
you install or upgrade your software to AirWave 8.2.4. or later. For information about the admin user, see the
AirWave 8.2.6 Installation Guide.
When the database is down and you access the CLI through an SSH connection, AirWave will skip the click
through agreement and advance to the AMP CLI menu.
3. Select 2 to upload the recovery key to another server using an SCP file transfer application.
4. At the prompt, enter the destination location for the file (for example, user@host:path. User is the name of
the account on the destination computer, host is the hostname or IP address of the computer on which the
file will be transferred, and path is the path of the destination folder).
5. At the prompt, enter the password on the destination computer.
11.Select 9 to open the Security menu, then select 2 to reset the ampadmin password.
12.At the prompt, type a new password and press Enter.
CLI Options
Table 1 lists the CLI commands that are available in AirWave 8.2.6. If there are other important tasks that you
can't do from the CLI, contact technical support for help.
Table 1: CLI Options
Option Description
1 Upload File Uploads a file to the AMP server you're currently logged in to using SCP for Unix.
2 Download File Downloads a file from the local AMP to another server using SCP for Unix.
3 Delete File Deletes a file from the AMP server. Files shown for deletion might include downloaded
files, temporary files, and backup files.
4-2 Configure Automatic Sets the destination for the nightly backup files.
Transfer
4-3 Local Backup Changes how many backups AirWave retains (maximum of 4).
Retention
5-1 AMP Restore Restores the AMP server from an on-demand, nightly, or imported backup that you select.
5-2 VisualRF Restore Restores the VisualRF database from the VisualRF backup that you select.
6-1 Show Tech Support Displays information about the AMP server to show technical support.
6-2 Generate Diagnostic Displays the compressed log collection for sending to customer support.
Tarball
6-3 Initialize Support Loads the support_connection.tar file provided by customer support and creates the
Connection support user (by default, awsupport) and password.
7-2 Upgrade OS Kernel Runs the kernel upgrade (requires rebooting the AMP server).
9-1 Reset Web admin Resets the Web UI log in password for admin.
Password
9-3 Add SSL Certificate Installs the SSL certificate, used to establish secure web sessions, on your AMP server.
9-4 Add DTLS Installs the DTLS certificates, used to encrypt secure AMON traffic, on your AMP server.
Certificates
9-5 Enable FIPS Toggles on or off FIPS 140-2 Approved Mode (reboot required action).
9-7-1 Show Displays the PGP key used to create a custom module.
10-1 Add New Menu Adds a new CLI menu module that you select (requires requesting module encrypted with a
Module module key from customer support).
11 VisualRF Restore Restores the visualrf_backup.pl file. Files shown for backup might include downloaded
files, temporary files, and backup files.
NOTE: If the STIG module is enabled on your system, this command option is unavailable.
12 Enter Commands Some read-only commands are available from this menu. To see a list of commands, type
a question mark (?) at the prompt. For more information, see Table 2.
NOTE: If the STIG module is enabled on your system, this command option is unavailable.
Table 2 lists the running enter commands that are available when you select 12 from the CLI.
Command Description
h <pattern> Displays history of all commands, matching the specified <pattern> input.
Command Description
r <number> Repeats the command, specified by the <number> from the history list.
date MMDDhhmm Changes the date and time on the AMP server.
wd <n> Displays the monitoring of running daemons, refreshing after the <n> interval.
psg <pattern> Displays the running processes, matching the <pattern> you typed.
pss <pattern> Displays the running processes like grep but shows more detailed information, matching
the <pattern> you typed.
show_tech_support Displays information about the AMP server to show technical support.
amp_backup Runs a backup and puts the file in the AMP CLI directory.
Command Description
dmidecode Displays the serial number of the AMP server. The serial number will display along with
BIOS information.
qlog enable <topic> Enables debugging. As files are created, they appear in the AMP CLI directory.
NOTE: If there is more than 1 qlog topic matching the substring, a numbered picklist will
be displayed. Enter the desired qlog topic number or multiple numbers separate by
spaces. You can give a unique prefix or a unique substring.
snoop <topic> Enables work queue snoop debug for the desired topics.
NOTE: You can give a unique prefix or a unique substring.
snoop stop <topic> Stops work queue snoop on the selected topic.
NOTE: You can give a unique prefix or a unique substring.
snoop stop all Stops all active work queue snoop debugging.