-------------------------STC TCL Lib Installation Guide

-------------------------Prepared by: Weixiang Guo

Created on: 2015-10-11
Updated on: 2015-10-14
-------------------------Installation Steps
-------------------------1. Download TCL Installation package from Spirent support website
- Visit http://support.spirentcom.com/eservice_enu/start.swe, then login
with ID:xiaojie.liu@ericsson.com PSW:xiaojie
- Click Tab "Downloads", set Filter on the left panel as below
Release Type: General Release
Product Line: Spirent TestCenter
Category:
Applications
Operating System:
Red Hat Linux EL3/EL5
You will see "Spirent TestCenter Application, v#.## for Red Hat Linux EL
3/EL5" at the right window.
- Select proper version and click "download"
Tips:
- To speed up the downloading, you can initiate download process from lx
app server directly.
Steps:
1. get the file download URL in IE/Firefox on Windows
Say IE for example: view downloads-> right cick on selected file-> copy
download link
2. download the file using wget on Linux
Syntax: wget URL -O destination_file_name
Example:
wget "http://software.spirent.com/Releases/Spirent%20TestCenter/Spirent
%20TestCenter%20Application/4.56/Spirent_TestCenter_Auto_Linux_4.56.tar.gz?Expir
es=1444391430&Signature=XqZtmSDuhr1fabQ91b3tEU2hRrS-BzGks7M5gGtCHVQXdhWShT9nV7AU
PKBfPLVDp4y~9InaHUI-i0CZNoBX7zS7FQZiP0-zQ7Zt67xHcOsZl6M4l-vcRoBdo9gxfRuSJ0bgRi9I
N1gAs1OCYldg6kd7-57k9Of9cSIYEtmPsm8_&Key-Pair-Id=APKAIV72B5ONQYC3WDNQ" -O Spire
nt_TestCenter_Auto_Linux_4.56.tar.gz
2. Install the TCL lib
- login in with user arts2
- copy .gz file to TCL Linux Server, path /home/arts2/spirent/API
- unzip the file
Command Example:
tar -zxvf Spirent_TestCenter_Auto_Linux_4.56.tar.gz
you will see
drwxr-xr-x 4
drwxr-xr-x 4
drwxr-xr-x 4
* new TCL Lib

new folder
arts2 rbak
arts2 rbak
arts2 rbak

as below:
4096 Jun 26 11:14 Spirent_TestCenter_4.52
4096 Jul 15 15:14 Spirent_TestCenter_4.53
4096 Oct 8 22:19 Spirent_TestCenter_4.56

**

drwxr-xr-x 4 arts2 rbak 4096 May 26 18:11 Spirent_TestCenter_4.60

3. Verify TCL Lib readiness via "package require"
Steps:
/home/arts2/spirent/Tcl/bin/tclsh
#remember to update the path in the command below according to L
ib Version
lappend ::auto_path /home/arts2/spirent/API/hltapi/HLTAPI_4.46_G
A/SourceCode /home/arts2/spirent/API/Spirent_TestCenter_4.56/Spirent_TestCenter_
Application_Linux /home/arts2/spirent/Tcl/bin/tclsh
package require SpirentHltApi
stc::get system1 -Version
sth::connect -device 1.1.1.1 -port_list 1/1 -offline 1
% set hport [lindex [stc::get project1 -children-port] 0 ]
port1
% stc::get $hport -children-generator
generator1
Tips:
-How to check detailed version of TCL Lib?
See file under Spirent_TestCenter_#.##\Spirent_TestCenter_Applic
ation_Linux\ILVersion.xml
Example:
<?xml version="1.0"?>
<StcSystem Version="4.56">
<Chassis Id="Firmware" Version="2.20.0000" CheckExactVersion="fa
lse"/>
<TestModule Id="Firmware" Version="4.56.7376" CheckExactVersion=
"true"/>
<TestPackage Id="stc" Version="4.56.7376" CheckExactVersion="tru
e"/>
<TestPackage Id="l2l3" Version="4.56.7376" CheckExactVersion="tr
ue"/>
</StcSystem>
4. when the installation is verified passed, install same on HUB TCL server
Note that HUB servers use different user/psw than legacy, also different
installation path.
For details of the please refer to Hub_Server.xlsx
-------------------------------------------------------------Appendix A:
Log of loading STC TCL Lib manually on hub server
--------------------------------------------------------------4.56 as example:
[artscron@ussjtelvetcl09 API]$ /tools/tcl/spirent/Tcl/bin/tclsh
% lappend ::auto_path /tools/tcl/spirent/API/hltapi/HLTAPI_4.46_GA/SourceCode /t
ools/tcl/spirent/API/Spirent_TestCenter_4.56/Spirent_TestCenter_Application_Linu
x /tools/tcl/spirent/Tcl/bin/tclsh
/tools/tcl/ActiveTcl-8.4/lib/tcl8.4 /tools/tcl/ActiveTcl-8.4/lib /tools/tcl/spir
ent/Tcl/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/package/linux-glibc2.12-ix86/lib
/tools/tcl/ActiveTcl-8.4/lib/teapot/package/linux-glibc2.11-ix86/lib /tools/tcl
/ActiveTcl-8.4/lib/teapot/package/linux-glibc2.10-ix86/lib /tools/tcl/ActiveTcl8.4/lib/teapot/package/linux-glibc2.9-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teap
ot/package/linux-glibc2.8-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/package/l
inux-glibc2.7-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/package/linux-glibc2.
6-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/package/linux-glibc2.5-ix86/lib /

tools/tcl/ActiveTcl-8.4/lib/teapot/package/linux-glibc2.4-ix86/lib /tools/tcl/Ac
tiveTcl-8.4/lib/teapot/package/linux-glibc2.3-ix86/lib /tools/tcl/ActiveTcl-8.4/
lib/teapot/package/linux-glibc2.2-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/p
ackage/linux-glibc2.1-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/package/linux
-glibc2.0-ix86/lib /tools/tcl/ActiveTcl-8.4/lib/teapot/package/tcl/lib /tools/tc
l/spirent/API/hltapi/HLTAPI_4.46_GA/SourceCode /tools/tcl/spirent/API/Spirent_Te
stCenter_4.56/Spirent_TestCenter_Application_Linux /tools/tcl/spirent/Tcl/bin/tc
lsh
% package require SpirentHltApi
OS: Linux, 2.6.32-504.12.2.el6.x86_64, unix; Tcl version: 8.4.19
SpirentTestCenter Automation Version: 4.56.7376.0000
Hlt Api (Ver. 4.46) was successfully loaded and initialized
Internal Version: 4.46GA.1226
4.46
% stc::get system1 -Version
4.56.7376.0000
% sth::connect -device 1.1.1.1 -port_list 1/1 -offline 1
sth::connect -device 1.1.1.1 -port_list 1/1 -offline 1
-----------------------------------------------------Appendix B:
ARTS log for STC TCL Lib package require
-----------------------------------------------------STC 4.52 as example:
TCL Client-tg-arts3 (08:42:09): arts2@ussjtelvetcl05 >/home/arts2/spirent/Tcl/bi
n/tclsh
STC-osreg-stca-14 (08:42:09): % fconfigure stdout -translation lf
*** Oct 05 08:42:09 INFO *** Loading STC Client and Library ...
STC-osreg-stca-14 (08:42:09): % lappend ::auto_path /home/arts2/spirent/API/hlta
pi/HLTAPI_4.46_GA/SourceCode /home/arts2/spirent/API/Spirent_TestCenter_4.52/Spi
rent_TestCenter_Application_Linux /home/arts2/spirent/Tcl/bin/tclsh
STC-osreg-stca-14 (08:42:09): /home/arts/ixia3.65/ixia/lib /home/arts2/spirent/T
cl/lib/tcl8.4 /home/arts2/spirent/Tcl/lib /home/arts2/spirent/Tcl/lib/teapot/pac
kage/linux-glibc2.12-ix86/lib /home/arts2/spirent/Tcl/lib/teapot/package/linux-g
libc2.11-ix86/lib /home/arts2/spirent/Tcl/lib/teapot/package/linux-glibc2.10-ix8
6/lib /home/arts2/spirent/Tcl/lib/teapot/package/linux-glibc2.9-ix86/lib /home/a
rts2/spirent/Tcl/lib/teapot/package/linux-glibc2.8-ix86/lib /home/arts2/spirent/
Tcl/lib/teapot/package/linux-glibc2.7-ix86/lib /home/arts2/spirent/Tcl/lib/teapo
t/package/linux-glibc2.6-ix86/lib /home/arts2/spirent/Tcl/lib/teapot/package/lin
ux-glibc2.5-ix86/lib /home/arts2/spirent/Tcl/lib/teapot/package/linux-glibc2.4-i
x86/lib /home/arts2/spirent/Tcl/lib/teapot/package/linux-glibc2.3-ix86/lib /home
/arts2/spirent/Tcl/lib/teapot/package/linux-glibc2.2-ix86/lib /home/arts2/spiren
t/Tcl/lib/teapot/package/linux-glibc2.1-ix86/lib /home/arts2/spirent/Tcl/lib/tea
pot/package/linux-glibc2.0-ix86/lib /home/arts2/spirent/Tcl/lib/teapot/package/t
cl/lib /home/arts2/spirent/API/hltapi/HLTAPI_4.46_GA/SourceCode /home/arts2/spir
ent/API/Spirent_TestCenter_4.52/Spirent_TestCenter_Application_Linux /home/arts2
/spirent/Tcl/bin/tclsh
STC-osreg-stca-14
STC-osreg-stca-14
n: 8.4.19
STC-osreg-stca-14
00
STC-osreg-stca-14
itialized

(08:42:09): % package require SpirentHltApi

(08:42:10): OS: Linux, 2.6.32-358.el6.x86_64, unix; Tcl versio
(08:42:30): SpirentTestCenter Automation Version: 4.52.6676.00
(08:42:30): Hlt Api (Ver. 4.46) was successfully loaded and in

STC-osreg-stca-14 (08:42:30): Internal Version: 4.46GA.1226

STC-osreg-stca-14 (08:42:30): 4.46
STC-osreg-stca-14 (08:42:30): % stc::get system1 -Version
STC-osreg-stca-14 (08:42:30): 4.52.6676.0000
-----