unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




 NAME
      atminit - initialization command for an ATM adapter

      atminit_net - initialization command for an ATM network interface

 SYNOPSIS
      /usr/sbin/atminit card_inst_num

      /usr/sbin/atminit_net network_interface

 DESCRIPTION
      atminit initializes an ATM adapter based on the contents of a
      configuration file. If the adapter is not stopped (see atmstop (1M))
      atminit stops it automatically. If no configuration file is found, it
      initializes the adapter with default values. sam (1M) is the preferred
      method of initializing the adapter.  All configuration should be done
      through SAM and not by running atminit in stand-alone mode.

      atminit also initializes all the network interfaces of that adapter
      that have already been configured with the parameter "START AT INIT".
      See the command atminit_net to know how a network interface is
      initialized.

      You must be superuser to use the atminit command.

      A configuration file is comprised of ATM parameter values that are
      used to establish the behavior of the ATM adapter in relation to an
      ATM network. The configuration parameters are described in this man
      page.

      atminit is run automatically by the ATM start-up script at system
      start-up and by SAM (System Administration Manager) during link
      configuration.

      atminit may also be run manually to reset the ATM adapter.  Local
      access to the network is interrupted during execution of atminit. All
      SVCs will be lost. The card will be reinitialized with configuration
      parameters. PVCs will be reestablished if the Classical IP interface
      is configured as "START AT INIT".

      To stop the adapter, use atmstop(1M).

      atminit_net initializes a network interface for an ATM adapter based
      on the contents of a configuration file. If the adapter itself is not
      started atminit_net starts it automatically. It never stops the
      adapter. If the network interface is not stopped atminit_net stops it
      automatically.  A configuration file must be existing.  sam (1M) is
      the preferred method of initializing the network interface.  All
      configuration should be done through SAM and not by running
      atminit_net in stand-alone mode.




				    - 1 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      atminit_net also reestablishes all the predefined PVCs and the
      predefined SVCs traffic descriptors for that network interface.

      You must be superuser to use the atminit_net command.

      To stop the network interface, use atmstop_net, see atmstop(1M).

    Argument
      card_inst_num	The card instance number of the ATM adapter. No
			default. This is the logical unit number of the ATM
			adapter (run the command ioscan -f to get it).

      network_interface The network interface name of the ATM network
			interface.  The network interface name can change
			according to the current release level of the HP-UX
			operating system.  There is no default.	 The netstat
			-i command can be used to display the name of each
			interface that is associated with an ATM adapter
			(see netstat(1)).

 ATM configuration files
      This section describes the format of the ATM configuration files used
      by atminit or atminit_net to initialize an ATM adapter and/or its
      network interfaces.

    ATM Adapter Config File Format
      The file name is /etc/atm/atm_x/nic.  It defines the configuration
      parameters for card instance number x.

      # HP_ATM_CARD_NAME	  Name of interface (atm0, atm1...)

      # HP_ATM_PHYSICAL_TYPE	  Transmission Convergence type
				  (SONET or SDH) (Default = SONET)

      # HP_ATM_MAX_VPIBITS	  Maximum VPI bits

      # HP_ATM_MAX_VCIBITS	  Maximum VCI bits

      # HP_ATM_NETWORK_PREFIX	  Network prefix of the ATM address of
				  interface (optional)

      # HP_ATM_ESI		  Software MAC address (this may be the same
				  as the hardware/adapter MAC address.)

      # HP_ATM_ILMI_VPI		  VPI to be used for ILMI (Default = 0)

      # HP_ATM_ILMI_VCI		  VCI to be used for ILMI (Default = 16)

      # HP_ATM_UNI_VERSION=3.0	  UNI version





				    - 2 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




    EXAMPLE
      HP_ATM_CARD_NAME=atm0

      HP_ATM_PHYSICAL_TYPE=SONET

      HP_ATM_MAX_VPIBITS=2

      HP_ATM_MAX_VCIBITS=9

      HP_ATM_NETWORK_PREFIX=

      HP_ATM_ESI=0060b0221e59

      HP_ATM_ILMI_VPI=0

      HP_ATM_ILMI_VCI=16

      HP_ATM_UNI_VERSION=3.0

    PARAMETER DESCRIPTION
      HP_ATM_CARD_NAME

      This parameter is used to specify the card name.	It is a string of
      the form nameunit , such as atm0, where "atm" is the name of an card
      associated with an ATM adapter, and "0" is the instance number of the
      ATM adapter (run the command ioscan -f to get it).

      HP_ATM_PHYSICAL_TYPE

      This parameter is used to specify the physical layer transmission
      convergence type. There are two types of TC supported by the hardware:

      +	 Sonet STS3c

      +	 SDH STM1.

      The default TC is Sonet STS3c = SONET

      Valid values are: SONET, SDH

      HP_ATM_MAX_VPIBITS/HP_ATM_MAX_VCIBITS

      This parameter is used to specify the maximum number of VPI bits and
      the maximum number of VCI bits.

      On an ATM-HSC 155 Mbit/s and 155 Mbit/s [+] adapters

      The following specifies the default range of VPIs and VCIs:

      +	 Range of VPI = 0




				    - 3 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      +	 Range of VCI = 0 - 2047

      Valid range for HP_ATM_MAX_VPIBITS: 0 - 4.

      Valid range for HP_ATM_MAX_VCIBITS: 11 - 7.

      Note:	The sum of HP_ATM_MAX_VPIBITS + HP_ATM_MAX_VCIBITS must be
      11.

      On an ATM-HP-PB 155 Mbit/s adapter

      The following specifies the default range of VPIs and VCIs:

      +	 Range of VPI = 0 - 1

      +	 Range of VCI = 0 - 2047

      Valid range for HP_ATM_MAX_VPIBITS: 1 - 4.

      Valid range for HP_ATM_MAX_VCIBITS: 10 - 7.

      Note:	The sum of HP_ATM_MAX_VPIBITS + HP_ATM_MAX_VCIBITS must be
      11.

      On an ATM-HSC 622 Mbit/s adapter

      The following specifies the default range of VPIs and VCIs:

      +	 Range of VPI = 0

      +	 Range of VCI = 0 - 4095

      Valid range for HP_ATM_MAX_VPIBITS: 0 - 4.

      Valid range for HP_ATM_MAX_VCIBITS: 12 - 8.

      Note:	The sum of HP_ATM_MAX_VPIBITS + HP_ATM_MAX_VCIBITS must be
      12.

      HP_ATM_NETWORK_PREFIX

      This parameter is used to specify the Network Prefix portion of the
      ATM address of the card. It is optional.

      If this parameter is not specified, ILMI address registration will be
      used to automatically retrieve the network prefix from the network and
      configure it.  The switch to which the card is connected must be UNI
      3.0 compliant and also support ILMI. Note that when ILMI address
      registration is active, the network prefix may dynamically change,
      following network prefix registration or deregistration initiated by
      the network.



				    - 4 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      The user configuring the card may want to override automatic
      configuration and provide a manual configuration. This may happen if
      ILMI address registration does not occur automatically, or if the user
      wants to force a permanent manually configured network prefix. The
      user will then enter 26 hexadecimal digits as the network prefix
      parameter. The ILMI address registration will be deactivated, and the
      manual network prefix will be configured in the card. This manually
      configured network prefix will remain unchanged all the time the ILMI
      address registration is deactivated, and remain independent of any
      network prefix registration or deregistration initiated by the
      network. Users who want to unconfigure the manual network prefix and
      reactivate ILMI address registration, must remove the manually entered
      value.

      HP_ATM_ESI

      This parameter is used to specify the End System Identifier (ESI) part
      of the ATM address of the card. It is 12 hexadecimal digits parameter.
      It cannot be set with SAM because it is not an editable field in
      "Configuration ATM Card Parameters" screen. You can change ESI with
      "atmmgr <card inst#> macaddr -A <mac addr>" command or use the side
      door; that is, manually change it to this parameter through the NIC
      configuration file. When the "atminit <card inst#>" command is invoked
      (through SAM or command line), it will set the software MAC address
      with the value of this parameter.

      HP_ATM_ILMI_VPI/HP_ATM_ILMI_VCI

      This parameter is used to set the ILMI VPI and VCI.

      The default VPI is 0 and the default VCI is 16.

      The valid range for HP_ATM_ILMI_VPI is determined by the maximum
      number of VPI bits configured.

      The valid range for HP_ATM_ILMI_VCI is determined by the maximum
      number of VCI bits configured.

    CIP Interface Config File Format
      The file name is /etc/atm/atm_x/ipyy or /etc/atm/atm_x/cipyyy[y].	 It
      defines the configuration parameters of the interface ipyy or
      cipyyy[y] for card instance number x.

      # HP_ATM_INTERFACE_NAME	  Name of network interface (such as ipa0 or
      cip100)

      # HP_ATM_ATMARP_SERVER_TYPE

      # SERVER if this node is an ATM ARP server, CLIENT if not
				    (Default = SERVER)




				    - 5 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      # HP_ATM_ATMARP_SERVER_ADDRESS

      # ATM address of the ATM ARP server for an ATM ARP client

      # HP_ATM_IP_ADDRESS	  IP address for this network interface

      # HP_ATM_SUBNET_MASK	  subnet mask for this network interface

      # HP_ATM_START_AT_INIT	  if yes the interface is initialized
      automatically by the command atminit

      # HP_ATM_MTU_SIZE		  size of the MTU for this network interface

    EXAMPLE
      HP_ATM_INTERFACE_NAME=cip100

      HP_ATM_ATMARP_SERVER_TYPE=SERVER

      HP_ATM_ATMARP_SERVER_ADDRESS=

      HP_ATM_IP_ADDRESS=25.128.175.65

      HP_ATM_SUBNET_MASK=255.255.248.0

      HP_ATM_START_AT_INIT=Yes

      HP_ATM_MTU_SIZE=9180

    PARAMETER DESCRIPTION
      HP_ATM_INTERFACE_NAME

      This parameter is used to specify the interface name.

      HP_ATM_ATMARP_SERVER_TYPE

      This parameter is used to specify the ATM ARP behavior for this node.

      ARP (Address Resolution Protocol) is used to map IP information onto
      ATM addresses. The ATM ARP Server node provides the mapping, while an
      ATM ARP Client node requests the information from the ATM ARP Server.
      The ATM card can be configured as either an ATM ARP Server or Client.


      Valid values are CLIENT or SERVER.

      The default value is SERVER.

      HP_ATM_ATMARP_SERVER_ADDRESS

      This parameter is used to specify the ATM address of the ATM ARP
      server for this node. It is only required if HP_ATM_ATMARP_SERVER_TYPE



				    - 6 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      = CLIENT.	 The user will enter 40 hexadecimal digits.

      There is no default value.

      The input is not checked.	 If the card is an ATM ARP Client node, you
      must supply the ATM ARP Server's ATM address. If the card is an ATM
      ARP Server node, do not enter a value for this parameter.

      HP_ATM_IP_ADDRESS

      This parameter is used to specify the IP address of the network
      interface. The ATM adapter has a network interface for every network
      that it is a member of. Every network interface needs a unique IP
      address. For example, if you configure one Classical IP interface and
      two emulated LAN interfaces, then you must configure each interface
      with a unique IP address.

      Each network interface in a system must belong to a different subnet.

      The IP address consists of four numbers, separated by dots (periods).
      You should obtain the IP address from the system administrator or
      network administrator.

      There is no default value.

      HP_ATM_SUBNET_MASK

      If your network uses subnet masks, this parameter is used to specify
      the subnet mask for the ATM adapter. The subnet mask consists of four
      numbers, separated by dots (periods).

      Obtain the subnet mask from the system administrator or network
      administrator.

      There is no default value.  It is a required field if subnets are
      being used.

      HP_ATM_START_AT_INIT

      Start at Init sets whether the interface is started when the ATM
      adapter is initialized.

      Default is No.

      HP_ATM_MTU_SIZE

      The MTU (Maximum Transfer Unit) is the maximum allowable size of a
      frame for a given protocol.

      It is mandatory for an IP interface, optional for an ELAN interface.




				    - 7 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      For Classical IP over ATM, we recommend that you set the MTU size to
      9180 bytes.You must ensure that the same MTU Size is configured on all
      systems that belong to the same Classical IP subnet.

      For Classical IP, MTU Sizes greater then 9180 bytes are currently not
      supported.

      For ELAN interfaces, if you do not configure any value, then configure
      the MTU Size (sometimes known as Max. Frame Size) in the LECS.  The
      value configured in the LECS is used. Also, if you do not configure
      any value, and do not configure the MTU Size in the LECS, then 1516
      bytes is used (the default MTU size for Ethernet).

      For ELAN interfaces, if you configure a value, then choose one of the
      following:

      * 1516 bytes: If you are connecting to a legacy Ethernet LAN, and do
      not (or are unable to) configure the MTU Size (Max. Frame Size) in the
      LECS, then set the MTU size here to 1516 bytes.

      * 1580 bytes, 4544 bytes, 9234 bytes or 18190 bytes:If you are running
      LAN Emulation for ATM-connected devices only and are able to use an
      MTU Size greater than 1516 bytes, then set another value. If you are
      enabling MPC and/or LLC multiplexing, setting MTU size to 1580 bytes
      is recommended. Note that you must set the same MTU Size for all LECs
      on the same ELAN.

      The MTU Size configured in the LECS takes priority over the value
      configured in this configuration file. Therefore, if you configure an
      MTU Size in SAM, check that there is no MTU Size configured in the
      LECS, otherwise the LECS value will be used instead.

    ELAN Interface Config File Format
      The file name is /etc/atm/atm_x/elyy[y].	It defines the configuration
      parameters of the interface elyy[y] for card instance number x.

      # HP_ATM_INTERFACE_NAME	  Name of network interface (such as ela0 or
      el100)

      # HP_ATM_IP_ADDRESS	  IP address for this network interface

      # HP_ATM_SUBNET_MASK	  subnet mask for this network interface

      # HP_ATM_START_AT_INIT	  if yes the interface is initialized
      automatically by the command atminit

      # HP_ATM_MTU_SIZE		  size of the MTU for this network interface
      (optional)

      # HP_ATM_MAC_ADDRESS=	  mac address for that interface (mandatory)




				    - 8 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      # HP_ATM_LANE_VERSION=	  LANE version (mandatory, default is 1)

      # HP_ATM_LEC_LLC_SEL=	  selector of LLC multiplexing (optional,
      default is 01 for LANE v2, N/A if LLC mux is not enabled and/or LANE
      v1 is set)

      # HP_ATM_LECS[1]=		  primary LECS ATM address (optional)

      # HP_ATM_SEL[1]=		  selector of the primary ATM address of the
      interface (mandatory)

      # HP_ATM_ELAN_NAME[1]=	  elan name for the primary LECS (optional)

      # HP_ATM_MPC_SEL[1]=	  selector of the primary MPC (optional, N/A
      if MPC is not enabled and/or LANE v1 is set)

      # HP_ATM_LECS[2]=		  secondary LECS ATM address (optional)

      # HP_ATM_SEL[2]=		  selector of the secondary ATM address of
      the interface (optional)

      # HP_ATM_ELAN_NAME[2]=	  elan name for the secondary LECS
      (optional)

      # HP_ATM_MPC_SEL[2]=	  selector of the secondary MPC (optional,
      N/A if MPC is not enabled and/or LANE v1 is set)

    EXAMPLE
      HP_ATM_INTERFACE_NAME=el100

      HP_ATM_IP_ADDRESS=25.128.175.65

      HP_ATM_SUBNET_MASK=255.255.248.0

      HP_ATM_START_AT_INIT=Yes

      HP_ATM_MTU_SIZE=1516

      HP_ATM_MAC_ADDRESS=080009c6fc0a

      HP_ATM_LANE_VERSION=2

      HP_ATM_LEC_LLC_SEL=01

      HP_ATM_LECS[1]=4700790000000000000000000000a03e00000100

      HP_ATM_SEL[1]=4

      HP_ATM_ELAN_NAME[1]=MKTG





				    - 9 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      HP_ATM_MPC_SEL[1]=01

      HP_ATM_LECS[2]=

      HP_ATM_SEL[2]=

      HP_ATM_ELAN_NAME[2]=

      HP_ATM_MPC_SEL[2]=


    PARAMETER DESCRIPTION
      In this paragraph only the parameters specific for an ELAN interface
      are described. For those similar to the IP interface parameters,
      please refer to the previous paragraph.

      HP_ATM_MAC_ADDRESS

      This mandatory parameter specifies the MAC address to use for that
      interface.

      Each member of an ELAN must have a unique MAC address. The recommended
      value for a non-bridged ELAN is the hardware MAC address stored in the
      adapter's PROM.  If you experience problems with bridged ELANs, you
      should configure a unique MAC address for each ELAN interface of the
      ATM adapter.

      HP_ATM_LANE_VERSION

      This mandatory parameter specifies the LANE version. The default value
      is 1.

      LANE v2 provides additional features, such as LLC Multiplexing, MPOA,
      multicasting, ...etc.

      HP_ATM_LEC_LLC_SEL

      This optional parameter specifies the ATM address Selector of the LLC
      (Logical Link Control) SAP for this interface. The default value is
      "01". This selector can be shared between several LEC interfaces and
      an MPC.

      NOTE: This selector value can't be 00 which is reserved for CIP.

      HP_ATM_LECS[1]

      This optional parameter specifies the ATM address of the Primary LECS
      (LAN Emulation Configuration Server).  The Primary LECS is the main
      LECS that this interface is to use. If you don't specify the ATM
      address of the Primary LECS, it is automatically retrieved from the
      network using ILMI address registration.



				   - 10 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      HP_ATM_SEL[1]

      This mandatory parameter specifies the ATM address Selector of the
      Primary LEC (LAN Emulation Client) on this interface.

      The Selector field of the ATM address is the last byte of the ATM
      Address.	The Selector must be unique for each ELAN interface, as it
      is used to identify each logical LEC that the ATM adapter has for each
      ELAN that it is a member of.  Therefore, no two ELAN interfaces for an
      adapter can have the same LEC Selector value.

      When you configure the ATM adapter's ATM address, the Selector is
      automatically set to 00. The LEC Selector for each ELAN interface that
      you configure on the adapter then must be unique; that is 01, 02, 03
      etc.

      HP_ATM_ELAN_NAME[1]

      This optional parameter specifies the name of the Primary ELAN that
      the LEC is to join.  This ELAN must be configured to associate with a
      LES (LAN Emulation Server) in the primary LECS configuration file on
      your ATM switch or wherever your ELAN services reside.  See your LECS
      documentation for more details on configuring your LECS.

      NOTE: Only one LEC per ATM adapter can be part of the same ELAN.

      HP_ATM_MPC_SEL[1]

      This optional parameter specifies the ATM address Selector for both
      control and data SAPs of the MPC (MPOA Client) serving the Primary LEC
      on this interface.  An MPC can serve only one LEC. Therefore, this MPC
      Selector value must be unique for a given adapter.

      NOTE: This selector value can't be 00, which is reserved for CIP.

      HP_ATM_LECS[2]

      This optional parameter specifies the ATM address of the Secondary
      LECS.

      You may define a Secondary LECS and a Secondary ELAN to assure High
      Availability.  They will act as backup if the Primary LECS, LES or BUS
      fails, thus providing LECS, LES and BUS redundancy.


      You may choose one of the following configurations of backup:

      * Define both a different High Availability LECS and ELAN than the
      Primary LECS and ELAN. This scheme requires two LECS, with the primary
      ELAN being defined on the primary LECS and the secondary ELAN being
      defined on the secondary LECS. If any of the LECS, LES or BUS fails,



				   - 11 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      then backup is provided.

      * Define the same High Availability LECS as the Primary LECS (that is,
      have only one LECS) and a different High Availability ELAN. This
      provides LES/BUS redundancy. In this case, enter the same LECS ATM
      address in both the Primary LECS and High Availability LECS ATM
      address fields, and define a different Secondary ELAN. You then create
      a definition for this ELAN in the LECS configuration file, mapping it
      to a Secondary LES.  Now if the LAN Emulation Services fail, the LEC
      switches over to the backup ELAN and the backup LES.

      * Define a different High Availability LECS than the Primary LECS
      (that is, have two LECS) and the same Secondary ELAN. In this case
      enter the ATM address of the Secondary LECS in this field, and enter
      the same ELAN name in the Secondary ELAN field that you entered in the
      primary ELAN field. If the Primary LECS then fails, the LEC then
      switches over to using the Secondary LECS.  The ELAN is also defined
      with the same LES in the secondary LECS configuration file, so the LEC
      can still join the ELAN even if the Primary LECS fails.

      HP_ATM_SEL[2]

      This optional parameter specifies the ATM address Selector of the
      Secondary LEC on this interface.

      HP_ATM_ELAN_NAME[2]

      This optional parameter specifies the name of the secondary ELAN that
      the LEC is to join.  This ELAN must be configured to associate with a
      LES in the secondary LECS configuration file.  You can only configure
      one interface on the ATM adapter to join the same ELAN.  See your LECS
      documentation for more details on configuring your LECS.

      HP_ATM_MPC_SEL[2]

      This optional parameter specifies the ATM address Selector for both
      control and data SAPs of the MPC serving the Secondary LEC on this
      interface.  An MPC can serve only one LEC. Therefore, this MPC
      Selector value must be unique for a given adapter.

      NOTE: This selector value can't be 00, which is reserved for CIP.

 AUTHOR
      atminit was developed by HP.

 FILES
      /etc/atm/atm_x/nic, where x stands for the card instance number.
      It contains ATM configuration information per adapter.
      /etc/atm/atm_x/ipxx or /etc/atm/atm_x/cipxxx[x]
      It contains classical IP network interface configuration information.




				   - 12 -	  Formatted:  August 2, 2006






 atminit/atminit_net(1M)			     atminit/atminit_net(1M)




      /etc/atm/atm_x/elxx[x]
      It contains LEC network interface configuration information.
 SEE ALSO
      atmstop(1M), atmmgr(1M)


















































				   - 13 -	  Formatted:  August 2, 2006