AvL Technologies AAQ Maintenance Server Manual instruction

AAQ Maintenance Server
Setup & Operations Guide
Revision R11.9.0
Documentation of the interface between the AAQ Maintenance Server and the
AvL Technologies AAQ antenna controller.
Appendix T
AvL Technologies
900-159-019

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
1
Revision History
Contents
1. Introduction ................................................................................................................................................................................................................................3
2. Software version .......................................................................................................................................................................................................................3
2.1 ROM Version Information...................................................................................................................................................................................................3
2.2 Maintenance Server Version Information ...................................................................................................................................................................4
3. Overview.......................................................................................................................................................................................................................................4
4. Commands....................................................................................................................................................................................................................................7
4.1. Networking Information ............................................................................................................................................................................................7
4.2 Networking Configuration .......................................................................................................................................................................................7
4.3 Backup Management ...................................................................................................................................................................................................8
4.4 Miscellaneous Commands .........................................................................................................................................................................................8
5. Software Update Package......................................................................................................................................................................................................9
6. File Transfer Protocol (FTP) Server .................................................................................................................................................................................9
7. Software Update Procedure .............................................................................................................................................................................................. 11
7.1 Using Windows Explorer ................................................................................................................................................................................................. 11
7.2 Using the AAQ GUI............................................................................................................................................................................................................... 13
7.3 Using Other FTP (FileZilla).............................................................................................................................................................................................. 14
7.4 Using Other FTP (WinSCP).............................................................................................................................................................................................. 17
7.5 Format for Splitting the Software Update File........................................................................................................................................................ 19
8. Applying Restore Point Procedure................................................................................................................................................................................. 19
9. Issues and Troubleshooting .............................................................................................................................................................................................. 20
Date
Revision
Revision
By
Approved
By
Revision Description
05/04/16
R11.6.0
WL
Initial Release for 11.6
11/07/16
R11.8.0
VAD
MF
Updated for Current Functionality, added
approved by in revision history
05/01/17
R11.9.0
WL/AY
JF
Updates for version 11.9, Added more
ways to upload software updates

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
2
Figures
Figure 1 –ROM Version Information .........................................................................................................................................................................................3
Figure 2 –AAQ Maintenance Server Version Information ...............................................................................................................................................4
Figure 3 –Maintenance Server > Help (List of Commands) ............................................................................................................................................5
Figure 4 –Maintenance Server > Help (List of Commands) Cont. ................................................................................................................................6
Figure 5 - Update_Log.log Example Entry................................................................................................................................................................................9
Figure 6 - Restore Point Transitions ....................................................................................................................................................................................... 10
Figure 7 - Windows Explorer FTP Access ............................................................................................................................................................................. 11
Figure 8 - Windows Explorer...................................................................................................................................................................................................... 12
Figure 9 - Searching for Antenna Software in Windows Explorer............................................................................................................................. 12
Figure 10 –Upload *.sup File in Windows Explorer ........................................................................................................................................................ 13
Figure 11 - Upload/Download in AAQ GUI ........................................................................................................................................................................... 13
Figure 12 - AAQ GUI Pop up Message ..................................................................................................................................................................................... 14
Figure 13 - New Site FileZilla...................................................................................................................................................................................................... 14
Figure 14 - Login FileZilla ............................................................................................................................................................................................................ 15
Figure 15 - FileZilla Password.................................................................................................................................................................................................... 15
Figure 16 - Software Update Using FileZilla ........................................................................................................................................................................ 16
Figure 17 - Start New Session in WinSCP.............................................................................................................................................................................. 17
Figure 18 - Login Credentials ..................................................................................................................................................................................................... 17
Figure 19 - File Transfer WinSCP.............................................................................................................................................................................................. 18

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
3
1. Introduction
This document describes the concepts required to use the AvL Maintenance Server and the procedure
required to perform a software update for the AvL AAQ Controller. The AvL Maintenance Server allows telnet
and FTP access to the controller for uploading new software, changing IP addresses, and creating restore
points. It is beneficial to use the AvL Maintenance Server because it allows system changes to be applied
remotely across a customer network. Thus, the user has the ability to make changes to multiple antennas at
once. This document also provides a detailed discussion of the associated command items that are accessible
through File Transfer Protocol (FTP) and Telnet sessions to the AvL AAQ Controller.
2. Software version
2.1 ROM Version Information
Version Info
Main Window → Help → Version Info.
Level 0
Verify that the “AAQ.rom” line item is at or above the version shown below:
Figure 1 –ROM Version Information

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
4
2.2 Maintenance Server Version Information
Using a Telnet client, such as Putty, access the AAQ Maintenance Server to verify that the version is at or above the one
below. For more information on how to access the AAQ Maintenance Server, see section 3.
Figure 2 –AAQ Maintenance Server Version Information
3. Overview
The AAQ Maintenance Server is a separate application that allows Telnet access to the antenna system. The
Maintenance server allows users to access some useful networking commands in order to debug and configure
the system. It also watches over the main AAQ process to ensure it continues running and restarts the process
in the event of an error or crash. The server can be accessed through any terminal program that supports
telnet, such as Putty or TeraTerm. The server uses the default telnet port of 23. The Maintenance Server is set to
run whenever the AAQ is powered up.

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
5
The AAQ Maintenance Server includes a software update method through File Transfer Protocol (FTP). The AvL
software update procedure allows for full system updates to be performed by loading an update file or files into
the AvL AAQ Controller, and re-booting the system. This method may be used to update any software
component of the AvL AAQ Controller system. This procedure requires that an appropriate upgrade file has
been provided by AvL, and that the user is familiar with the use of a File Transfer Protocol (FTP) client.
Below is a detailed list of all available commands that can be run on the AAQ Maintenance Server system.
Although many of these commands share names with Linux system commands, they do not currently allow extra
flags or parameters unless specifically mentioned in this list. Command parameters are denoted by “<>”.
Figure 3 –Maintenance Server > Help (List of Commands)

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
6
Figure 4 –Maintenance Server > Help (List of Commands) Cont.

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
7
4. Commands
4.1. Networking Information
These commands do not change any configuration and only provide information to the user.
Command Name
Description
route
Displays the Kernel IP routing table
netstat
Displays network connections, routing tables, interface statistics, masquerade
connections and multicast memberships.
ifconfig
Displays the status of the currently active interfaces.
ping<IP Address>
Sends a set of 4 ping packets from the controller to the requested <IP
Address> and displays the results.
Note –Cannot ping antenna IP in use.
4.2 Networking Configuration
These commands change files or settings on the system, or otherwise alter the system. Most commands will
have a response indicating whether or not the change was successfully applied.
Command Name
Description
setAddr1 <IP Address>
Sets the AAQ customer network 1 IP Address, enter 'clear' instead of an IP
Address to clear this setting
setGateway1 <IP Address>
Sets the AAQ customer network 1 Gateway, enter 'clear' instead of an IP
Address to clear this setting
setSubnet1 <IP Address>
Sets the AAQ customer network 1 Subnet, enter 'clear' instead of an IP
Address to clear this setting
setAddr2 <IP Address>
Sets the AAQ customer network 2 IP Address, enter 'clear' instead of an IP
Address to clear this setting
setGateway2 <IP Address>
Sets the AAQ customer network 2 Gateway, enter 'clear' instead of an IP
Address to clear this setting
setSubnet2 <IP Address>
Sets the AAQ customer network 2 Subnet, enter 'clear' instead of an IP
Address to clear this setting
enableDHCP
Commands the AAQ system to use DHCP to determine its IP address
disableDHCP
Disables the usage of DHCP on the AAQ system

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
8
4.3 Backup Management
These commands allow the user to manage the backups that are stored on the system
Command Name
Description
restoreBackup1
Reverts to the most recent system restore point. Requires a power-
cycle/reboot afterward. This will create a new Restore Point 1, move the old
Restore Point 1 to Restore Point 2, and delete the old Restore Point 2 before
it reverts to the backup.
restoreBackup2
Reverts to the second-most recent system restore point. Requires a power-
cycle/reboot. This will create a new Restore Point 1, move the old Restore
Point 1 to Restore Point 2, and delete the old Restore Point 2 before it reverts
to the backup.
restoreFactory
Reverts to the factory default software. Requires a power-cycle/reboot
afterward. This will create a new Restore Point 1, move the old Restore Point
1 to Restore Point 2, and delete the old Restore Point 2 before it reverts to
the backup.
createRestorePoint
Takes the current set of software on the system and saves it as Restore Point
1. The old Restore Point 1 is moved to restore point 2. The old Restore Point 2
is deleted.
Note: Anytime the system is restored to a backup copy or a software update is performed, a new restore
point is created and saved as Restore Point 1. The previous Restore Point 1 is moved to Restore Point 2. The
previous Restore Point 2 is deleted. If long term storage of a Restore Point is desired, it should be copied
from the controller using a File Transfer Protocol (FTP) client.
4.4 Miscellaneous Commands
These give basic controls over the system
Command Name
Description
help
Displays a list of all commands in the Maintenance Server system, similar to
the list of commands in this document
setTelnetTimeout <integer>
Sets the Telnet session timeout (in seconds). If no messages are received after
this time the session will automatically be closed. Set the timeout to 0 to
disable this feature. The default value is 600 (10 minutes)
version
Displays the build number of this Maintenance Server
reboot
Reboots the AAQ system, this will also close your connection to the system
Note: This is a soft reboot. It is not the same as Power Cycling the antenna
exit
Closes the current Telnet session
enableWatchdog
Enables usage of the AAQ watchdog. The AAQ watchdog automatically
restarts the AAQ software in the event of a crash or error.
disableWatchdog
Disables the AAQ watchdog

AAQ Maintenance Server
AvL Technologies | Proprietary –Content is Subject to Change without Notice
9
5. Software Update Package
An AvL software update requires that a pre-constructed Software Update Package (extension *.sup) is available
for installation onto the system. This file must be acquired from AvL. A Software Update Package is an
encrypted collection of software and scripts used to apply all required updates to the AvL AAQ Controller
system.
6. File Transfer Protocol (FTP) Server
To facilitate software update actions, the AvL AAQ Controller hosts a File Transfer Protocol (FTP) server on the
standard TCP port 21. This server requires the login credentials detailed in Table 1.
Table 1: FTP Login Credentials
Username:
avlftp
Password:
avlftp
The FTP server supports both active and passive transfer modes, and contains two read only, and one read/write
directory as noted in Table 2.
Table 2: FTP Directory Permissions
Directory Name
Access Level
Logs
Read Only
Restore_Points
Read Only
Software_Updates
Read/Write
The “Logs” directory contains a single log file “Update_Log.log” that summarizes all software update or system
restore activities that have been performed on the controller since it left the factory. It also contains detail logs
for each uniquely named software update package or restore point that has been applied to the controller.
These detail logs will show exactly what was included in the update or restore point. An example of the
Update_Log log is described in Figure 4 and can be used to verify a successful upgrade.
Figure 5 - Update_Log.log Example Entry