FC Functions¶

sth::fc_config¶

Purpose¶

Configures Fibre Channel (FC) nodes for the specified Spirent HLTAPI port. FC is a gigabit-speed network technology primarily used for storage networking.

Synopsis¶

Note

M indicates that the argument is Mandatory .

sth::fc_config
    [-mode {create|modify|reset}  M]
    [-port_handle <port_handle>]
    [-handle <FC device handle>]
      [-host_type {initiator | target | both}]
      [-login_delay <1-1000>]
      [-logout_delay <1-1000>]
      [-nport_count <1-2000>]
      [-wwnn <aa:bb:cc:dd:ee:ff:gg:hh>]
      [-wwpn <aa:bb:cc:dd:ee:ff:gg:hh>]
      [-wwpn_step <aa:bb:cc:dd:ee:ff:gg:hh>]
      [-use_interface {true|false}]
      [-wwnn_step <64-bit hexadecimal>]
      [-wwnn_port  <64-bit hexadecimal>]
      [-wwnn_port_step  <64-bit hexadecimal>]
      [-retry_count <NUMERIC>]
      [-retry_timer  <NUMERIC>]
      [-remote_retry_count  <NUMERIC>]
      [-remote_retry_timer  <NUMERIC>]
      [-reset_link {true|false}]
      [-fc_topology {VN_N_PORT_TO_VN_N_PORT|N_PORT_TO_F_PORT}]
      [-ed_tov <NUMERIC>]
      [-ra_tov_host <NUMERIC>]
      [-ra_tov_port <NUMERIC>]
      [-rxcredit_port <NUMERIC>]
      [-rxcredit_host <NUMERIC>]
      [-domain_id <NUMERIC>]
      [-domain_id_step <1-255>]
      [-host_per_port <1-1000>]
      [-create_traffic {true|false}]
      [-group_method {AGGREGATE|HOST}]
      [-traffic_flow {LEFT_TO_RIGHT|RIGHT_TO_LEFT|BIDIRECTIONAL|BACKBONE}]
      [-traffic_flow_size <12-16383>]
      [-traffic_percent_ports <0-100>]

Arguments¶

-port_handle¶: Specifies the handle of the port on which to configure FC emulation. This argument is Mandatory for the create mode. Please refer to the description of the -mode argument.

-handle¶: Specifies the handle of the FC device(s). The handle is returned by the sth::fc_config function. This argument is Mandatory only for the modify and the reset modes.

-mode¶

Specifies the action to be taken. This argument is Mandatory . Possible values are described below:

create - Starts emulating FC device(s) on the port
     specified by the -port_handle argument.

modify - Changes the configuration parameters for the
     FC device(s) identified by the -handle
     argument.

reset - Deletes the FC device(s) identified by the
     -handle argument.

-host_type¶

Specifies whether hosts will register the name server as a initiator, target, or both. The default value is initiator. Possible values are described below:

initiator - Indicates the Small Computer System
       Interface (SCSI) Initiator. The SCSI is a
       set of standards for physically connecting and
       transferring data between computers and peripheral
       devices.

target  - Indicates the SCSI Target.

both   - Indicates both the SCSI Initiator and the
         SCSI Target.

-logout_delay¶: Specifies the logout delay timer that defines the interval between logout actions when two or more logout functions are performed. The value of this argument will be applied when several logout messages are sent. Possible values range from 1(ms) to 1000(ms). The default is 10(ms).

-login_delay¶: Specifies the login delay timer that defines the interval between login actions when two or more login functions are performed. The value of this argument will be applied when several login messages are sent. Possible values range from 1(ms) to 1000(ms). The default is 10(ms).

-nport_count¶: Specifies the number of the N_Ports to be created. The default value is 1.

-wwnn¶: Indicates the starting World Wide Node Name (WWNN) of the FC hosts. The value of this argument must be a 64-bit hexadecimal value. The default is 10:00:10:94:00:00:00:01.

-wwpn¶: Starting the WWPN of the FC devices. A WWPN is a World Wide Name assigned to a port in a Fibre Channel fabric. Used on storage area networks, it performs a function equivalent to the MAC address in the Ethernet protocol. It intends to be a unique identifier in the network. The value of this argument must be a 64-bit hexadecimal value. The default is 20:00:10:94:00:00:00:01.

-wwpn_step¶: Specifies the WWPN step for the FC hosts. The step must be a 64-bit hexadecimal value. The default is 00:00:00:00:00:00:00:01.

-use_interface¶