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.

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.

1. 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.

2. 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.

3. 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.

4. 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

5. 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.
   

6. Go to section Update NAA version.

Please update NAA version immediately after installation.

1. Goto

   System > Update

2. 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.

3. Method 2: Update NAA Now

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

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.

1. 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.



2. 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.

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.

1. Power off the VM

2. 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.

   

   

   

3. If you increased the VM’s Hard disk, you need to extend its OS's logical volume.

1. SSH to the server and become root user.

   

2. Note the root / file system still have the old size.

   

3. Use the "fdisk" utility to create a new partition.

   

4. 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.

   

4. Done increasing ESXi VM capacity.