Ixia Hawkeye 2.4 Release Notes Version 2.4.9.

Ixia Software Release Notes

Hawkeye 2.4-EA
Build Number: 2.4.9.7 (FEB 28, 2018)
 About This Release
 Installation Notes
 First Time Installation of Hawkeye Server 2.4
 Upgrading Hawkeye
 New License Installation
 What's New in Hawkeye 2.4 ?
 Known limitations and issues
 Fixed in this release
 How to Report Problems

About This Release

Hawkeye Server 2.4 EA is an "Early Adopter" release. This release includes major product updates and key
features. This release requires careful upgrades to migrate from Hawkeye 1.0 (or 1.1) to 2.4. Please review this
release note in it’s entirely, including the migration guide before starting deployment of Hawkeye 2.4.

Installation Notes
- Hawkeye 2.4 management system has a web user interface, and requires no client side installation.
- The management server is distributed as a virtual image in OVA and can be deployed to a VMware hypervisor.
- Migration from an existing Hawkeye 1.0 or 1.1 requires careful planning, please be sure to read and fully
understand the steps outlined in the migration guide.
- Contact Ixia support if you prefer our technical support staff’s assistance in migrating your system.

© 2010-2018 Ixia Page 1 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

First Time Installation of Hawkeye Server 2.4

Support for Virtualization Products

The Hawkeye 2.4 virtual image can be deployed to:

- VMware Player 6 or 7
- VMware Workstation 10, 11 or 12 (qualified w/ 12.0.1)
- VMware Fusion 6 or 7
- VMware ESXi 5.5 or 6.0 (qualified w/ 5.5)

The Hawkeye virtual image requires 64-bit support from the host operating system or from the hypervisor. The
CPU virtualization instructions (e.g. Intel VT-x, AMD-V) must be supported and enabled.

While importing the virtual image, it is possible to get compatibility warning messages. If this happens, please
ignore them and continue the import operation.

System Specifications for the Hawkeye Server

Minimum system configuration varies based on number of concurrent

users and usage. Following are guidelines, use the recommended configurations for best performance:

No of concurrent Users No of endpoints Minimum Requirements Recommended

2 25 2 vCPU, 4GB RAM 4 vCPU, 8GB RAM

5 100 4 vCPU, 8GB RAM 6 vCPU, 16GB RAM
10 400 6 vCPU, 16GB RAM 8 vCPU, 24GB RAM

Supported Browsers

Hawkeye 2.4 EA user interface can be accessed from most browsers that support HTML5 on Windows, OS X and
Linux platforms:

- Google Chrome v53 or higher;

- Internet Explorer 11;

© 2010-2018 Ixia Page 2 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

Initial Network Configuration

A newly created Hawkeye 2.4 EA virtual machine will attempt to obtain an IP address through DHCP. If a DHCP
server is not available in your environment or does not respond within 30 seconds, Hawkeye 2.4 EA will use a static
IP address: 192.168.0.200.

If a DHCP server is not available and the predefined static IP is not reachable from your network, you will need to
set a new IP address manually by following these steps:

1. Gain access to the CentOS CLI, by using the VMware console to the Hawkeye server VM, or by connecting with
SSH.
2. Login to CentOS as root. The default root password is "ixia123".
3. Edit /etc/sysconfig/network-scripts/ifcfg-eth0 and set a valid IP address
BOOTPROTO=None
IPADDR=a.b.c.d
NETMASK=g.h.i.j
GATEWAY=k.l.m.n
4. Edit /etc/resolv.conf and enter one or more nameservers
nameserver a.b.c.d
5. Restart the Hawkeye system network: service network restart
6. After the server is restarted, you can use the web interface (accessible on the new IP address) to manage the
networking part of the system. Change the Hawkeye server hostname by using ssh to server and enter the
following command:
cd /home/ixia/Hawkeye
./ixia_network_config.sh -fh <yourHawkeyeServerHostname>

Upgrade Hawkeye
Hawkeye upgrade from 6.80 to 2.<latest version>
To upgrade Hawkeye 6.80 or IxChariot Pro contact Ixia Customer Support. Also contact Ixia Customer support for
upgrading XR2000 and XRPi containing images older than 9.10k.

Upgrade Hawkeye 1.x to 2.x <latest version>

This section explains how to upgrade from Hawkeye 1.x to the latest version.

You can upgrade only if you have Hawkeye installed previously and are upgrading to the next version on the Linux
platform.

© 2010-2018 Ixia Page 3 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

Create a database backup of Hawkeye 1.x

Hawkeye 2.0+ is upgraded to MySQL 5.7, this is done for optimized SQL queries. It is recommended that you follow the
guidelines listed below to make sure that the integrity of the database is retained if you are using Hawkeye version 1.0 or
1.1.

If you do not follow the database backup procedure you will lose all the data. The steps below uses a utility included in
2.x release but run while 1.x Hawkeye Server is running to backup your 1.x database.

To take a backup of the database, do the following:

1. Download the Hawkeye_2.x.x.x_Full.tgz script from the Ixia website and place it in the /tmp directory of the
server where you want to install.
2. Untar the .tgz file in /tmp directory (For example, “tar -xvf Hawkeye_ 2.0.3.30_Full.tgz”). A Manifest is created in
/tmp/Hawkeye_Installer_Files directory.

Ensure you have enough disk space before you proceed.

3. Run the following commands to know the available disk space:

a. du –sh /home/mysql_data - Displays the space taken by the database.
b. df –h /home/ixia - Displays the overall disk space usage. Ensure you have at least as much free space as
taken up by mysql data.
4. Navigate to the directory that contains the installation files created in step 2 (For example, cd
/tmp/Hawkeye_Install_Files).
5. Run the ./backup_db script, this creates a back up your entire Hawkeye 1.0/1.1 database.

The backup may take some time. The time taken to create a backup depends on the size of your database. This
generates a file called Hawkeye_full_backup.sql.gz which is stored in the /root directory.

It is recommended to update the CentOS version on Hawkeye Server to the latest version, for the latest security updates.

Upgrade to latest version of Hawkeye

1. Navigate to the location where the installation files are created. For example, /tmp/Hawkeye_Installer_Files.
2. Run the ./install_linux.sh script, this installs Hawkeye2.x.x.x (latest version).

Follow the prompts on each step and make your selection. Note use -v on end of command for verbose output.

It is important to choose option to delete all data in database. This ensures no database corruption occurs. If option to
delete data in database is not selected the results and probe information is lost or corrupted.

Restore database
You can optionally restore your database by using the commands below.
1. Run the ./restore_db script to restore the previously backed up Hawkeye 1.x database.

© 2010-2018 Ixia Page 4 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

2. Restore db also updates the MySQL from 5.1 to 5.7 for better and optimized SQL performance. It is important to
restore into an empty database.

Hawkeye upgrade from 2.x to 2.<latest version>

This setup is only valid if you already have Hawkeye software and are upgrading to next version on the linux platform.

To upgrade Hawkeye from 2.x to the latest version, do the following:

1. Download Hawkeyex.x.tar.gz from Ixia website.
2. Un tar the file in the desired directory where you would like to install the software.
3. Locate the directory called Hawkeye_Installer_Files
4. Run the installer file as ./install_linux.sh.
5. Accept the License agreement and proceed.
6. Make the selection to either upgrade your database or entirely create a new system.

If you decide to create a new system the existing data configuration and test history will be lost.

Fixing upgrade issue

Never try to uninstall and install again the software: in case of upgrade blocked or gaps between the server and database
versions, please contact Ixia support.

Hawkeye 2.<latest version> Database backup and recovery or restore

You can backup and restore a database within the same version of a release. Hawkeye database (MySQL and db schema
and configuration tables) can be saved using the backup_db scripts.
On the Hawkeye server in a command window, go to the directory used to perform the install, for example,
/tmp/Hawkeye_Install_Files.
To create a backup of a database within the same release, do the following:
1. Run the following commands to know you have enough disk space available to perform a database backup.
a. du –sh /home/mysql_data - Displays the space taken by the database.
b. df –h /home/ixia - Displays the overall disk space usage.

Ensure you have disk space equivalent to the space taken by mysql data.

2. Navigate to the directory that contains the installation files (For example, cd /tmp/Hawkeye_Install_Files).
3. Run the ./backup_db script, this creates a back up your entire Hawkeye database in the /root directory.

The system may take some time to create a backup.

To restore or recover the database backup on the same machine or another Hawkeye server (which must be on the
same release or version) do the following:

© 2010-2018 Ixia Page 5 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

a. Run the ./restore_db script ( located in /tmp/Hawkeye_Install_Files) to restore the database that was
backed up. This accesses the backed up database zip file in /root.

This takes some time to restore. The restore overwrites and deletes the existing tables.

A database backup or restore can be performed from and to the same version of a release. The release must be the
same in case any internal database or tables have changed from one version of Hawkeye server to the next. Once a
database restore is complete a software upgrade to a higher release can be safely performed. Then backup the
database on the latest release for a new baseline backup.

Additional steps after upgrade

Hawkeye software upgrade brings in required CentOS updates compatible with Hawkeye server.

Note: User should not run 'yum update' on a Hawkeye server. If user has a specific
requirement to update a particular package, he should contact Ixia customer support.

New License Installation

Hawkeye 2.4 EA uses Ixia Licensing Utility (ILU) and License Server Plus (LS+). This licensing system was first
introduced in Hawkeye 1.0.

You should have received an email with your Activation Codes. If you have not received it yet, please contact your
sales manager or Ixia Support. Once the installation is done and you can access the Hawkeye server using the
assigned IP address you will be taken to a screen to activate the license. Refer to License Installation Guidelines
below for details or contact Ixia Customer support for how to do this.

License Installation Guidelines

Prior to activating license:

Ensure Hawkeye server hostname is correct. Do NOT change hostname of server after applying the license. Change
the Hawkeye server hostname by using ssh to server and enter the following command:
cd /home/ixia/Hawkeye
./ixia_network_config.sh -fh <yourHawkeyeServerHostname>

© 2010-2018 Ixia Page 6 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

If issues encountered with generating/applying license with IE, recommended to use Chrome as web browser.

Activate a license online:

Following installation in a web browser access the Hawkeye server using the assigned IP address. Screen will
provide a licensing link to register using the activation codes previously emailed.

Activate a license offline:

Using a device on the internet, in a web browser enter “fulfillment.ixiacom.com/activation”. This is the Ixia offline
registration tool that can be used to generate a license file. Enter host ID of Hawkeye server and activation codes
from email. Select “Load Data” then select “Activate All” and then click “Activate”. On next web screen select
“Download License File”. In a web browser enter the Hawkeye server assigned IP address. As Hawkeye server has
not had a license applied it will go to a license Screen. Select “import license file” and select “BROWSE” and open
the generated .bin license file. Then select “OK” to activate licenses.

Additional Documentation
Hawkeye 2.4 EA includes user guides (Hawkeye User Guide, XR2000 and XRPi user guides). The user guides can be
accessed from the web interface under the Information section.

© 2010-2018 Ixia Page 7 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

What's New in Hawkeye 2.4?

What’s New

XR-Docker added as Hawkeye Endpoint for Linux x86 64Bit platforms.

All user login/logout events and changes to preferences are now recorded in 'User Trail'.

“Skype Network Connectivity Performance” real service test added to validate Network performance in
accordance with Microsoft Skype for Business standards.

“Port Scan” real service test added to allow for scanning ports on target device from any XR-probe

© 2010-2018 Ixia Page 8 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

Known limitations and issues

XR2000/XRPi probes cannot be downgraded from Hawkeye 2.4 back to Hawkeye 1.1. Refrain from
connecting a 2.4 XR2000/XRPi device to 1.1 Hawkeye system, your device may end up in unrecoverable
situation. Please contact Ixia Support if need arises.
The Raspbian XRPi has a known issue with its USB ports which can cause the Wi-Fi dongle to intermittently
enter a locked-up state, requiring a physical reboot of the XRPi to recover. The use of a non-powered “2.0
USB hub” (performing protocol conversion) between the XRPi and the Wi-Fi dongle resolves this issue. If a
User experiences this stability issue referred to as “XRPi Wi-Fi lockup”, please contact Ixia Customer
Support so the necessary non-powered “2.0 USB hub” can be shipped to resolve the stability issue. Note, all
new shipped XRPi will contain a 2.0 non-powered USB hub.
ICMP destination port is used as offset (not destination port) in path discovery.

For the XRPi Wi-Fi endpoint. In the Web client for Probe management, user may not be able to identify Wi-
Fi or eth interface. Default traffic will be transmitted on wlan0 and received on eth0 (if available).
If user selects the proper IP (drop down) the traffic will be routed (TX/RX) to that selected interface.
An endpoint with multiple interfaces (e.g. XRPi with eth0 and wlan0) needs to have each interface on a
different subnetwork to avoid routing issues.
For Mesh and Real Services tests the Interface options (e.g. to select Wi-Fi IP) are not provided in web
client.
Wi-Fi test types are only supported for Automatic probes using DHCP

While doing installation Hawkeye service is stopped. If you disagree with any changes in installer,
installation will stop and exit out without restarting Hawkeye service. If that is the case then please restart
the Hawkeye service by typing following command. "service Hawkeye start".
Minimal qualification of IPV6 is done for Hawkeye 2.4. All test types and options for ipv6 haven’t been fully
qualified.
XRPi Wi-Fi endpoint is not supported to perform tests running from eth0 to Wlan0 interface on the same
XRPi.
XRPi Wi-Fi Scan may not show SSID if frequency or channel Info is not available (some older APs (80211.a)
do not provide this information).
Any browser update on (chrome or IE) needs a restart of the browser before using it as a Hawkeye web-
client
Using MySQL external database not qualified for current release

© 2010-2018 Ixia Page 9 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

Range selection under the test results may return full range data if the query is made on a nonexistent data
time frame.
Filter values on top of table rows require hitting 'Enter' to get affected. Exiting field wouldn’t apply the
filter anymore.

Exceeding Hawkeye Server VM disk space will cause all tests stuck in 'queuing'

If Hawkeye server enabled to run both N2N and real service test at the same time. User needs to be aware
the Real Service test “Wi-Fi connect” will bring down and re-establish the Wi-Fi interface to a different Wi-
Fi access point. If a no other N2N test is scheduled to run at the same time, TCP errors may be seen.
The OVA/QCOW2 distribution mode doesn’t come with an uninstall option. To uninstall Hawkeye removing
the VM from the Hypervisor is the only option.

User must not perform ‘yum update’ to update packages on Hawkeye server as break dependencies.

A connection test will bring up the default connection (if any) upon completion, but any
previously defined non-default connection will not (i.e. previous conn test that does not reset the
interface)

WPA Custom option will be supported in future release

To Use Wi-Fi Connect Test Type and use the CLI WiFiConnect.Py the SSID information from the AP
has to be broadcasted. Hidden SSID's are not supported in 2.4 Release
After restoring dB, and/or upgrading system from 2.1->2.4, some auto probe entries may be
duplicated with no IP. User can manually delete those entries

If the server has no connectivity to internet, the login authentication mode is forced to 0 (local)

Only system admin level user can configure Test Template. And user can assign these test
templates to various groups - where users can only execute them

XRPi Wifi does not support Captive portal.

Wifi tests on XRPi will not support specific BSSID selection for this release.

New Customers will not be allowed to use manual endpoints

XR2000 and XR Docker endpoint names cannot have a space in the name.

© 2010-2018 Ixia Page 10 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

Fixed in this release

Bug ID Description
ENH1461268 Test Templates: Allow user to update Test Templates having active Test

BUG1393898 Test results: WiFi statistics: Replace "<=" in test result metrics with blank to indicate
not threshold test

BUG1449191 Hawkeye upgrade script MUST NOT overwrite IPtables (IPV4 + IPV6) configuration on
Hawkeye Server.

ENH1458418 Pull down menu for video formats for RS YouTube test

BUG1450063 Dropbox Real Service Test: Improve error message for failure to match YouTube
message

BUG1465984 Metric Graphs for YouTube RS test: graph for metric Download time cannot be
graphed as calculated value and no test threshold. Metric Video Source: Rebuffering
events removed. Metric renamed as "Video Total Rebuffering Events"

BUG1457684 XRPi: Cleanup image: Block use of webmin

BUG1464431 N2N: Change name of “Lync traffic” test to “Skype4B Traffic”.

BUG1464846 GUI: Add link to XR2000 VM

BUG1464910 Customer: Need ability to delete stuck tests inorder delete endpoint without using
phpmyadmin (security concern)

© 2010-2018 Ixia Page 11 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7
How to Report Problems
USA, Canada and Latin America
Customer Support
Europe, Middle East, and Africa
Customer Support
India Customer Support
China Customer Support
© 2010-2018 Ixia
All rights reserved
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA
Hours: 6:00am PST to 6:00pm PST
Email: support@ixiacom.com
Phone: +1-818-595-2599
Hours: 07:00 to 17:30 GMT
Email: support-emea@ixiacom.com
Phone: +40-21-301-5699
Hours: 09:00 to 17:30 local time
Email: support-india@ixiacom.com
Phone: +91-80-4939-6410
Hours: 09:00 - 18:00 local time (Beijing time), Monday through Friday
Email: support-china@ixiacom.com
Phone: 400-898-0598 (Greater China region)
Phone: +86-10-5732-3932 (Hong Kong customers)
Fax: +86-10-8454-9198
Page 12 7 March 2018
CONFIDENTIAL
 Ixia Hawkeye 2.4 Release Notes Version 2.4.9.7

Hours: 09:00 to 17:30 local time (Singapore)

Asia Pacific Customer Support Email: support-asiapac@ixiacom.com
Phone: +91-80-4939-6410

Hours: 09:00 to 17:30 local time (Japan), Business days

Email: support-japan@ixiacom.com
Japan Customer Support
Phone: +81-3-5326-1980
Fax: +81-3-3348-7733

© 2010-2018 Ixia Page 13 7 March 2018

All rights reserved
CONFIDENTIAL
DO NOT COPY or FORWARD WITHOUT PERMISSION OF IXIA