AirWave 8.2.15.0 Installation Guide

Download as pdf or txt
Download as pdf or txt
You are on page 1of 17

AirWave 8.2.15.

0
Installation Guide

This document is designed as a reference for installing AirWave 8.2.15.0 with the CentOS software
bundled with the ISO disc image. For upgrade instructions, see the AirWave 8.2.15.0 Release Notes.

Download Files
The table below describes the different files that you might see on the Support site when you download
AirWave. For more information, see the Upgrade Procedures in the Release Notes.

Table 1: Download Page File Types


File Type Descript ion

Install ISO Standalone installation media, including the CentOS operating system.
This image can fit on a CD/DVD, or it can be mounted as a virtual disk
for installation.

Install OVA (Virtual VMware OVA template for AirWave deployment on VMware ESXi
appliance) infrastructure. Optimized for deployments up to 100 devices.

NOTE: Install the OVA package for only testing in lab environments.

TAR package file Used forAirWave upgrades. The TAR package delivers updated security
packages and kernel updates.

NOTE: Contact Techical Support to help you upgrade the software if


your software is more than two versions old.

M inimum Support ed Browsers


AirWave supports the following browsers:
n Internet Explorer 11.0.9 or later on Windows
n Firefox 57.0 or later on Windows and macOS
n Chrome 65.0.3299.0 (64-bit) or later on Windows and macOS
n Safari 11.0.2 or later for macOS
n Microsoft Edge version 91.0.864.37 on Windows

Hardware Requirement s
AirWave supports any hardware that is Red Hat Enterprise Linux 7.9 or later. By default, all installations
are based on a 64-bit operating system.
If you're using the Central Ready HPE DL360 Gen10 appliance, the appliance ships with Unified Extensible
Firmware Interface (UEFI) as the boot environment instead of Basic Input/Output System (BIOS). For the
Pro HPE DL360 Gen9 and Enterprise HPE DL360 Gen9 appliances that use BIOS, the AirWave 8.2.15.0
install ISO includes a workaround that eliminates the need to replace BIOS in these appliances or boot in
Legacy BIOS.

AirWave 8.2.15.0 | Installation Guide Rev. 01 | August 2022


AirWave hardware requirements vary by version. As additional features are added to AirWave, increased
hardware resources become necessary. For the most recent hardware requirements, refer to the AirWave
8.2.14.0 Server Sizing Guide.

AirWave does not support downgrading to older versions. In unusual circumstances requiring that
you return to an earlier version of AirWave, we recommend you perform a fresh installation of the
earlier AirWave version, and then restore data from a backup taken before the upgrade.

Pre-Inst allat ion Checklist


Use this check list to ensure installation goes smoothly.

Table 2: Pre-Inst allat ion Checklist


Task Complet ed

Have available the AirWave license key sent to you in an email from Aruba.

Obtain dedicated server(s) meeting Aruba sizing specifications.

Determine the static IP address for each AirWave server.

Provision firewall and enable proper ports.

Determine WLAN infrastructure properties (type, quantity, and location).

Determine WLAN infrastructure access credentials (SNMP, telnet, SSH, etc.).

Determine WLAN security policy specifications.

Set router and switches to monitoring (optional).

Configure upstream NMS applications (optional).

Determine wireless client authentication servers (optional).

Determine AirWave administrative authentication servers like TACACS+, LDAP, or


RADIUS (optional).

Contact Techical Support to help you upgrade the software if your software is
more than two versions old.

Inst allat ion Workflow


This section provides step-by-step instructions to install Linux CentOS 7.9, configure the AirWave server,
and prepare your deployment.

St ep 1: Inst all Linux Cent OS 7.9


You must install Linux before you install AirWave on the network management system. The Linux CentOS
is installed automatically when the AirWave Installation DVD is inserted into the drive. Installing the
CentOS software takes 10 to 20 minutes to complete.

This procedure erases the hard drive(s) on the server.

2 AirWave 8.2.15.0 | Installation Guide


To install the Linux CentOS 7.9 operating system:

1. Insert the AirWave installation DVD into the drive and boot the server to start the installation UI, as
shown in Figure 1.
Figure 1 Installation UI

2. Type inst all and press Ent er.


3. To configure the partitions manually, type manual and press Ent er.
4. Allow the installation process to continue. Upon completion, the system reboots automatically.
5. Remove the DVD from the drive and store it in a safe location.

St ep 2: Configure t he Dat e and Time


AirWave 8.2.4 introduced a new, modular command line interface (CLI). After completion of installation,
you will no longer have root user access to the Linux shell, and you can no longer use legacy commands
to run AMP services.

Use only included or Aruba-specified cables, power cords, AC power supplies and batteries. Don't use
the power cord with other electrical equipment than what is specified by Aruba.

Follow these steps to perform a fresh install:

1. Press Ent er or wait six seconds. The system automatically loads the kernel.
2. When the kernel is loaded, log into the server using the following credentials:
n login = root
n password = admin

3. Configure the date and time for the AirWave server when the following message appears:
------------------------ Date and Time Configuration ------------------
Current Time: Mon June 27 12:14:02 PST 2020
1) Change Date and Time
2) Change Time Zone
0) Finish
a. Select 1 to set the date and select 2 to set the time zone. Press Ent er after each configuration to
return to the message menu above.

b. Select 0 to complete the configuration of date and time information, then press Ent er.

AirWave 8.2.15.0 | Installation Guide 3


St ep 3: Check Inst alled Soft ware
The installer automatically checks for an earlier version of AirWave. If your server has an earlier version
of AirWave installed, you'll see a message that asks you to reinstall AirWave.

This action erases the current database, including all historical information. To ensure that the AMP
database is backed up prior to reinstallation, answer n at the prompt and contact your Value Added
Reseller or Aruba support.

Wait for the installer to check that the database is up and running the current version.

St ep 4: Creat e t he Recovery User


During this step, AirWave configures the AMP CLI while creating the recover user account. At the prompt,
enter a user name for the recovery user. If you don't enter a username, AirWave uses the default
recovery user, called "amprecovery".

You can change the password later from the AMP CLI by selecting 5 to open the Users menu, then 2-2
to change the CLI user password for the "amprecovery" user. For more information, refer to the
AirWave 8.2.15.0 User Guide.

St ep 5: Creat e t he Admin User


At the prompt, enter a user name and password for the admin CLI user account. If you don't enter a user
name, AirWave uses the default admin user, called "ampadmin".

n You can change the password later from the AMP CLI by selecting 5 to open the Users menu, then 2-
1 to change the CLI user password for the "ampadmin" user. For more information, refer to the
AirWave 8.2.15.0 User Guide.

n Save your user name and password somewhere safe because you'll need them to log in to the CLI.

St ep 6: Configure t he Net work


If the installer only detects one interface, it will call that interface eth0. The following example shows how
to configure the default eth0 interface. If you want to configure additional interfaces, repeat this step for
each interface.

For networks using a Gen-10 Central On-Premises server, configuration on a 10G interface is not
supported if an external 10G NIC(PCIe) is present. In this case, ensure that the Ethernet configuration
is done on 1G interface. However, 10G interface is supported with SFP Transceivers.

The SFP and SFP+ transcievers are used for cabling the Gen-10 servers and are not monitored in
AirWave.

Connect the following cables to the correct ports based on the figure below:
n Connect an Ethernet cable to the iLO port and to the switch which has DHCP IP.
n Connect another Ethernet cable to the eth0 port which is the Ethernet port.
n Connect a monitor to the VGA port on the server to see the iLO IP Address.

4 AirWave 8.2.15.0 | Installation Guide


n Connect a key board to the server to setup the server.
n Once the server is powered on and the cables connected to iLO and eth0, reboot the server using the
power button or unplug and plug the power cable. The monitor displays the iLO IP address assigned by
the DHCP server.

Following network interfaces are supported:

Enter the IPv4 static IP address, subnet mask, and gateway addresses when the following message
appears:
AirWave must be configured with a static IP.
Here are the ethernet interfaces with hardware present:
1. eth0 default 08:df:37:c4:57:b0
2. eth1 08:df:37:c4:57:b1
3. eth2 08:df:37:c4:57:b2
4. eth3 08:df:37:c4:57:b3
5. eth4 48:df:37:c4:57:b0
6. eth5 48:df:37:c4:57:b8
q. Quit

Which interface shall we configure?

a. Select 1 and press Ent er.


------ Network Interface Configuration for eth0 -----
1) IPv4 Address : xx.xx.xx.xx
2) IPv4 Netmask : xx.xx.xx.xx
3) IPv4 Gateway : xx.xx.xx.xx
4) IPv6 Address (optional) : xxx.xxx.xxx.xxx
5) IPv6 Gateway (optional) : xxx.xxx.xxx.xxx
6) Primary DNS : xx.xx.xx.xx
7) Secondary DNS : xx.xx.xx.xx
8) Set as default interface : y
9) Commit Changes
0) Exit (discard changes)

b. Select 1 to enter the network information, then press Ent er.


c. Select 2 to enter the subnet mask, then press Ent er.
d. Select 3 to enter the gateway, then press Ent er.
e. Select 6 to enter the primary DNS address, then press Ent er.
f. Select 8 to set the default interface, then press Ent er.
g. To commit the changes, type 9 and then press Ent er. To discard the changes, type 0 and then
press Ent er.
h. To restart the network with the configured settings, type y.

St ep 7: Generat e an SSL Cert ificat e


To generate the SSL certificate for the AirWave server:

AirWave 8.2.15.0 | Installation Guide 5


n If AirWave does not have a valid host name on the network, type n.
n If AirWave has a valid host name on the network, type y and enter the fully qualified domain name for
the AirWave server (for example, myserver.example.com)

After installing AirWave, you can install a new SSL certificate, or generate a CSR to install a signed
certificate from the AMP CLI.

St ep 8: Complet e t he Inst allat ion


Upon completion of all previous steps, the following message appears.
CONGRATULATIONS! AMP is configured properly.
To access the AMP web console, browse to https://<IP Address>
Login with the following credentials:
Username: admin
Password: [User-provided password from above for 'ampadmin' user]

Once you log out, the root user will be disabled. Subsequently, you must use the ampadmin user
generated during the software installation to log in to the CLI.

n To view the Phase 1 installation log file, type cat / root / inst all.log.
n To view the Phase 2 installation log file, type cat / root / amp-inst all.log.

Inst all AirWave on a Virt ual M achine


The following sections provide information to help you installAirWave on VMware® ESX(i).
n VMware Requirements
n Creating a VMware Virtual Machine

VM ware Requirement s
AirWave supports VMware ESX(i) 6.5 and later. To be sure that enough resources are allocated to the
virtual machine, consult the AirWave 8.2.14.0 Server Sizing Guide.
If your VM host is hosting other instances, ensure that the AirWave instance has the highest priority. A
virtual SCSI disk is recommended over IDE.

Creat ing a VM ware Virt ual M achine


The VMware Infrastructure Client provides a wizard to create a new virtual machine. The resulting virtual
machine acts like physical host, in which you install the AirWave software.
The recommended OS is CentOS 7.9 or later (64-bit). Refer to the AirWave 8.2.14.0 Server Sizing Guide for
memory and storage requirements.
To create a virtual machine:

1. From the VMware Infrastructure Client, select Creat e a new virt ual machine.
2. Select Next , and then select Typical > Virt ual M achine Configurat ion.
3. Name your virtual machine (for example, AirWave), and then click Next .

6 AirWave 8.2.15.0 | Installation Guide


4. Select an available datastore with sufficient space for the number of APs that your AirWave will
manage, choosing the right server hardware to comply with the hardware requirements. Click
Next .
5. Select the Linux radio button, and then select the OS. Click Next .
6. Select the appropriate number or processors, and then specify the minimum virtual RAM.
7. Accept the VMware default virtual network adapter, and click Next .
8. Allocate a virtual disk large enough to contain the AirWave operating system, application, and data
files.
9. Review the virtual machine settings, and then click Finish when you are done.

Inst all AirWave Using Hyper-V


The following sections provide information to help you install AirWave on a virtual machine running a
Hyper-V:
n Hyper-V Requirements
n Adding the Hyper-V Network Adapter

Hyper-V Requirement s
AirWave supports using Hyper-V Manager on:
n Windows Server 2003 or later.
n Windows Server 2012 R2. You might experience boot issues using Windows Server 2012 Standard (not
R2).

AirWave does not support a Hyper-V Generation 2 VM

Adding t he Hyper-V Net work Adapt er


When you create the virtual machine in Hyper-V Manager, you must configure a virtual network adapter
in order to install AirWave. Hyper-V provides two virtual network adapters: a default and a legacy adapter
(for generation 1 virtual machines). If you use the legacy network adapter to establish networking, you
might experience connectivity issues even though there are no resource constraints on the server.
To add the Hyper-V network adapter:

1. Open Hyper-V Manager, then connect to the Hyper-V host.


2. Right-click the virtual machine and select Set t ings.

AirWave 8.2.15.0 | Installation Guide 7


3. From the Add Hardware window, select Net work Adapt er then click Add.

4. View the adapter properties, and click OK.


5. Click OK.

Inst all AirWave on a KVM Virt ual M achine


The following sections provide information to help you install AirWave on a KVM:
n KVM Requirements
n Creating a KVM Virtual Machine

KVM Requirement s
The recommended OS is CentOS 7.9 or later (64-bit). Refer to the AirWave 8.2.14.0 Server Sizing Guide for
memory and storage requirements.

Creat ing a KVM Virt ual M achine


To create a KVM virtual machine:

1. On the local host, type virt manager to run the New VM wizard.
2. Type a name for the virtual machine, select Local inst all media (ISO image or CDROM ), and then
click Forward.
3. Click Browse to find the ISO image. Select Linux and Red Hat Ent erprise Linux 7 from the drop-
down menus, then click Forward.

8 AirWave 8.2.15.0 | Installation Guide


4. Assign memory to the KVM and CPUs, then click Forward.
5. Assign disk storage, enable the Allocat e ent ire disk now option, and then click Forward.
6. Before you start the installation, under the Advanced options, select the Host device and enter the
fixed MAC address of the bridge (typically br0) into the text box.

7. Click Finish. The Virtual Machine Manager creates the virtual machine and opens the AirWave
console.

AirWave 8.2.15.0 | Installation Guide 9


Upgrade t o Airwave 8.2.14.0 in Aruba Cent ral (on-premises)
Server
If you are performing a fresh installation of AirWave 8.2.14.0 on Aruba Central (on-premises) servers,
interfaces on the Aruba Central (on-premises) server will always be in the following order:
n eth0- eth3 – 1G interfaces
n eth4 and eth5 - 10G interfaces
If you are upgrading from a prior AirWave version to AirWave 8.2.14.0 on Aruba Central (on-premises)
servers, the following message is displayed.

Perform the following steps on Aruba Central (on-premises) server Gen10 server with both 1G and 10G
interfaces only.

1. Run upgrade to AirWave 8.2.15.0.


2. Post upgrade, run int finorder, reboot, and configure network setup by entering the following
options in AMP CLI:
a. Enter option 8 - Advanced.

b. Enter option 1 - Cust om Commands.

c. Enter option 2 - Ent er Commands.

d. This will run the enter commands, execute $ int finorder

e. Click y when prompted with Do you want t o cont inue (y/ N)? : message.

10 AirWave 8.2.15.0 | Installation Guide


3. Type exit and navigate to the CLI prompt and select option 4 – Syst em and then, select option 4 -
Reboot Syst em to reboot the system.

4. If you lose connection to Aruba Central (on-premises) server post step 3, login to the ILO/console
of the server and navigate to the CLI prompt, and select option 3 – configurat ion and opt ion 1-
Configure Net work Set t ings.

5. Select the proper network interface and configure the IP address for your AMP and commit the
changes. The AMP should be reachable with the IP address configured.
This will enable reliable ordering of interfaces in upgrade scenario that is, eth0 - eth3 mapped to1G
interfaces and eth4 -eth5 mapped to 10G interfaces at the end. Once interfaces are set in proper
order, future AMP upgrades will be smooth. The intfinorder script should be run mandatorily from
the AMPCLI menu as described above for users using Aruba Central (on-premises) server after
upgrading to 8.2.14 build.

Get t ing St art ed


When you start using AirWave for the first time, perform the following steps:

AirWave 8.2.15.0 | Installation Guide 11


n Log in to the WebUI
n Change the Language
n Install the License
n Change the Default User

Refer to the AirWave 8.2.15.0 User Guide for complete details on configuring AirWave.

Log in t o t he WebUI
AirWave comes with a default user account with the user name "admin" and password "admin". In order
to log in to the WebUI for the first time, you have to log in as the default user.
To access the AirWave WebUI:

1. Enter the AirWave IP address (IPv4 or IPv6) or hostname in the address bar of any browser.
2. Enter the default user name and password: admin and <ampadmin password>.
3. Click Log In.

Change t he Language
You can change the language of the buttons, menus, and tabs in AirWave. You'll see the available
languages at the bottom of the Login window. Look for the language that you want and select it.
If you want to change a language again, you must log out of AirWave and reopen the Login window.

Inst all t he License


The first page to appear after you initially log in is the Home > Overview page. If you have more than
one license to install, repeat this procedure for each license.

12 AirWave 8.2.15.0 | Installation Guide


AirWave pages are protected via SSL. Some browsers will display a confirmation dialog for your self-
signed certificate. Signing your certificate will prevent this dialog from displaying.

To install the AirWave license:

1. On the License page, paste the AirWave license key you received into the license field on this page.
2. Cick Save.
3. In the AirWave licensing agreement, click I Accept to agree to the license terms and apply the
license key.

Change t he Default User


For security reasons, it's a good idea to change the default user name and password. You can do this
from the AM P Set up > Users page. Refer to the procedure Creating AirWave User Roles in the AirWave
8.2.15.0 User Guide for additional information.

AirWave 8.2.15.0 | Installation Guide 13


Appendix A

Communicat ion Prot ocols and Port s


The following table itemizes the communication protocols and ports necessary for AirWave to
communicate with wireless LAN infrastructure devices, including access points (APs), controllers,
routers, switches, and RADIUS servers. Assign or adjust port usage on the network administration
system as required to support these components.

Table 3: AirWave Prot ocol and Port Chart


Dat a Flow
Port Type Prot ocol Descript ion Device Type
Direct ion

21 TCP FTP Firmware distribution > APs or controllers

22 TCP SSH Configure devices > APs or controllers

22 TCP SSH Configure AirWave < Laptop or workstation


from the CLI

22 TCP VTUN Support connection > Aruba supports home


(optional) office

22 TCP SCP Transfer configuration < APs or controllers


files or FW

23 TCP Telnet Configure devices > APs or controllers

23 TCP VTUN Support connection > Aruba supports home


(Optional) office

25 TCP SMTP Support email > Aruba supports email


(optional) server

49 UDP TACACS AirWave Administrative > Cisco TACACS+


Authentication

53 UDP DNS DNS lookup from > DNS Server


AirWave

69 UDP TFTP Transfer configuration < APs or controllers


files or FW

80 TCP HTTP Configure devices > Legacy APs

80 TCP VTUN Support connection > Aruba supports home


(optional) office

161 UDP SNMP Get and Set operations > APs or controllers

162 UDP SNMP Traps from devices < APs or controllers

162 UDP SNMP Traps from AirWave > NMS

AirWave 8.2.15.0 | Installation Guide 14


Dat a Flow
Port Type Prot ocol Descript ion Device Type
Direct ion

443 TCP HTTPS Web management < Laptop or workstation

443 TCP HTTPS WLSE polling > WLSE

443 TCP VTUN Support connection > Aruba supports home


(optional) office

1701 TCP HTTPS AP and rogue discovery > WLSE

1741 TCP HTTP WLSE polling > WLSE

1812 UDP RADIUS Auth Authenticate & > RADIUS auth server
authorize AirWave
administrative users on
a RADIUS server.

1813 UDP RADIUS Retrieve user names < RADIUS accounting client
accounting for authenticated
WLAN clients from NAS
(captive portal,
controller, autonomous
AP). Only used when
user names are not
available in the SNMP
MIB of a controller or
autonomous AP.

2002 TCP HTTPS Retrieve client > ACS


authentication info

5050 UDP RTLS Real Time Location < Aruba thin APs
Feed

8211 UDP PAPI Real Time Feed (AMON) <> WLAN controllers

ICMP Ping Probe > APs or controllers

AirWave 8.2.15.0 | Installation Guide | 15


Terminology Change
As part of advancing HPE's commitment to racial justice, we are taking a much-needed step in
overhauling HPE engineering terminology to reflect our belief system of diversity and inclusion. Some
legacy products and publications may continue to include terminology that seemingly evokes bias
against specific groups of people. Such content is not representative of our HPE culture and moving
forward, Aruba will replace racially insensitive terms and instead use the following new language:

Usage Old Language New Language

Campus Access Points + Controllers Master-Slave Conductor-Member

Instant Access Points Master-Slave Conductor-Member

Switch Stack Master-Slave Conductor-Member

Wireless LAN Controller Mobility Master Mobility Conductor

Firewall Configuration Blacklist, Whitelist Denylist, Allowlist

Types of Hackers Black Hat, White Hat Unethical, Ethical

16 | AirWave 8.2.15.0 | Installation Guide


Cont act ing Support
Main Site arubanetworks.com

Support Site asp.arubanetworks.com

Airheads Social Forums and Knowledge community.arubanetworks.com


Base

North American Telephone 1-800-943-4526 (Toll Free)


1-408-754-1200

International Telephone arubanetworks.com/support-services/contact-support/

Software Licensing Site lms.arubanetworks.com

End-of-life Information arubanetworks.com/support-services/end-of-life/

Security Incident Response Team (SIRT) Site: arubanetworks.com/support-services/security-bulletins/


Email: [email protected]

www.arubanetworks.com
6280 America Center Drive
San Jose, CA 95002
Phone: 1-800-WIFI-LAN (+800-943-4526)
© Copyright 2022 Hewlett Packard Enterprise Development LP
Fax 408.752.0626

17 AirWave 8.2.15.0 | Installation Guide

You might also like