NAA Installation Guide

Server Requirements

Server Specification	Free version (upto 50 devices)	Mid size Network (50 – 1000)	Large size Network (1000 – 10000)
Minimum number of CPUs	1	2	4
Minimum memory	1024M	4G	8G
Minimum required storage*	16GB	100GB	500GB
Network Interfaces	1	1	1
Operating System	Ubuntu Server 22.04 LTS
If using AWS EC2 ... Instance Type recommendations	t2.micro (Free tier)	t3.medium	t3.xlarge
Inbound	SSH (TCP 22), HTTPS (TCP 443)
Outbound	Outbound Internet access for OS, software updates, license activation

Browser Requirement

An HTML5 compliant web browser. Chrome browser is preferred but not necessary.

Browser should have Internet connectivity for certain functions to work properly such as specifying devices groups’ geolocation on map.

Install NAA

Note that NAA comes with 25 devices license. You can double the free version to 50 devices by sending us a license request. You can also purchase new license to support more devices or enable add-on features. All paid licenses expire in 12 months unless other agreements are made. See section Import License.

You can install NAA with different methods. Pick one that fit your environment. Also, see Server Requirements for sizing recommendations.

Method 1 - On VMware ESXi with ova file
1. Download naa5-ESXi.ova to install to your VMware host.
  Note: If the file extension after download became .ovf, simply rename it back to extension .ova.
2. After the VM guest installation is completed, make changes that fit your network environment.
  Console to NAA server with default user and password.
  user: naa password: ironwood
3. Become root user with 'naa' user's default password.
  
  sudo su [sudo] password for naa: ironwood
4. Change user 'naa' default password
  
  passwd naa
5. Change IP, DNS information to fit your network environment by editing this file.
  nano /etc/netplan/00-installer-config.yaml
```
# This is the network config written by 'subiquity'
network:
  ethernets:
    ens160:
      addresses:
      - 192.168.1.22/24  <---
      nameservers:
        addresses:
        - 1.1.1.1  <---
        search:
        - mycompany.com  <---
      routes:
      - to: default
        via: 192.168.1.1  <---
  version: 2
                        
```
  Apply the network changes with command
  netplan apply
6. Set NAA server hostname
  
  hostnamectl set-hostname naa
7. Done. Reboot.
  
  reboot
8. Go to Login to NAA.
Note: The ova is provisioned for the size of Free version. If you need to support larger network, modify the VM's CPU, Memory, and Storage from your ESXi host as recommened in Server Requirements. Be sure to increase the Ubuntu partition size to recognize the expanded Storage disk space. Please contact support if you need help doing that.
Method 2 - On any Hypervisor or Bare Metal
1. Provision your Hypervisor or Bare Metal server to the size suggested in the Server Requirements
2. Download Ubuntu server iso file.
3. Pick "Option2 - Manual server installation", click "Download Ubuntu Server 22.04 LTS"
4. Save and use the file ubuntu-22.04-live-server-amd64.iso to build your NAA server.
5. Accept all default options, but note the followings...
  Select Ubuntu Server
  
  Set Static IP and network info that fit your network environment
  
  Setup server name and local user account
  
  Install OpenSSH server
  
  No additional package
6. After the Ubuntu installation is completed, be sure you can SSH into it with the local user you created.
7. Go to Run NAA Installation Script.
Method 3 - On AWS
1. For AWS, use the Amazon Machine Image named "Ubuntu Server 22.04 LTS". Select Instance Type, Storage. And edit the inbound Firewall rules after launched.
  For example...
  
  Edit inbound firewall rule after launched
2. After your AWS instance is up and running. be sure you can SSH into it.
3. Go to Run NAA Installation Script.
Run NAA Installation Script

If you use Method 2 or 3. Then so far you only have the Ubuntu OS installed. Now, you can install NAA to it.
1. SSH to NAA server and become root user.
  
  sudo su
2. Set NAA server hostname
  
  hostnamectl set-hostname naa
3. Download NAA installation script and run it.
  
  wget -P /root https://www.ironwoodnetworks.com/download/naa5/naa5_installscript chmod 744 /root/naa5_installscript /root/naa5_installscript
  
  If you see something similar to the following, just hit Enter and move on.
  or
4. Change user 'naa' default password
  
  passwd naa
5. Reboot after the script is finished.
  
  reboot
Login to NAA

Open a browser to https://<NAA IP> and login as admin user

user: admin
password: admin

If you are using Chrome and see the following and have no way to move on, it is because Chrome doesn't trust self-sign cert.
You need to add this cert to your computer's trusted cert list.
Or for temporary fix, just type thisisunsafe anywhere in the browser and move on.
Go to section Update NAA version.

Update NAA version

Please update NAA version immediately after installation.

Goto

System > Update
Method 1: Enable Auto update

Enable "Daily Auto Update" and select the hour of day to check for new update so that your NAA is always up-to-date.
Method 2: Update NAA Now

If your NAA is outdated. You can update NAA now.

Import License

Note that NAA comes with 25 devices license. You can double the free version to 50 devices by sending us a license request. You can also purchase new license to support more devices or enable add-on features. All paid licenses expire in 12 months unless other agreements are made. See section Import License.

Request new license
1. Login to NAA GUI as admin user
2. At the Side Menu
  System > License > Request License
3. Using your company email address, send to support@ironwoodnetworks.com with
  - your company name
  - total number of devices
  - the "Current license Info" on the screen

Our customer support will process a new license for you. You will receive a "License-ready" email meaning your license is now ready online. Please take note on the "Customer id" provided in the email.

Install the license
After receiving the "License-ready" email, your new license is ready online.
1. Login to NAA GUI as admin user.
2. At the Side Menu
  System > License
3. Enter the "Customer id" provided in the "License-ready" email
4. Click the "Install License Now" button to acquire the online license
5. Refresh your screen and you should see your new "Current license Info" on the screen.
6. Done import license.

Increase ESXi VM Capacity

If you are using ESXi OVA, it is sized for very small deployment (less than 50 devices) in the Free NAA version. If you want to increase the VM cpacity (Memory, CPU, Hard disk), follow this instruction.

Power off the VM
Go to "Edit Settings" of the VM. Resize the Memory, CPU, and Disk Space.

Note that you need to delete all snapshots of the current VM.
If you increased the VM’s Hard disk, you need to extend its OS's logical volume.

SSH to the server and become root user.
Note the root / file system still have the old size.
Use the "fdisk" utility to create a new partition.
Extend the root / partition. Be sure to use the appropriate Free size from the "vgdisplay" (eg.90G in this example) and the LV Path from the "lvdisplay" (eg. /dev/centos_naa/root) to the "lvextend" command.

Use "df –h" to confirm new root / size has increased.