Ixia Software Release Notes
HLT API 4.98 GA
Build Number: 4.98.122.40 (September 3, 2015)



About This Release

HLTAPI 4.98 GA is a "General Availability" release. 

It is a full-featured, fully-supported HLTAPI release, that may be used in 
a production environment, when new features and/or hardware support are required.
Please see the "What's New" section below for more information.     

Ixia Software Compatibility

env(IXIA_VERSION) HLT IxOS IxRouter IxNetwork IxLoad
HLTSET179 4.98 GA 6.91 EA N/A 7.51 EA (P) N/A
HLTSET180 4.98 GA 6.91 EA N/A 7.51 EA (N) N/A
HLTSET181 4.98 GA 6.91 EA N/A 7.51 EA (NO) N/A
HLTSET182 4.98 GA 6.91 EA N/A 7.51 EA (P2NO) N/A
Note: Based on the HLTSET, HLT loads different sets of APIs as described below: - *P-Loads: o IxOS (tclHal API) o IxTclProtocols - *N-Loads: o IxOS (tclHal API) o IxTclNetwork - *NO-Loads: o IxTclNetwork (only; without IxTclHal) - *P2NO-Loads: o If -ixnetwork_tcl_server parameter is NOT provided in ::ixia::connect (same as *P) + IxOS (tclHal API) + IxTclProtocols o If -ixnetwork_tcl_server parameter is provided in ::ixia::connect (same as *NO) +IxTclNetwork (only; without IxTclHal) The default setting for env(IXIA_VERSION) is the latest HLTSET___ value, if the value is not set. If the value is set to an IxOS major.minor version, then the largest HLTSET list that corresponds to that IxOS version is used. For additional product compatibility information please refer to the following online utility. An Ixia website account is required before accessing. http://www.ixiacom.com/support-overview/product-support/product-compatibility-matrix

IxNetwork API Notes

HLT will be supporting both of the Tcl APIs that can be run via IxNetwork. To determine which one you will use, the HLTSET values for IxNetwork have been enhanced. You will now see either a P (IxTclProtocol, old API path) or a N (IxTclNetwork, new API path) after the IxNetwork version in the HLTSET.

Previous Release Notes

Please visit the HLT API support web page for the Release Notes of previous HLTAPI versions.

Installation Notes

   

Installing on HLAPI Windows

Starting with IxNetwork 7.51EA release, we recommend installing HLAPI by using the IxNetwork installer. HLAPI can be installed by choosing the "Custom" setup type of the IxNetwork installer. From the "Custom Setup for Bundle Features" dialog box, the "HLTAPI" feature can be selected. Moreover, the sample scripts will be installed in the same way, as a feature option. If the user doesn't select the "Samples and Scripts" option from the dialog box, the HLAPI samples will not be installed by default. Please refer to the "IxNetwork Getting Started Guide.pdf" file for more details. However, in this release, the user still has the option to install HLAPI using its standalone installer, as it is still available. To install, simply execute HLTAPI_4.98_GA.exe.

Installing platform independent HLAPI

This release introduces a new installation mode for HLAPI on Linux systems. The platform independent package can be installed using the IxNetwork platform independent installer. From this release on, the IxNetwork archive will contain libraries for the corresponding HLAPI and IxOS applications. Therefore, in order to access the HLAPI libraries, the user is required to uncompress the IxNetwork TAR/ZIP archive, in the desired location. The "bin" folder of each application provides scripts that launch the language interpreters used by Ixia products. Please make sure to edit each script to point to the correct location, where the applications are installed on the system. In order to use the HLAPI libraries, please run the "hlapitcl","hlapiperl" or "hlapipython" scripts, to open the desired interpreter and call the "package require Ixia" command (or its corresponding command in Perl/Python).

Native RedHat/Cent OS installers of HLAPI

Similar to the platform independent installer presented above, the native RedHat/CentOS install for HLAPI will be incapsulated in the IxNetwork binary installer, starting with this release. The user will be required to run the IxNetwork binary, which will install the language packages for the Tcl, Perl and Python versions used by Ixia products, along with the actual application libraries for IxNetwork, HLAPI and IxOS. During the run of the IxNetwork installer, the user will be presented with the option to install HLAPI, option which is checked by default. Please make sure to run the IxNetwork installer with "root" privileges, since the languages packages will always be placed under "/opt/ixia"! By default, the application libraries are also installed under "/opt/ixia", in which case the "hlapitcl","hlapiperl" and "hlapipython" scripts, mentioned in the platform independent installer section above, will work without modifications. In the case in which the user selects another install path for the application libraries, he/she will have to edit the "bin" folder scripts as mentioned above, in the "Installing platform independent HLAPI", to point to the correct application libraries folders.

How to Report Problems

Contact List Change: 4150211; Date: 2013/09/24

USA, Canada and Latin America Customer Support

Hours: 6:00am PST to 6:00pm PST
Email: support@ixiacom.com
Phone: +1-818-595-2599

Europe, Middle East, and Africa Customer Support

Hours: 07:00 to 17:30 GMT
Email: support-emea@ixiacom.com
Phone: +40-21-301-5699

India Customer Support

Hours: 09:00 to 17:30 local time
Email: support-india@ixiacom.com
Phone: +91-80-4939-6410

China Customer Support

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

Asia Pacific Customer Support

Hours: 09:00 to 17:30 local time (Singapore)
Email: support-asiapac@ixiacom.com
Phone: +91-80-4939-6410

Japan Customer Support

Hours: 09:00 to 17:30 local time (Japan), Business days
Email: support-japan@ixiacom.com
Phone: +81-3-5326-1980
Fax: +81-3-3348-7733

Additional Documentation

Please refer to our website at http://www.ixiacom.com/support-services/product-support/user-guides. 

You will be required to provide a login and password to enter this section of 
the web site. If you do not have the username and password, please forward your 
request to mailto:support@ixiacom.com.

What's New in HLT API

4.98 GA Features

HL API - Access Protocols
Added HL API support for new PPPoX statistics in the PPPoX Client Drill Down – per Session and per Device Group views.: “Cumulative Sessions Initiated”, “Cumulative Sessions Succeeded”, “Cumulative Sessions Failed”, “Cumulative Teardown Succeeded”, “Cumulative Teardown Failed”
Added HL API support for the new functionality additions to the LNS emulation, to accept multiple tunnel establishment initiation with different HostName AVP each from LAC in tunnel authentication enabled.

HL API - Connect
Decoupled HL API from IxOS Tcl Server when using HLTSET NO.

HL API - Installer
Starting with this release, HLAPI install on Linux systems will be done using the IxNetwork Linux installer, as the standalone installer for Linux will no longer be available.The IxNetwork binary and platform independent installers will include the corresponding HLAPI and IxOS application versions.


Resolved Defects List

HL API - Connectivity

Bug Number Notes
1355996 This release contains a fix for a HLPy issue where ixiangpf.connect to Connection Manager spawned two IxNetwork Tcl Server GUI.
1361370 This release contains a fix for an error that appeared when issuing the ::ixia::reboot_port_cpu command for a specific port, with an IxOS-only connect (no -ixnetwork_tcl_server in the ::connect command)

HL API - Routing/ Bridging Protocols

Bug Number Notes
1361364 This release includes a fix for an error that appeared when running the ::ixia::emulation_isis_topology_route_config command with -mode modify and parameters -handle and -elem_handle.
1361366 This release includes a fix for an issue in the BGP implementation where the DUT IP field was not incremented as per the configuration. This was due to the fact that the -remote_addr_step parameter of the ::ixia::emulation_bgp_config command did not work correctly when the command was used with -interface_handle.
1361696 This release added support for the -multi_topology parameter for ::emulation_isis_config.

HL API - Traffic

Bug Number Notes
1361368 This release includes a fix for a performance issue related to traffic stats. More specifically, the following command took significantly longer to return the result: ::ixia::traffic_stats -mode stream -streams $stream_id, when compared to the time needed by the following command: ::ixia::traffic_stats -mode traffic_item.
1361919 This release contains an addition to the list of statistics returned by the ::ixia::traffic_stats command with -mode 'aggregate: "CRC Errors” and “Misdirected Packet Count”
1362510 In this release, a change was made in the way the::ixia::traffic_control command with -action run works, in order to be consistent with the IxNetwork GUI behavior: now, if traffic is applied (but not started), this command will no longer re-apply traffic, instead it will just start it.


Known Issues

Please visit the HLT API support web page for more information on known issues related to this release.
An Ixia website account is required before accessing.