Install Linux Server (INSLNXSVR)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Install Linux Server (INSLNXSVR) command installs a supported Linux or VMware Operating System on an integrated server. INSLNXSVR also installs Integrated Server Support code on the server.

Linux server installation occurs in two steps. During the first step, the INSLNXSVR command creates necessary objects to manage the server. This includes a network server description, message queue, line descriptions, storage spaces and TCP/IP interfaces.

During the second step of the Linux server installation, the integrated server is varied on to start the Linux server installation.

Further Linux server installation is performed using the integrated server console and the normal Linux server install process.

When INSLNXSVR completes normally, the Linux server is left in a varied on state.

Restrictions:

  1. You must have input/output system configuration (*IOSYSCFG), all object (*ALLOBJ) and job control (*JOBCTL) special authorities to run this command.
  2. This command may require interactive input using the integrated server console.
  3. The integrated server must be varied off initially.
  4. The integrated server may reboot during the second step of the install as the Linux server installs.

Usage Notes:

Any errors that occur during the first step of configuring the integrated server will result in the failure of this command.

After this command is run, if you need to manage the different resources created, use the following commands:

Top

Parameters

Keyword Description Choices Notes
NWSD Network server description Communications name Required, Key, Positional 1
LNXSVRDST Linux server distribution Character value Required, Positional 2
TCPPORTCFG TCP/IP port configuration Single values: *NONE
Other values (up to 4 repetitions): Element list
Optional
Element 1: Port 1, 2, 3, 4
Element 2: Linux internet address Character value
Element 3: Linux subnet mask Character value
Element 4: Linux gateway address Character value, *NONE
VRTETHPORT Virtual Ethernet port Single values: *NONE
Other values (up to 4 repetitions): Element list
Optional
Element 1: Port *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9
Element 2: Linux internet address Character value
Element 3: Linux subnet mask Character value
Element 4: Associated port Name, *NONE
TCPDMNNAME TCP/IP local domain name Character value, *SYS Optional
TCPNAMSVR TCP/IP name server system Single values: *SYS, *NONE
Other values (up to 3 repetitions): Character value
Optional
SVRSTGSIZE Server storage space sizes Element list Optional
Element 1: Install source size 200-2047, *CALC
Element 2: System size 1024-1024000, *CALC
SVRSTGASP Storage space ASP Element list Optional
Element 1: Install source ASP 1-255, 1
Element 2: System ASP 1-255, 1
STGASPDEV Server storage ASP device Element list Optional
Element 1: Install source ASP device Name
Element 2: System ASP device Name
LNGVER Language version Integer, *PRIMARY, 2922, 2923, 2924, 2928, 2929, 2930, 2931, 2938, 2939, 2940, 2956, 2962, 2963, 2966, 2980, 2981, 2984, 2986, 2987, 2989, 2996 Optional
SYNCTIME Synchronize date and time *NONE, *YES, *NO Optional
RSTDDEVRSC Restricted device resources Single values: *NONE, *ALL
Other values (up to 10 repetitions): Name, *ALLTAPE, *ALLOPT
Optional
SHUTDTIMO Shutdown timeout 2-45, 15 Optional
ACTTMR Activation timer 30-1800, 120 Optional
CMNMSGQ Communications message queue Single values: *SYSOPR
Other values: Qualified object name
Optional
Qualifier 1: Communications message queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
STGPTH Storage path Element list Optional
Element 1: Network server host adapter Name
POOL Pool identifier *BASE, *SHRPOOL1, *SHRPOOL2, *SHRPOOL3, *SHRPOOL4, *SHRPOOL5, *SHRPOOL6, *SHRPOOL7, *SHRPOOL8, *SHRPOOL9, *SHRPOOL10, *SHRPOOL11, *SHRPOOL12, *SHRPOOL13, *SHRPOOL14, *SHRPOOL15, *SHRPOOL16, *SHRPOOL17, *SHRPOOL18, *SHRPOOL19, *SHRPOOL20, *SHRPOOL21, *SHRPOOL22, *SHRPOOL23, *SHRPOOL24, *SHRPOOL25, *SHRPOOL26, *SHRPOOL27, *SHRPOOL28, *SHRPOOL29, *SHRPOOL30, *SHRPOOL31, *SHRPOOL32, *SHRPOOL33, *SHRPOOL34, *SHRPOOL35, *SHRPOOL36, *SHRPOOL37, *SHRPOOL38, *SHRPOOL39, *SHRPOOL40, *SHRPOOL41, *SHRPOOL42, *SHRPOOL43, *SHRPOOL44, *SHRPOOL45, *SHRPOOL46, *SHRPOOL47, *SHRPOOL48, *SHRPOOL49, *SHRPOOL50, *SHRPOOL51, *SHRPOOL52, *SHRPOOL53, *SHRPOOL54, *SHRPOOL55, *SHRPOOL56, *SHRPOOL57, *SHRPOOL58, *SHRPOOL59, *SHRPOOL60 Optional
VRTETHPTH Virtual Ethernet path Values (up to 5 repetitions): Element list Optional
Element 1: Port *VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9
Element 2: Network server host adapter Name
VRTETHCTLP Virtual Ethernet control port 1024-65535, 8800 Optional
RMTNWSCFG Remote system NWSCFG Name, *DFT Optional
SPNWSCFG Service processor NWSCFG Name, *DFT Optional
CNNNWSCFG Connection security NWSCFG Name, *DFT Optional
INZSP Initialize service processor *NONE, *SYNC Optional
ENBUNICAST Enable unicast *YES, *NO Optional
EID Enclosure identifier Single values: *AUTO
Other values: Element list
Optional
Element 1: Serial number Character value
Element 2: Manufacturer type and model Character value
SPNAME Service processor name Character value, *SPINTNETA Optional
SPINTNETA SP internet address Character value Optional
SPAUT SP authentication Single values: *DFT
Other values: Element list
Optional
Element 1: User name Character value
Element 2: User password Character value
RMTSYSID Remote system identifier Single values: *EID
Other values: Element list
Optional
Element 1: Serial number Character value
Element 2: Manufacturer type and model Character value
DELIVERY Delivery method *DYNAMIC, *MANUAL Optional
CHAPAUT Target CHAP authentication Single values: *NONE
Other values: Element list
Optional
Element 1: CHAP name Character value, *NWSCFG
Element 2: CHAP secret Character value, *GEN
INRCHAPAUT Initiator CHAP authentication Single values: *NONE
Other values: Element list
Optional
Element 1: CHAP name Character value, *NWSCFG
Element 2: CHAP secret Character value, *GEN
BOOTDEVID Boot device ID Single values: *SINGLE
Other values: Element list
Optional
Element 1: Bus 0-255
Element 2: Device 0-31
Element 3: Function 0-7
DYNBOOTOPT Dynamic boot options Element list Optional
Element 1: Vendor ID Character value, *DFT
Element 2: Alternate client ID Character value, *ADPT
RMTIFC Remote (initiator) interfaces Element list Optional
Element 1: SCSI interface Element list
Element 1: Adapter address Hexadecimal value
Element 2: Internet address Character value
Element 3: Subnet mask Character value
Element 4: Gateway address Character value, *NONE
Element 5: iSCSI qualified name Character value, *GEN
Element 2: LAN interface Element list
Element 1: Adapter address Hexadecimal value
Element 2: Internet address Character value
Element 3: Subnet mask Character value
Element 4: Gateway address Character value, *NONE
TEXT Text 'description' Character value, *BLANK Optional
CFGFILE Configuration file Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: Configuration file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
VRTPTPPORT Virtual PTP Ethernet port Element list Optional
Element 1: Internet address Character value, *GEN
Element 2: Linux internet address Character value, *GEN
Top

Network server description (NWSD)

Specifies the name of the network server to be installed. The network server description is created using the values specified in this command. The Create Network Server Description (CRTNWSD) command will be used to create the NWSD. The name should also be used as the computer name of the integrated server that is installed as well as the TCP host name for the integrated server.

This is a required parameter.

communications-name
Specify the name of the network server description.

The network server name can be up to eight characters. The following characters are allowed in NWSD names:

  • Alphabetical characters A through Z
  • Digits 0 through 9
Top

Linux server distribution (LNXSVRDST)

Specifies the integrated server operating system version to install on the integrated server.

Top

TCP/IP port configuration (TCPPORTCFG)

Specifies the TCP/IP configuration values that are specific to a port on the integrated server.

This information consists of four parts including the identification of the integrated server port, the internet address, the subnet mask and the default gateway assigned to the port.

Single values

*NONE
There is no TCP/IP port configuration.

Element 1: Port

Specifies the locally managed integrated server port number.

1
Integrated server port number 1 is configured.
2
Integrated server port number 2 is configured.
3
Integrated server port number 3 is configured.
4
Integrated server port number 4 is configured.

Element 2: Linux internet address

character-value
Specify the internet address associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

An internet address that has a binary value of all ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the internet address is not valid.

Note: The internet address selected must be unique across all network server descriptions and the IBM i TCP/IP configuration.

Element 3: Linux subnet mask

character-value
Specify the subnet mask associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Linux gateway address

*NONE
There is no gateway address.
character-value
Specify the gateway address associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Top

Virtual Ethernet port (VRTETHPORT)

Specifies the TCP/IP configuration for the virtual Ethernet used by the integrated server.

Note: The VRTETHPORT parameter is only available for Integrated xSeries servers.

Single values

*NONE
Do not configure any virtual Ethernet ports.

Element 1: Port

Element 2: Linux internet address

character-value
Specify the internet address associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

An internet address that has a binary value of all ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the internet address is not valid.

Note: The internet address selected must be unique across all network server descriptions and the IBM i TCP/IP configuration.

Element 3: Linux subnet mask

character-value
Specify the subnet mask associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Top

TCP/IP local domain name (TCPDMNNAME)

Specifies the local domain name associated with the integrated server.

*SYS
Specifies that the local domain name for the integrated server should be the same value as is configured for IBM i.
character-value
Specify a TCP domain name to be associated with the integrated server.

A domain name can be a text string having 1 to 255 characters. Domain names consist of one or more labels separated by periods. Each label can contain up to 63 characters. The following characters are allowed in domain names:

  • Alphabetical characters A through Z
  • Digits 0 through 9
  • Minus sign (-)
  • Underscore (_)
  • Period (.). Periods are only allowed when they separate labels of domain style name (refer to RFC 1034).

Uppercase and lowercase characters are allowed, but no significance attached to the case. The case is maintained as entered. The first and last character of the host name must be an alphabetic character or a digit.

Top

TCP/IP name server system (TCPNAMSVR)

Specifies the internet address of the name server system that is used by the integrated server.

Single values

*SYS
The name server systems used by the integrated server should be the same as for IBM i.
*NONE
There is no name server to be used by the integrated server.

Other values (up to 3 repetitions)

character-value
Specify an internet address for the name server system to be used by the integrated server. Up to three remote name server systems can be specified. The name server systems are used in the order they are specified.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Top

Server storage space sizes (SVRSTGSIZE)

Notes:

  1. The contents of the DOSUTILS directory of the Linux server installation media and the Integrated Server Support code are copied to the install source drive. The size specified for the install source drive must be large enough to hold this data.

Element 1: Install source size

Specifies the size of the storage space that holds the files used to install the integrated server operating system.

*CALC
Specify that the system should calculate the size based on the space required to install the integrated server.
200-2047
Specify the install source size value in megabytes.
Top

Storage space ASP (SVRSTGASP)

Top

Server storage ASP device (STGASPDEV)

Top

Language version (LNGVER)

*PRIMARY
The installed language environment for Integrated Server Support text and messages is based on the language feature of the system primary language.
integer
Specify the language feature that will be used to select the Integrated Server Support text and messages.

Prompting (F4) on this field provides a list of values supported for this parameter on this system.

Top

Synchronize date and time (SYNCTIME)

Specifies whether IBM i should synchronize the integrated server date and time with IBM i date and time.

*NONE
IBM i will never synchronize the integrated server date and time with the IBM i date and time when the network server description is varied on.
*YES
IBM i will synchronize integrated server date and time with IBM i date and time.
*NO
IBM i only synchronizes the integrated server date and time with IBM i date and time once when the network server description is varied on.
Top

Restricted device resources (RSTDDEVRSC)

Specifies the tape and optical device resource names that are restricted and cannot be used by the integrated server.

Single values

*NONE
No tape and optical device resources are restricted from the integrated server.
name
Specify the resource name of a restricted device that cannot be used by the integrated server.
Top

Shutdown timeout (SHUTDTIMO)

Specifies the shutdown timeout value in minutes. This is used to limit the amount of time that the integrated server operating system is allowed to shutdown before the network server description is varied off.

15
The integrated server default shutdown time-out value is used.
2-45
Specify the number of minutes to wait. IBM i waits until the integrated server operating system has shutdown successfully, or until the specified time passes before varying the network server description off.
Top

Activation timer (ACTTMR)

Specifies the amount of time (in seconds) the system will wait for the connection to be established to the remote server service processor and to power on the remote server.

120
The activate time of 120 seconds is used.
integer
Specify, in seconds, a value ranging from 30 through 1800.
Top

Communications message queue (CMNMSGQ)

Specifies the name of a message queue to receive network server host adapter communications status messages.

Single values

*SYSOPR
Network server host adapter communications status messages are placed in the system operator message queue.

Qualifier 1: Communications message queue

name
Specify the name of a message queue to receive network server host adapter communications status messages.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.
Top

Storage path (STGPTH)

Specifies the storage path the storage spaces can use.

Top

Pool identifier (POOL)

Specifies the shared data storage pool this integrated server should use.

*BASE
The base pool is to be used by this integrated server.
*SHRPOOLnn
Specifies the shared pool to be used by this integrated server. There are sixty general-purpose shared pools, identified by special values *SHRPOOL1 to *SHRPOOL60.
Top

Virtual Ethernet path (VRTETHPTH)

Specifies the virtual Ethernet paths the Ethernet line descriptions can use. This information consists of two parts including the virtual Ethernet port and the Network server host adapter (NWSH) description.

Top

Virtual Ethernet control port (VRTETHCTLP)

Specifies the TCP port to use for virtual Ethernet control.

8800
Use the TCP port number of 8800.
1024-65535
Specify the port number identifying the port that is to be used for virtual Ethernet control.
Top

Remote system NWSCFG (RMTNWSCFG)

Specifies the remote system network server configuration to use with this server.

name
Specify the name of an existing remote system network server configuration.
Top

Service processor NWSCFG (SPNWSCFG)

Specifies the service processor network server configuration to use with this server.

name
Specify the name of an existing service processor network server configuration.
Top

Connection security NWSCFG (CNNNWSCFG)

Specifies the connection security network server configuration to use with this server.

name
Specify the name of an existing connection security network server configuration.
Top

Initialize service processor (INZSP)

Specifies how the remote system service processor is secured.

*NONE

Provides no security.

Use this only if the interconnecting network is physically secure.

Note: Some service processors do not support secure connections. Use *NONE for these service processors. Additional information can be found at System i integration with BladeCenter and System x at http://www.ibm.com/systems/i/bladecenter/.

Note: This parameter is ignored when the service processor network server configuration specified for the Service processor NWSCFG (SPNWSCFG) parameter already exists.

*SYNC

Synchronize the user name and password and self-signed certificate from the service processor. This option is used to initially synchronize IBM i with the service processor. It is also used if multiple service processor network server configurations are used for the same system or the service processor network server configuration has been restored from backup and the service processor certificate must be synchronized. The current user name and password for the service processor must be specified on the SP authentication (SPAUT) parameter to perform this option.

Top

Enable unicast (ENBUNICAST)

Specifies whether unicast packet distribution is to be used. Unicast is a transmission method where packets are sent directly to the specified Service processor name (SPNAME) or SP internet address (SPINTNETA) parameter.

Note: This parameter is ignored when the service processor network server configuration specified for the Service processor NWSCFG (SPNWSCFG) parameter already exists.

*YES
Enable unicast.
*NO
Disable unicast
Top

Enclosure identifier (EID)

Specifies the identifying serial number, type and model of the enclosure containing the service processor.

When specified, they are used to identify and verify the system on the network.

Look for these values on the label of the system.

Note: This parameter is ignored when the service processor network server configuration specified for the Service processor NWSCFG (SPNWSCFG) parameter already exists.

Single values

*AUTO
Automatically retrieve the identifier.

Element 1: Serial number

character-value
Specify the machine serial number.

Element 2: Manufacturer type and model

character-value
Specify the machine type and model.

The value is entered in the form ttttmmm where tttt is the machine type and mmm is the machine model number.

Top

Service processor name (SPNAME)

Specifies the remote system service processor host name.

Note: This parameter is ignored when the service processor network server configuration specified for the Service processor NWSCFG (SPNWSCFG) parameter already exists.

Notes:

  1. This parameter is required when ENBUNICAST(*YES) is specified.
  2. This parameter is ignored when ENBUNICAST(*NO) is specified.
*SPINTNETA

The remote system is identified by the value specified for the SP internet address (SPINTNETA) parameter.

character-value
Specify the remote system service processor host name.
Top

SP internet address (SPINTNETA)

Specifies the remote system service processor internet address.

Note: This parameter is ignored when the service processor network server configuration specified for the Service processor NWSCFG (SPNWSCFG) parameter already exists.

Notes:

  1. This parameter is required when SPNAME(*SPINTNETA) is specified.
character-value
Specify the internet address of the service processor.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Top

SP authentication (SPAUT)

Specifies the service processor user name and password. This is used to authenticate and secure the service processor.

Note: This parameter is ignored when the service processor network server configuration specified for the Service processor NWSCFG (SPNWSCFG) parameter already exists.

Single values

*DFT
The default service processor userid and password are used.

Element 1: User name

character-value
Specify a name that represents the host configuration that owns the service processor. It is suggested that the remote system network server configuration name be used. If multiple remote system network server configurations use the same service processor at different times, each configuration must contain the same user name and password.

Element 2: User password

character-value
Specify the service processor password. Password must be at least 5 characters in length and contain at least one alphabetic character and one numeric or symbolic character.
Top

Remote system identifier (RMTSYSID)

Specifies the identifying serial number, type and model of the remote system. When specified, they are used to locate the remote system on the network.

Look for these values on the label of the system.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

Single values

*EID
Use the service processor identifier.

Element 1: Serial number

character-value
Specify the machine serial number.

Element 2: Manufacturer type and model

character-value
Specify the machine type and model.

The value is entered in the form ttttmmm where tttt is the machine type and mmm is the machine model number.

Top

Delivery method (DELIVERY)

Specifies how the parameters necessary to configure the remote system are delivered.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

*DYNAMIC
Parameters are dynamically delivered to the remote system using Dynamic Host Configuration Protocol (DHCP).
*MANUAL
Parameters are manually configured on the remote system using the BIOS utilities (System BIOS or Adapter BIOS - CTRL-Q).
Top

Target CHAP authentication (CHAPAUT)

Specifies the Challenge Handshake Authentication Protocol (CHAP) for the System i iSCSI target to authenticate the remote system iSCSI initiators.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

Single values

*NONE
CHAP authentication is not enabled.

Element 1: CHAP name

*NWSCFG
The system will automatically generate a name for CHAP using the Network server configuration name.
character-value
Specify the name you want to use for the Challenge Handshake Authentication Protocol.

Valid characters are upper case A through Z, lower case a through z, numbers 0 through 9, and the following special characters:

  • Plus sign
  • Equal sign
  • Percent
  • Ampersand
  • Left parenthesis
  • Right parenthesis
  • Comma
  • Underline
  • Minus sign
  • Period
  • Colon
  • Semicolon

Element 2: CHAP secret

*GEN
The system will automatically generate a random CHAP secret.
character-value
Specify the secret you want to use for the Challenge Handshake Authentication Protocol.

Note: Target and initiator CHAP secrets must not be the same.

Valid characters are upper case A through Z, lower case a through z, numbers 0 through 9, and the following special characters:

  • Plus sign
  • Equal sign
  • Percent
  • Ampersand
  • Left parenthesis
  • Right parenthesis
  • Comma
  • Underline
  • Minus sign
  • Period
  • Colon
  • Semicolon
Top

Initiator CHAP authentication (INRCHAPAUT)

Specifies the Challenge Handshake Authentication Protocol (CHAP) for the remote system iSCSI initiators to authenticate the System i iSCSI target.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

Single values

*NONE
CHAP authentication is not enabled.

Element 1: CHAP name

*NWSCFG
The system will automatically generate a name for CHAP using the Network server configuration name.
character-value
Specify the name you want to use for the Challenge Handshake Authentication Protocol.

Valid characters are upper case A through Z, lower case a through z, numbers 0 through 9, and the following special characters:

  • Plus sign
  • Equal sign
  • Percent
  • Ampersand
  • Left parenthesis
  • Right parenthesis
  • Comma
  • Underline
  • Minus sign
  • Period
  • Colon
  • Semicolon

Element 2: CHAP secret

*GEN
The system will automatically generate a random CHAP secret.
character-value
Specify the secret you want to use for the Challenge Handshake Authentication Protocol.

Note: Target and initiator CHAP secrets must not be the same.

Valid characters are upper case A through Z, lower case a through z, numbers 0 through 9, and the following special characters:

  • Plus sign
  • Equal sign
  • Percent
  • Ampersand
  • Left parenthesis
  • Right parenthesis
  • Comma
  • Underline
  • Minus sign
  • Period
  • Colon
  • Semicolon
Top

Boot device ID (BOOTDEVID)

Specifies the PCI Function Address (Bus/Device/Function) of the iSCSI initiator port in the remote system that will be used to boot from.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

Single values

*SINGLE
The single iSCSI initiator port is used on the remote system

Element 1: Bus

0-255
Specify the bus number of the remote system iSCSI initiator port that will be used to boot.

Element 2: Device

0-31
Specify the device number of the remote system iSCSI initiator port that will be used to boot.

Element 3: Function

0-7
Specify the function number of the remote system iSCSI initiator port that will be used to boot.
Top

Dynamic boot options (DYNBOOTOPT)

Specifies the internal Dynamic Host Configuration Protocol (DHCP) Server configuration.

Note: This is an advanced configuration function.

This parameter is used to configure the internal DHCP Server that is part of the iSCSI target host bus adapter (HBA) firmware. It is used to provide IP address and diskless boot parameters for the remote system iSCSI initiator port.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

This parameter is only valid when DELIVERY(*DYNAMIC) is specified.

Element 1: Vendor ID

The client and server are pre-configured to a default vendor ID. Network administrators can configure clients to define their own identifying values to convey hardware, operating system or other identifying information. DHCP option 60 described in the IETF RFC 2132 is used for this function.

*DFT
The default vendor ID will be used.
character-value
Vendor ID of the remote system iSCSI initiator port that will be used.

Element 2: Alternate client ID

Used by clients to specify their unique identifier to the server. Each client identifier must be unique among all other client identifiers used on the effective DHCP network to which the client is attached (that is, the client local subnet and any remote subnets reachable using DHCP relay). Vendors and system administrators are responsible for choosing client identifiers that meet this requirement for uniqueness. DHCP option 61 described in the IETF RFC 2132 is used for this function.

*ADPT
The default Client ID consists of the adapter address for the remote system iSCSI initiator port. This value will be used to identify the remote system.
character-value
Specify the Client ID of the remote system iSCSI initiator port that will be used to boot.
Top

Remote (initiator) interfaces (RMTIFC)

Specifies the remote system iSCSI initiator host bus adapter (HBA) configuration. Each iSCSI initiator port has two functions to support a SCSI and a LAN or TCP Offload Engine (TOE) interface.

Note: This parameter is ignored when the remote system network server configuration specified for the Remote system NWSCFG (NWSCFG) parameter already exists.

Element 1: SCSI interface

Specifies the SCSI interface.

Element 1: Adapter address

hexadecimal-value
Specify the 12-character hexadecimal adapter address for the initiator port.

Element 2: Internet address

character-value
Specify the internet address for the initiator port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 3: Subnet mask

character-value
Specify the subnet mask for the initiator port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Gateway address

*NONE
No gateway address is configured for this initiator port.
character-value
Specify the gateway address for the initiator port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 5: iSCSI qualified name

*GEN
The system will automatically generate the iSCSI qualified name.
character-value
Specify the iSCSI qualified name for the initiator port.

The following characters are allowed in iSCSI qualified names:

  • Alphabetical characters A through Z converted to lower case (refer to RFC 3722)
  • Alphabetical characters a through z
  • Digits 0 through 9
  • Period (.)
  • Dash (-)
  • colon (:)

Element 2: LAN interface

Specifies the LAN interface.

Element 1: Adapter address

hexadecimal-value
Specify the 12-character hexadecimal adapter address for the initiator port.

Element 2: Internet address

character-value
Specify the internet address for the initiator port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 3: Subnet mask

character-value
Specify the subnet mask for the initiator port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Gateway address

*NONE
No gateway address is configured for this initiator port.
character-value
Specify the gateway address for the initiator port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Top

Text 'description' (TEXT)

Specifies text that briefly describes the network server configuration.

*BLANK
Text is not specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Configuration file (CFGFILE)

Specifies the source file containing configuration data to be used in activating or further defining the integrated server.

Single values

*NONE
No configuration file is specified.

Qualifier 1: Configuration file

name
Specify the name of the source file containing the configuration data members for the server. At the time the server is activated, all members in the file are processed. The file must exist on the system by the time the server is activated.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.
Top

Virtual PTP Ethernet port (VRTPTPPORT)

Specifies the TCP/IP configuration for the virtual point-to-point Ethernet port.

Note: The subnet mask that is used for both sides of the virtual point-to-point Ethernet port is 255.255.255.0 by default. Therefore, the internet addresses that are chosen for both sides of the virtual point-to-point Ethernet port must have the same values for the first three parts of the internet addresses.

Element 1: Internet address

Specifies the internet address for the IBM i side of the virtual point-to-point Ethernet connection.

*GEN
Specify *GEN to let the system configure a virtual point-to-point Ethernet port with a generated internet address.
character-value
Specify the IBM i internet address for the virtual point-to-point Ethernet port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Note: The internet address selected must be unique across all network server descriptions and the IBM i TCP/IP configuration.

Element 2: Linux internet address

Specifies the internet address for the integrated server side of the virtual point-to-point Ethernet connection.

*GEN
Specify *GEN to let the system configure a virtual point-to-point Ethernet port with a generated internet address.
character-value
Specify the integrated server internet address for the virtual point-to-point Ethernet port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Note: The internet address selected must be unique across all network server descriptions and the IBM i TCP/IP configuration.

Top

Examples

Example 1: Install Linux Using iSCSI Hardware

INSLNXSVR   NWSD(RHEL5MAR)  LNXSVRDST(*RHEL5)
            SVRSTGSIZE(200 12000)  SVRSTGASP(2 2)  LNGVER(2920)
            SHUTDTIMO(2)  ACTTMR(300)  ENBUNICAST(*YES)
            SPINTNETA('9.5.2.32')  SPAUT(JSMITH ())
            TEXT('RedHat 5 server')

This command will install a Linux server with a Red Hat 5 distribution on iSCSI hardware. It will contain a 12 GB system drive which resides on user ASP 2. The name RHEL5MAR will be associated with the network server description on the i5/OS side. The language version used will be 2920. The shut down timeout will be set to 2 minutes. The system will wait 300 seconds for the connection to be made to the remote server service processor. Unicast packet distribution will be used over iSCSI. The remote server service processor internet address will be set to 9.5.2.32. SP authentication will be made with username JSMITH.

Top

Error messages

*ESCAPE Messages

NTA1007
Network server description &1 must be varied off.
NTA1199
Vary on or off of the Linux server not successful.
NTA119A
Linux server installation not successful.
NTA1024
Storage space assigned to network server &1 missing, damaged or not valid.
NTA1030
Internal error occurred.
Top