chassis

chassis - add a new chassis to the chain and configure it.

SYNOPSIS

chassis sub-command options

DESCRIPTION

The chassis command is used to add a new chassis to a chain of chassis, configure an existing chassis or delete an existing one from the chain in use.

STANDARD OPTIONS
baseIpAddress

The IP address that is used to get to the port CPUs. In IxExplorer, this is "IxRemoteIp" under Chassis Properties. (default = 10.0.0.0)

baseAddressMask

The mask address that is used to get the port CPUs.

cableLength

Specifies the length of the cable between all chassis. Options include:

Option

Value

Usage

cable3feet

0

default

cable6feet

1

 

cable9feet

2

 

cable12feet

3

 

cable15feet

4

 

cable18feet

5

 

cable21feet

6

 

cable24feet

7

 

hostname

Read-only. The hostname associated with the chassis, as specified in the last chassis add operation.

id

ID number given to the chassis. (default = 0)

ipAddress

Read-only. The IPv4 address associated with the chassis.

ip6Address

Read-only. The IPv6 address associated with the chassis.

Example:

chassis cget -ip6Address: 2620:17b:3:c000::2:9ccf

ixServerVersion

Read-only. The installed IxOS version associated with the chassis.

master true/false

Read-only. Specifies whether this chassis is a master of a slave in a chain. There can be only one master chassis in a chain. Note: The master is automatically assigned based on cable connections.

maxCardCount

Read-only. Number of card can be installed on the chassis.

name

The given name of the chassis. (default = defaultChassis)

operatingSystem

Read-only. The operating system loaded on the chassis.

Option

Value

Usage

chassisOSUnknown

0

Unknown operating system

chassisOSWin95

1

Windows 95

chassisOSWinNT

2

Windows NT

chassisOSWin2000

3

Windows 2000

chassisOSWinXP

4

Windows XP

chassisOSWin7

7

Windows 7

chassisOSLinux 7 Linux
powerConsumption

The power consumption level of the port CPU.

sequence

Specifies the sequence number of the chassis in the chain. The master must have a sequence number of 0 and other chassis should be incrementing. (default = 1)

syncInOutCountStatus

Specifies the sync-in and sync-out count status.

type

Read-only. Specifies the type of chassis. Possible values are:

Option

Value

Usage

ixia1600

2

16 card chassis type

ixia200

3

2 card chassis type

ixia400

4

4 card chassis type

ixia100

5

1 card chassis type with GPS

ixia400C

6

1 card chassis with additional power and fans

ixia1600T

7

16 card chassis type with additional power and fans

ixiaDemo

9

128 card chassis type used in demo server

ixiaOptixia

10

Optixia chassis

ixiaOpixJr

11

Ixia test board

ixia400T

14

4 card chassis type

ixia250

17

2 card chassis type

ixia400Tf

18

4 card chassis type, special fan speed

ixiaOptixiaXL10

20

10 card chassis type

ixiaOptixiaXM12

22

12 card chassis type

ixiaOptixiaXV

24

virtual chassis (OptixiaXV)

ixiaOptixiaXG12

25

12-slot chassis

ixiaOptixiaXGS12

26

12-slot chassis with high-speed backplane

ixiaOptixiaXGH1

27

A unified applications and security test platform

ixiaOptixiaXGS2

28

2-slot chassis

ixiaOptixiaXV1

29

Ixia Virtual Test Appliance

typeName

Read-only. The printable chassis type name.

DEPRECATED OPTIONS
baseAddressMask

This option has been deprecated (with IxOS version 5.0).

COMMANDS

The chassis command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.

chassis add sIPAddr

Adds a new chassis with sIPAddr (hostname or IP address) to the chain. Specific errors are:

chassis cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the chassis command.

chassis config option value

Modify the configuration options of the chassis. If no option is specified, returns a list describing all of the available options (see STANDARD OPTIONS) for chassis.

chassis del sIPAddr

Deletes the chassis with sIPAddr (hostname or IP address) from the chain.

chassis export fileName sIPAddr

Exports the current configuration of the chassis sIPAddr (hostname or IP address) into the file named fileName; fileName may include a full or relative path. The file produced by this command may be used by the import sub-command. Specific errors are:

chassis get sIPAddr

Gets the current configuration of the chassis with sIPAddr (hostname or IP address) from hardware. Call this command before calling chassis cget option value to get the value of the configuration option. Specific errors are:

chassis getChassisPowerConsumption i_IPAddr

Gets the chassis power consumption value.

chassis getChassisSyncInOutCount sIPAddr

Gets the sync-in and sync-out count of the chassis with sIPAddr (hostname or IP address) from the hardware.

chassis getFromID chasID

Gets the current configuration of the chassis with chasID from hardware. Call this command before calling chassis cget option value to get the value of the configuration option.

chassis import fileName sIPAddr

Imports a saved chassis configuration found in the file fileName into the current configuration of the chassis sIPAddr (hostname or IP address). fileName may include a full or relative path. The file used by this command must have been produced by the export sub-command. A chassis write is necessary to commit these items to the hardware. You must have chassis-wide rights to use this command. Specific errors are:

chassis reboot chasID

Reboots the chassis. You must have chassis-wide rights to use this command. Specific errors are:

chassis refresh sIPAddr

Ensures that the data displayed is up to date. Specific errors are:

chassis resetHardware sIPAddr

Resets the hardware by initializing all the registers and statistic counters. You must have chassis-wide rights to use this command. Specific errors are:

chassis saveIxsFile sIpAddr

Saves the current IxServer configuration to an IxServer.ixs file on the server The IxServer.ixs file is saved automatically when there is a orderly shutdown of IxServer. It may also be saved manually, by using this command, to ensure backup of the configuration without having to shut down the system, such as in service monitoring situations. If some unexpected shutdown occurs, the IxServer configuration is reloaded from the saved .ixs file on power-up.

The sIpAddr should be the IP address of the current chassis.

chassis set sIPAddr

Sets the entire configuration of the chassis, including baseIpAddress, in IxHAL with sIPAddr (hostname or IP address of the chassis) by reading the configuration option values set by the chassis config option value command. Specific errors are:

chassis setBaseIp sIPAddr

Sets only the base IP address for the chassis with sIPAddr (hostname or IP address of the chassis). In IxExplorer Chassis Properties, this is named 'IxRemoteIp'. You must have chassis-wide rights to use this command. Specific errors are:

chassis setDefault

Sets to IxTclHal default values for all configuration options.

chassis setFactoryDefaults sIPAddr

Sets the factory default values on the chassis. You must have chassis-wide rights to use this command. Specific errors are:

chassis shutdown sIPAddr

Shuts down the chassis. You must have chassis-wide rights to use this command. Specific errors are:

chassis addVirtualCard chassisIP cardIP cardId keepAliveTimeout

Adds virtual machine card to the chassis. You must have chassis-wide rights to use this command. Specific errors are:

The return values for the command are:

Options

Values

Description

kCardOK

0

Virtual Card attach operation completed successfully.

kCardIdExists

5

Virtual Card ID is already present in the Virtual Chassis. Choose a different card ID.

kCardIdOutOfRange

6

Virtual Card ID is out of the supported range of [1,32]. Choose a valid card ID.

kCardOverlappingIP

7

Virtual Card with the same IP is already attached to the chassis. Choose a different IP.

kCardBuildTimeout

8

Virtual Card attach operation has timedout.

kCardIdUnavailable

9

Virtual Card ID is unavailable.

The parameters for the commands are:

Option

Value

Usage

keepAliveTimeout

any value in seconds (>= 3)

keepAliveTimeout value in seconds (>= 3), indicating the Keepalive timeout between the Virtual Chassis and the Virtual Load Module.

testNic

 

The existing nic name of a virtual machine, used to generate traffic (port), Example: eth1.

promiscuous_mode

0/1

Enables promiscuous mode on port (Promiscuous mode must be supported and enabled in hypervisor also, for this option to work).

testMac

 

The MAC address of port. This must match the MAC address of the interface with the name provided in testNic parram, can be added as 00:00:00:00:00:00, and is automatically taken from interface at add time.

linkMTU

default = 1500

A valid Ethernet MTU.

lineSpeed

valid values: 100Mbps and 1000Mbps (new versions of IxOS limits the speed to these 2 values. Using IxN and IxL, you can also set the speed up to 50000 Mbps).

The virtual line speed at which the port will be capped, in software. Default = 1000. If an invalid value is entered speed will be set to 1000.

chassis removeVMCard chassisIP cardId

Removes virtual machine card from the chassis. You must have chassis-wide rights to use this command. Specific errors are:

chassis checkVMForDuplicate chassisIP cardIP

Checks if a Virtual Load Module with the same IP is already attached to the chassis. You must have chassis-wide rights to use this command.

Specific errors are:

The return values for the command are:

Options

Values

kCardIPInUse

cardId value

kCardIPNotInUse

0

chassis forceHotswap chassisIPAddr cardID

Deliberately forces hotswap of the card.

Example:

package require IxTclHal

ixConnectToChassis $ChassisId

TclScripts) 1 % chassis forceHotswap 10.205.27.99 2

chassis setVMCardParameter chassisId cardId paramId paramVal

Sets the Virtual Card parameter. You must have chassis-wide rights to use this command.

Specific errors are:

Card parameter IDs:

Parameter

Value

cardIp

0

cardKeepAlive

1

The return values for the command are:

Options

Values

Description

kCardOK

0

Virtual Card attach operation completed successfully.

kCardOverlappingIP

7

Virtual Card with the same IP is already attached to the chassis. Choose a different IP.

kCardBuildTimeout

8

Virtual Card attach operation has timedout.

chassis setVMCardParameter chassisId managementIPAddr cardId keepAliveTimeout

Sets all the Virtual Card parameters. To use this function all parameters must be set. This function is faster than setting parameters one by one. If a parameter is not set, a default one is used.

You must have chassis-wide rights to use this command. Specific errors are:

The return values for the command are:

Options

Values

Explantion

kCardOK

0

Virtual Card attach operation completed successfully.

kCardOverlappingIP

7

Virtual Card with the same IP is already attached to the chassis. Choose a different IP.

kCardBuildTimeout

8

Virtual Card attach operation has timedout.

chassis getVMCardParameter chassisId cardId paramId

Gets the current configuration of the Virtual Card. You must have chassis-wide rights to use this command.

Specific errors are:

Card parameter IDs:

Parameter Value
cardIp

0

cardKeepAlive 1
cardVMStatus 2

Returns the current value of the configuration option given by paramId.

chassis syncChassisStats chassisId

Updates local hal with instantaneous chassis stats retrieved from chassis. Returns TCL_OK on success and TCL_ERROR on failure.

chassis getChassisStats chassisId

Returns a list with all the chassis stats names available for the chassis with chassisId. If the provided chassisId is invalid, a list containing "invalidChassis" is returned. Depending on the type of chassis, this API returns a list with different chassis stat names.

chassis getChassisStatValue chassisId chassisStatName

Example of API Usage/Output:

(TclScripts) 19 % package req IxTclHal

8.20

(TclScripts) 20 % ixConnectToChassis loopback

Connecting to Chassis 1: loopback ...

0

(TclScripts) 21 % chassis syncChassisStats 1

0

(TclScripts) 22 % set chassisStats [chassis getChassisStats 1]

kPowerSupplyCurrentTotal kCPs1Status kCPs1VoltageIn kCPs1CurrentIn kCPs1VoltageOut kCPs1CurrentOut kCPs1Temperature1 kCPs1Temperature2 kCPs1Temperature3 kCPs2Status kCPs2VoltageIn kCPs2CurrentIn kCPs2VoltageOut kCPs2CurrentOut kCPs2Temperature1 kCPs2Temperature2 kCPs2Temperature3 kCPs3Status kCPs3VoltageIn kCPs3CurrentIn kCPs3VoltageOut kCPs3CurrentOut kCPs3Temperature1 kCPs3Temperature2 kCPs3Temperature3

(TclScripts) 23 % foreach item $chassisStats {

set value [chassis getChassisStatValue 1 $item]

puts "$item $value"

}

kPowerSupplyCurrentTotal 182.00 A

kCPs1Status PSU ON

kCPs1VoltageIn 224.25 V

kCPs1CurrentIn 1.52 A

kCPs1VoltageOut 11.98 V

kCPs1CurrentOut 24.84 A

kCPs1Temperature1 37 C

kCPs1Temperature2 28 C

kCPs1Temperature3 41 C

kCPs2Status PSU ON

kCPs2VoltageIn 224.25 V

kCPs2CurrentIn 1.25 A

kCPs2VoltageOut 11.98 V

kCPs2CurrentOut 20.38 A

kCPs2Temperature1 36 C

kCPs2Temperature2 28 C

kCPs2Temperature3 41 C

kCPs3Status N/A

kCPs3VoltageIn N/A

kCPs3CurrentIn N/A

kCPs3VoltageOut N/A

kCPs3CurrentOut N/A

kCPs3Temperature1 N/A

kCPs3Temperature2 N/A

kCPs3Temperature3 N/A

(TclScripts) 24 % chassis syncChassisStats 1

0

(TclScripts) 25 % foreach item $chassisStats {

set value [chassis getChassisStatValue 1 $item]

puts "$item $value"

}

kPowerSupplyCurrentTotal 182.00 A

kCPs1Status PSU ON

kCPs1VoltageIn 225.25 V

kCPs1CurrentIn 1.50 A

kCPs1VoltageOut 11.98 V

kCPs1CurrentOut 24.63 A

kCPs1Temperature1 37 C

kCPs1Temperature2 28 C

kCPs1Temperature3 41 C

kCPs2Status PSU ON

kCPs2VoltageIn 225.50 V

kCPs2CurrentIn 1.23 A

kCPs2VoltageOut 11.98 V

kCPs2CurrentOut 20.38 A

kCPs2Temperature1 36 C

kCPs2Temperature2 28 C

kCPs2Temperature3 41 C

kCPs3Status N/A

kCPs3VoltageIn N/A

kCPs3CurrentIn N/A

kCPs3VoltageOut N/A

kCPs3CurrentOut N/A

kCPs3Temperature1 N/A

kCPs3Temperature2 N/A

kCPs3Temperature3 N/A

(TclScripts) 26 % ixConnectToChassis 10.215.134.151

Connecting to Chassis 1: 10.215.134.151 ...

0

(TclScripts) 27 % chassis cget id

Invalid cget option for TCLChassis. Must be :{ -this -id -name -serialNumber -cableLength -sequence -master -baseIpAddress -baseAddressMask -syncInOutCountStatus -powerConsumption -powerManagement -inactivityTimeout -maxCardCount -type -typeName -ipAddress -operatingSystem -hostName -ixServerVersion -chassisNumber }

(TclScripts) 28 % chassis cget -id

1

(TclScripts) 29 % chassis syncChassisStats 1

0

(TclScripts) 30 % set chassisStats [chassis getChassisStats 1]

kPowerSupplyCurrentTotal kPowerSupplyCurrentUsed kPs1Status kPs1Fault kPs1Current kPs1Voltage kPs1StandbyCurrent kPs1StandbyVoltage kPs1AcRmsCurrent kPs1AcRmsVoltage kPs1Fan1Speed kPs1Fan2Speed kPs1AmbientTemperature kPs1HeatSink1Temperature kPs1HeatSink2Temperature kPs2Status kPs2Fault kPs2Current kPs2Voltage kPs2StandbyCurrent kPs2StandbyVoltage kPs2AcRmsCurrent kPs2AcRmsVoltage kPs2Fan1Speed kPs2Fan2Speed kPs2AmbientTemperature kPs2HeatSink1Temperature kPs2HeatSink2Temperature kPs3Status kPs3Fault kPs3Current kPs3Voltage kPs3StandbyCurrent kPs3StandbyVoltage kPs3AcRmsCurrent kPs3AcRmsVoltage kPs3Fan1Speed kPs3Fan2Speed kPs3AmbientTemperature kPs3HeatSink1Temperature kPs3HeatSink2Temperature

(TclScripts) 31 % foreach item $chassisStats {

set value [chassis getChassisStatValue 1 $item]

puts "$item $value"

}

kPowerSupplyCurrentTotal 446.00 A

kPowerSupplyCurrentUsed 194.33 A

kPs1Status 0x81 , AC is Faulted

kPs1Fault 0x0

kPs1Current N/A

kPs1Voltage N/A

kPs1StandbyCurrent N/A

kPs1StandbyVoltage N/A

kPs1AcRmsCurrent N/A

kPs1AcRmsVoltage N/A

kPs1Fan1Speed N/A

kPs1Fan2Speed N/A

kPs1AmbientTemperature N/A

kPs1HeatSink1Temperature N/A

kPs1HeatSink2Temperature N/A

kPs2Status OK

kPs2Fault 0x0

kPs2Current 98.19 A

kPs2Voltage 12.16 V

kPs2StandbyCurrent 1.02 A

kPs2StandbyVoltage 4.99 V

kPs2AcRmsCurrent 5.17 A

kPs2AcRmsVoltage 224.25 V

kPs2Fan1Speed 11394 rpm

kPs2Fan2Speed 11232 rpm

kPs2AmbientTemperature 24 C

kPs2HeatSink1Temperature 41 C

kPs2HeatSink2Temperature 41 C

kPs3Status OK

kPs3Fault 0x0

kPs3Current 96.14 A

kPs3Voltage 12.13 V

kPs3StandbyCurrent 1.20 A

kPs3StandbyVoltage 4.98 V

kPs3AcRmsCurrent 4.89 A

kPs3AcRmsVoltage 223.81 V

kPs3Fan1Speed 11016 rpm

kPs3Fan2Speed 10719 rpm

kPs3AmbientTemperature 23 C

kPs3HeatSink1Temperature 37 C

kPs3HeatSink2Temperature 36 C

(TclScripts) 32 % set chassisStats [chassis getChassisStats 2]

invalidChassis

(TclScripts) 33 % set chassisStats [chassis getChassisStats 1]

kPowerSupplyCurrentTotal kPowerSupplyCurrentUsed kPs1Status kPs1Fault kPs1Current kPs1Voltage kPs1StandbyCurrent kPs1StandbyVoltage kPs1AcRmsCurrent kPs1AcRmsVoltage kPs1Fan1Speed kPs1Fan2Speed kPs1AmbientTemperature kPs1HeatSink1Temperature kPs1HeatSink2Temperature kPs2Status kPs2Fault kPs2Current kPs2Voltage kPs2StandbyCurrent kPs2StandbyVoltage kPs2AcRmsCurrent kPs2AcRmsVoltage kPs2Fan1Speed kPs2Fan2Speed kPs2AmbientTemperature kPs2HeatSink1Temperature kPs2HeatSink2Temperature kPs3Status kPs3Fault kPs3Current kPs3Voltage kPs3StandbyCurrent kPs3StandbyVoltage kPs3AcRmsCurrent kPs3AcRmsVoltage kPs3Fan1Speed kPs3Fan2Speed kPs3AmbientTemperature kPs3HeatSink1Temperature kPs3HeatSink2Temperature

(TclScripts) 34 % chassis getChassisStatValue 1 alfa

N/A-invalidChassisStat:alfa.

DEPRECATED COMMANDS

chassis write chasID cardID portID

Do not use.

chassis addVMCard chassisIP cardIP cardId cardType keepAliveTimeout ixvmVCardExtType

Do not use.

EXAMPLES

package require IxTclHal

# Set up two chassis in a chain

set host1 galaxy

set host2 localhost

# Remove all of the chassis in the chain

chassisChain removeAll

#---------

# Check if we're running on UNIX - connect to the TCL Server

# which must be running on the chassis

if [isUNIX] {

if [ixConnectToTclServer $host] {

ixPuts "Could not connect to $host"

return 1

}

# Now connect to the chassis

if [ixConnectToChassis [list $host1 $host2] {

ixPuts $::ixErrorInfo

return 1

}

# Check for a valid chain

if [chassisChain validChain] {

ixPuts "Chain has no master"

}

set masterSlave(0) slave

set masterSlave(1) master

# Get the type and capabilities of the chassis

chassis get $host1

set chas1 [chassis cget -id]

set type [chassis cget -type]

ixPuts -nonewline "Chassis $host1 (id $chas1) is type: "

switch $type \

$::ixia1600 {ixPuts -nonewline "IXIA 1600"} \

$::ixia200 {ixPuts -nonewline "IXIA 200"} \

$::ixia400 {ixPuts -nonewline "IXIA 400"} \

$::ixia100 {ixPuts -nonewline "IXIA 100"} \

$::ixia400C {ixPuts -nonewline "IXIA 400C"} \

$::ixia1600T {ixPuts -nonewline "IXIA 1600T"} \

$::ixiaDemo {ixPuts -nonewline "IXIA Demo"} \

$::ixiaOptIxia {ixPuts -nonewline "IXIA OptIxia"} \

$::ixiaOpixJr {ixPuts -nonewline "IXIA OpixJr"} \

default {ixPuts -nonewline "Unknown"}

set maxCards [chassis cget -maxCardCount]

ixPuts ", which can accommodate $maxCards cards"

chassisChain removeAll

# Add a chassis as the master

chassis setDefault

chassis config -id 1

chassis config -sequence 1

chassis add $host1

# And give it a name after the fact

chassis config -name "test-chassis"

chassis set $host1

# Make sure it's the master

chassis getFromID 1

set master [chassis cget -master]

ixPuts "$host1 is $masterSlave($master)"

chassis setDefault

chassis config -id 2

chassis config -sequence 2

chassis config -cableLength cable6feet

chassis add $host2

# Make sure it's not the master

chassis getFromID 2

set master [chassis cget -master]

ixPuts "$host2 is $masterSlave($master)"

# Release the chassis

chassis del $host1

chassis del $host2

# Disconnect from the chassis we're using

ixDisconnectFromChassis [list $host1 $host2]

# If we're running on UNIX, disconnect from the TCL Server

if [isUNIX] {

ixDisconnectTclServer $host

}

SEE ALSO