The Install Linux Server (INSLNXSVR) command installs the Linux server Base Operating System on an Integrated xSeries 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 all 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 xSeries server is varied on to start the Linux server installation.

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

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

Restrictions:

• You must have input/output system configuration (*IOSYSCFG), all object (*ALLOBJ) and job control (*JOBCTL) special authorities to run this command.
• The file server must be varied off initially.
• The file server will also be varied off and varied back on during the second step of the install as Linux server installs and requires the server to reboot.

Usage Notes:

Any errors that occur during the first step of configuring the file 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:

• To check out the status of the Linux server, use the Work with Configuration Status command; WRKCFGSTS CFGTYPE(*NWS).
• To manage the server just installed, use the Work with Network Server Descriptions command; WRKNWSD NWSD(network-server-name).
• To manage the line descriptions created by this command, use the Work with Line Descriptions command; WRKLIND LIND(nwsdname*). The line descriptions are named using the network server name (NWSD parameter) specified on the INSLNXSVR command.
• To manage the TCP/IP interfaces created by this command, use the Work with TCP/IP Network Status (NETSTAT) command, option 1. Another option is to use the Configure TCP/IP (CFGTCP) command, option 1.
• To manage the network server configurations just created by this command, use the Work with NWS Configuration command; WRKNWSCFG NWSCFG(nwsdname*). The network server configurations are named using the network server name (NWSD parameter) specified on the INSLNXSVR command.

Parameters

Keyword	Description	Choices	Notes
NWSD	Network server description	Name	Required, Key, Positional 1
RSRCNAME	Resource name	Name, *ISCSI	Required, Positional 2
LNXSVRDST	Linux server distribution	Character value	Required, Positional 3
LNXSRCDIR	Linux source directory	Path name, *DFT	Optional
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
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, 200
	Element 2: System size	1024-1024000, 5000
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	Optional
SYNCTIME	Synchronize date and time	*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	Communications name
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	Communications name
SHUTDPORT	Shutdown TCP port	1024-65535, 8700	Optional
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
DFTSECRULE	Default IP security rule	Character value, *NONE, *GEN	Optional
IPSECRULE	IP security rule	1-16, *DFTSECRULE, *NONE	Optional
INZSP	Initialize service processor	*MANUAL, *SYNC, *AUTO, *NONE	Optional
ENBUNICAST	Enable unicast	*NO, *YES	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
SPCERTID	SP certificate identifier	Single values: *NONE Other values: Element list	Optional
	Element 1: Component	*COMMONNAME, *EMAIL, *ORGUNIT
	Element 2: Compare value	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	Character value, *DYNAMIC, *MANUAL	Optional
CHAPAUT	CHAP authentication	Single values: *NONE Other values: Element list	Optional
	Element 1: CHAP name	Character value
	Element 2: CHAP secret	Character value
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 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
	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
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 network server description to be created. 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 a *NWSD object of TYPE(*LINUX). The name is also used as the computer name of the Linux server that is installed as well as the TCP host name for the Linux server.

This is a required parameter.

name

Specify the name of the network server. 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

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description uses.

This is a required parameter.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. Specify the resource name of the communications adapter. The resource name represents the File Server IOA.

*ISCSI

This network server resource is an iSCSI attached server.

name

Specify the resource name. The maximum length of the resource name is 10 characters.

Linux server distribution (LNXSVRDST)

Specifies the version of Linux server to install on this network server.

This is a required parameter.

character-value

Specify the Linux server distribution version to install. You can use F4 while prompting the command to see the complete list of allowed values for this parameter.

Linux source directory (LNXSRCDIR)

Specifies the directory associated with the Linux server CD-ROM image that is used as the source for the install. The directory name may reference an optical volume ('/QOPT/volume'), a folder ('/QDLS/folder'), or an integrated file system (IFS) directory ('/dir1/dir2'). An example of a CD-ROM volume path name would be '/QOPT/NTSRV40A'.

To find out the name of a volume on an optical device, use the command: DSPOPT VOL(*MOUNTED) DEV(device-name). If you do not know the name of the optical device, use the command: WRKCFGSTS CFGTYPE(*DEV) CFGD(*OPT)

To find out the name of a path in an IFS directory, use the Work with Object Links (WRKLNK) command. WRKLNK will show the directory object path names on the system.

*DFT

The default directory path name to use is determined by searching the QOPT file system (/QOPT directory in IFS). The path name for the first volume in QOPT that contains a DOSUTILS directory with a LOADLIN.EXE file in it is used as the default.

Note: Using *DFT on a system with an optical media library is not recommended. Every volume located in the '/QOPT' path will be searched for a valid Linux install source and will cause each volume to be retrieved and mounted. A specific optical volume path should be specified.

path-name

Specify the Linux server source directory path name to use for the install.

Note: The specified directory must contain a DOSUTILS directory with a LOADLIN.EXE file in it.

You can use F4 while prompting the command to see a list of path names for optical volumes that are allowed values for this parameter. Folder or IFS path names that are not optical volumes are also allowed, but are not listed when using F4.

TCP/IP port configuration (TCPPORTCFG)

Specifies the Linux TCP/IP configuration values that are specific to a port on the network server. This information consists of four parts including the identification of the network server port, the internet address, the subnet mask and the default gateway assigned to the port.

Single values

*NONE

Specifies that there is no Linux TCP/IP port configuration.

Other values (up to 4 repetitions)

Element 1: Port

Specifies the network server port number to be configured. Specify one of the following values:

1

Network server port number 1 is configured.

2

Network server port number 2 is configured.

3

Network server port number 3 is configured.

4

Network server port number 4 is configured.

Element 2: Linux internet address

character-value

Specify the Linux internet address for the port 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 NWSD objects and the system's TCP/IP configuration.

Element 3: Linux subnet mask

character-value

Specifies the subnet mask for the Linux internet address in the form, nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Linux gateway address

character-value

Specifies the default gateway address for the Linux internet address in the form, nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Virtual Ethernet port (VRTETHPORT)

Specify the TCP/IP configuration for the virtual Ethernet used by the file server.

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

Single values

*NONE

Specifies that there is no Linux TCP/IP port configuration.

Other values (up to 4 repetitions)

Element 1: Port

Specifies the network server virtual Ethernet port number to be configured. Specify one of the following values:

*VRTETHn

The network server virtual Ethernet port 'n' is configured, where 'n' can have a value of 0 through 9.

Element 2: Linux internet address

character-value

Specify the Linux internet address for the port in the form, nnn.nnn.nnn.nnn , where nnn is a are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the system's TCP/IP configuration.

Element 3: Linux subnet mask

character-value

Specifies the subnet mask for the Linux internet address in the form, nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Associated port

Specifies the resource name that describes the port that is used to establish a connection between a Linux network server and the network.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. The resource name is on the port. For example, the resource name may be CMN01 on a Ethernet port.

*NONE

An associated port resource name is not associated with the line.

name

Specify the resource name.

TCP/IP local domain name (TCPDMNNAME)

Specifies the local domain name associated with the network server.

A domain name can be a text string having 2 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
• Alphabetical characters a through z
• Digits 0 through 9
• Minus sign (-)
• 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 is 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.

*SYS

Specifies that the local domain name for the network server should be the same value as is configured for the system.

character-value

Specify a TCP domain name to be associated with the network server.

TCP/IP name server system (TCPNAMSVR)

Specifies the internet address of the name server system that is used by the network server. Typically, this is the same value as it is for the system.

Single values

*SYS

The name server system used by the network server should be the same as for the system.

*NONE

There is no name server to be used by the network server.

Other values (up to 3 repetitions)

character-value

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

Server storage space sizes (SVRSTGSIZE)

Specifies the size of the server storage spaces, in megabytes.

Element 1: Install source size

Specifies the size of the storage space that holds the files used to install the Linux server.

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.

200

A storage space of 200 megabytes is used for install files.

200-2047

Specifies the install source size value in megabytes.

Element 2: System size

Specifies the size, in megabytes, of the storage space that the Linux server operating system is installed on.

5000

A storage space of 5000 megabytes is used for system storage.

1024-1024000

Specifies the system size value, in megabytes.

Storage space ASP (SVRSTGASP)

Specifies the auxiliary storage pool (ASP) identifiers for the storage space that will contain the files used to install the Linux server and the storage space that will contain the Linux server operating system.

Note: You cannot specify values for both the SVRSTGASP and STGASPDEV parameters.

Note: Null (omitted) values are specified with the characters *N, which mean that no value was specified. The value specified for the corresponding Server storage ASP device (STGASPDEV) element will be used if specified. Otherwise, the default value will be used. *N is needed only when another value following the omitted element is being specified.

Element 1: Install source ASP

Specifies the auxiliary storage pool for the storage space that holds the files used to install the Linux server.

1

The storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.

1-255

Specify the ASP identifier of the ASP to hold install files. Valid values depend on how many ASPs are defined on the system.

Element 2: System ASP

Specifies the auxiliary storage pool for the storage space that holds the Linux server operating system.

1

The storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.

1-255

Specify the ASP identifier of the ASP to hold the operating system. Valid values depend on how many ASPs are defined on the system.

Server storage ASP device (STGASPDEV)

Specifies the auxiliary storage pool (ASP) device for the storage space that will contain the files used to install the Linux server and the storage space that will contain the Linux server operating system.

Note: You cannot specify values for both the SVRSTGASP and STGASPDEV parameters.

Note: The ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.

Element 1: Install source ASP device

Specifies the independent auxiliary storage pool device for the storage space that holds the files used to install the Linux server.

name

Specify the device name of the ASP to use for the network server storage space.

Element 2: System ASP device

Specifies the independent auxiliary storage pool device name for the storage space that holds the Linux server operating system.

name

Specify the device name of the ASP to use for the network server storage space.

Language version (LNGVER)

Specifies the installed language environment used to display Integrated Server Support text and messages. Note that a smaller set of languages are available for messages displayed during installation than for messages displayed after installation.

*PRIMARY

The installed language environment for Integrated Server Support text and messages is based on the language feature of the system's primary language.

integer

Specifies the language feature number that will be used to select the Integrated Server Support text and messages.

Synchronize date and time (SYNCTIME)

Specifies whether the system should synchronize the network server date and time with the host system date and time.

The QTIMZON system value must be set to the correct value for time synchronization to work correctly.

*YES

The system synchronizes the file server date and time with the host system date and time at every vary on and at least every 30 minutes thereafter.

*NO

The system synchronizes the file server date and time with the host system date and time when the network server description is varied on, but will not keep the date and time synchronized while the network server description is in a varied on state.

Restricted device resources (RSTDDEVRSC)

Specifies the system's device resource names that are restricted and cannot be used by the Linux server.

Note: Only tape and optical device resources can be restricted.

Single values

*NONE

No device resources are restricted from the network server. Therefore, any tape or optical device resources that exist on the system can be used.

*ALL

All tape and optical resources are restricted from being used by the network server.

Other values (up to 10 repetitions)

*ALLOPT

All optical resources are restricted from being used by the network server.

Note: This value can only be specified once.

*ALLTAPE

All tape resources are restricted from being used by the network server.

Note: This value can only be specified once.

name

Specify the name of the restricted device resource that cannot be used by the network server.

Shutdown timeout (SHUTDTIMO)

Specifies the server shutdown time-out value, in minutes. This is used to limit the amount of time that the servers operating system is allowed to shutdown before the server is varied offline.

15

The network server default shutdown time-out value is used.

2-45

Specify the time (in minutes) to wait. The system waits until the network servers operating system has shutdown successfully, or until the specified time passes before varying the network server offline.

Activation timer (ACTTMR)

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

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

120

The activate time of 120 seconds is used.

30-1800

Specify the number of seconds to wait.

Communications message queue (CMNMSGQ)

Specifies the name of a message queue to receive communications status messages.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

Single values

*SYSOPR

Causes messages to be placed in the system operator message queue (QSYSOPR) in library QSYS.

Qualifier 1: Communications message queue

name

Specify the name of a message queue to receive communications status messages.

Qualifier 2: Library

*LIBL

All libraries in the job's library list 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 used.

Storage path (STGPTH)

Specifies the storage paths the storage spaces can use. This information consists of the Network server host adapter (NWSH) description.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

Element 1: Network server host adapter

communications-name

Specify the name of an existing Network server host adapter (NWSH) description.

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. You can enter up to five values for this parameter. You must enter at least one virtual Ethernet path which is the path to be used by the *VRTETHPTP line description.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

You can specify 5 values for this parameter.

Element 1: Port

*VRTETHPTP

The network server virtual Ethernet point to point port is configured.

*VRTETHn

The virtual Ethernet port 'n' is configured, where 'n' can have a value of 0 through 9.

Element 2: Network server host adapter

communications-name

Specify the name of an existing Network server host adapter (NWSH) description. The network server host adapter name does not need to be unique for each VRTETHPTH parameter on this NWSD.

Shutdown TCP port (SHUTDPORT)

Specifies the TCP port to use for shutdown.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

8700

Use the TCP port number of 8700.

1024-65535

Specify the port number identifying the port that is to be used for shutdown.

Virtual Ethernet control port (VRTETHCTLP)

Specifies the TCP port to use for virtual Ethernet control.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

8800

Use the TCP port number of 8800.

1024-65535

Specifies the port number identifying the port that is to be used for virtual Ethernet control.

Remote system NWSCFG (RMTNWSCFG)

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

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

*DFT

Use the system generated default remote system network server configuration name of 'nwsdnameRM' where nwsdname is the name of the network server description.

name

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

Service processor NWSCFG (SPNWSCFG)

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

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

*DFT

Use the system generated default service processor network server configuration name of 'nwsdnameSP' where nwsdname is the name of the network server description.

name

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

Connection security NWSCFG (CNNNWSCFG)

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

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

*DFT

Use the system generated default connection security network server configuration name of 'nwsdnameCN' where nwsdname is the name of the network server description.

name

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

Default IP security rule (DFTSECRULE)

Specifies the default IP Security (IPSec) rule used between the hosting and remote system.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

Note: This parameter is ignored when the connection security network server configuration specified for the Connection security NWSCFG (CNNNWSCFG) parameter already exists.

A value other than *DFTSECRULE must be specified on the IP security rule (IPSECRULE) parameter in this case.

*NONE

IP Security rules are not configured.

*GEN

The system will automatically generate a random pre-shared key.

character-value

Specify the pre-shared key. A pre-shared key is a nontrivial string up to 32 characters long using only the following characters: A-Z a-z 0-9 + = % & ( ) , _ - . : ;. These characters are part of the Syntactic Character Set (character set number 640).

IP security rule (IPSECRULE)

Specify the relative entry of the IP security rules (IPSECRULE) parameter, defined in the existing connection security network server configuration that will be used as the initial IP security setting between the hosting and remote system.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

*DFTSECRULE

Use the value specified on the Default IP security rule (DFTSECRULE) parameter.

Note: This value is not valid when the Connection security NWSCFG specified already exists.

*NONE

Remote interface will not use any security rule.

1-16

Remote interface will use security rule specified

Initialize service processor (INZSP)

Specifies how the remote system's service processor is secured.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

Note: Some service processors do not support secure connections. Use *NONE for these service processors. Additional information can be found at Integrated xSeries solutions at http://www.ibm.com/servers/eserver/iseries/integratedxseries.

*MANUAL

Security parameters are manually configured on remote system's service processor. *MANUAL provides the highest security. To use this option it is required that the remote system's service processor is pre-configured with a user name, password and certificate. Certificate management will be required. This method is appropriate when connecting to the service processor via public networks to protect the password.

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

*AUTO

Parameters are automatically configured on the remote system's service processor. *AUTO provides security without requiring pre-configuration of the remote system's service processor. The remote system's service processor will automatically generate a certificate. The connection is secure once initialized. This option is appropriate if the interconnecting network is physically secure or is protected by a firewall.

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

*SYNC

This network server configuration will synchronize the self-signed certificate with the service processor.

Note: This value is only valid when the service processor has already been configured by another network server configuration with *AUTO specified for the Initialize service processor (INZSP) parameter. The current user name and password for the service processor must be specified on the SP authentication (SPAUT) parameter to perform this option.

*NONE

The password is sent in the clear. Use this only if the interconnecting network is physically secure.

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

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. The system identification for the Enclosure identifier (EID) parameter is automatically retrieved if *AUTO is specified and the system hardware supports it.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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

*NO

Disable unicast

*YES

Enable unicast.

Enclosure identifier (EID)

Specifies the identifying serial number, type and model of the enclosure containing the service processor. They are required to locate the remote system on the network when ENBUNICAST(*NO) is specified. Look for these values on the label of the system.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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 when ENBUNICAST(*YES) is specified.

Element 1: Serial number

character-value

Specify the remote system's machine serial number.

Element 2: Manufacturer type and model

character-value

Specify the remote system's machine type and model in the form ttttmmm where tttt is the machine type and mmm is the machine model number.

Note: The remote system's machine type and model may be ommitted if the systems serial number is unique on the network.

Service processor name (SPNAME)

Specifies the remote system's service processor host name.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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

Note: This parameter is required when ENBUNICAST(*YES) is specified.

*SPINTNETA

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

host-name

Specify the remote system's service processor host name.

SP internet address (SPINTNETA)

Specify the remote system's service processor internet address. Internet addresses are expressed in the decimal form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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

This parameter is required when SPNAME(*SPINTNETA) is specified.

Note: This parameter is ignored when ENBUNICAST(*NO) is specified.

character-value

Specify the internet address of the service processor.

SP authentication (SPAUT)

Specifies the service processor user name and password.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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.

Note: This value is only valid when INZSP(*NONE) is specified on this command or in the existing network server configuration.

Element 1: User name

user-name

Specify the remote system's service processor user name.

Element 2: User password

password-value

Specify remote system's 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.

SP certificate identifier (SPCERTID)

The SP certificate identifier specifies one of three possible fields that identifies the service processor's certificate. This parameter is specified to provide additional validation that the certificate is from the service processor. The contents of the selected field must exactly match the value of the field that was entered when the certificate was generated or requested from a certificate authority.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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

This parameter is required when INZSP(*MANUAL) is specified.

Single values

*NONE

Service processor certificate is not configured.

Element 1: Component

*COMMONNAME

Selects the certificates common name specified when the certificate was generated or requested from a certificate authority. On the remote supervisor adapter II this correlates to the "ASM Domain Name" field used to generate a self-signed certificate or generate a certificate signing request.

*EMAIL

Selects the certificate's e-mail address specified when the certificate was generated or requested from a certificate authority. On the remote supervisor adapter II this correlates to the "Email Address" field used to generate a self-signed certificate or generate a certificate signing request.

*ORGUNIT

Selects the certificate's organizational unit specified when the certificate was generated or requested from a certificate authority. On the remote supervisor adapter II this correlates to the "Organizational Unit" field used to generate a self-signed certificate or generate a certificate signing request.

Element 2: Compare value

character-value

Specify the certificates component compare value. Specify no more than 255 characters of text, enclosed in apostrophes.

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 remote system.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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 remote system's machine serial number.

Element 2: Manufacturer type and model

character-value

Specify the remote system's machine type and model in the form ttttmmm where tttt is the machine type and mmm is the machine model number.

Note: The remote system's machine type and model may be ommitted if the systems serial number is unique on the network.

Delivery method (DELIVERY)

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

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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 DHCP.

*MANUAL

Parameters are manually configured on the remote system using the BIOS utilities (System BIOS or Adapter BIOS - ALT-Q).

CHAP authentication (CHAPAUT)

Specifies the Challenge Handshake Authentication Protocol (CHAP) for the host system iSCSI target to authenticate the remote system initiator node.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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

name

Specify the CHAP name. CHAP names are translated to ASCII code page 850 using the job's coded character set identifier (CCSID).

Element 2: CHAP secret

character-string

Specify the secret you want to use for the Challenge Handshake Authentication Protocol as a value up to 24-characters long using only the following invariant characters: A-Z a-z 0-9 + = % & ( ) , _ - . : ;. These characters are part of the Syntactic Character Set (character set number 640).

Boot device ID (BOOTDEVID)

Specifies the PCI Function Address (Bus/Device/Function) of the iSCSI adapter in the remote system that will be used to boot from. This information can be accessed using the BIOS utilities (System BIOS or Adapter BIOS - ALT-Q).

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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 adapter is used on the remote system

Note: Remote systems with more than one iSCSI adapter installed in the server are required to specify which adapter will be used to boot from.

Element 1: Bus

0-255

Specify the bus number of the remote system's iSCSI adapter that will be used to boot.

Element 2: Device

0-31

Specify the device number of the remote system's iSCSI adapter that will be used to boot.

Element 3: Function

0-7

Specify the function number of the remote system's iSCSI adapter that will be used to boot.

Dynamic boot options (DYNBOOTOPT)

Specifies the configuration of the internel DHCP server.

This is an advanced function.

This parameter is used to configure the internal DHCP Server that is part of the iSCSI Target Host Bus Adapter firmware and it's required to provide IP address and diskless boot parameters for the remote iSCSI Initiator.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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 fixed vendor ID (IBM_ISAN). Network administrators can configure clients to define their own idetifying values to convey hardware, operating system or other identifying information. DHCP option 60 described in the IETF RFC 2132 is used for this function.

IBM_ISAN

The default vendor ID of IBM_ISAN will be used.

character-value

Specify the vendor ID of the remote system's iSCSI adapter that will be used.

Element 2: Alternate client ID

Used by clients to specify their unique identifier to the server. Each client's 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's 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's iSCSI adapter. This value will be used to identify the remote system.

character-value

Specify the Client ID of the remote system's iSCSI adapter that will be used to boot.

Remote interfaces (RMTIFC)

Specifies the remote system's interfaces. This information is used to identify and configure the remote system's interfaces. Each adapter has two functions to support a SCSI and a LAN interface.

Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.

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

Element 1: Adapter address

hexadecimal-value

Specify the 12-character hexadecimal adapter address for the remote system's SCSI interface.

Element 2: Internet address

character-value

Specify the internet address for the remote system's SCSI interface 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 remote system's SCSI interface in the form, nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Gateway address

character-value

Specify the gateway address for the remote system's SCSI interface 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.

name

Specify the iSCSI qualified name for the remote system's SCSI interface. iSCSI qualified names are translated to UTF-8 using the job's coded character set identifier (CCSID). 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

Element 1: Adapter address

hexadecimal-value

Specify the 12-character hexadecimal adapter address for the remote system's LAN interface.

Element 2: Internet address

character-value

Specify the internet address for the remote system's LAN interface port 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 remote system's LAN interface in the form, nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Gateway address

character-value

Specify the gateway address for the remote system's LAN interface in the form, nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 3: TCP/IP name server system

character-value

Specify an internet address for the domain name server to be used by the the remote system's adapter.

Text 'description' (TEXT)

Specifies the text that briefly describes the objects created by this command.

*BLANK

Text is not specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Configuration file (CFGFILE)

Specifies the source file that contains configuration data, to be used in activating or further defining the server.

Single values

*NONE

No configuration file is specified.

Qualifier 1: Configuration file

name

Specify the name of a source file containing the configuration data member(s) for the server. At the time the server is activated, all members in the file will be processed.

Qualifier 2: Library

*LIBL

All libraries in the job's library list 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 used.

Virtual PTP Ethernet port (VRTPTPPORT)

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

Notes:

1. The VRTPTPPORT parameter must be used for Integrated xSeries servers running on the host system.
2. 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 host side of the virtual point-to-point Ethernet connection. Specify one of the following values:

*GEN

Specify *GEN to let the INSLNXSVR command configure a virtual point-to-point Ethernet port with a generated internet address.

character-value

Specify the host internet address for the virtual point-to-point Ethernet port in the form, xxx.yyy.zzz.nnn , where xxx , yyy , zzz , and nnn are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the host TCP/IP configuration. The xxx.yyy.zzz value in the internet address must match the xxx.yyy.zzz value for the internet address of the Linux server side of the point-to-point Ethernet port.

Element 2: Linux internet address

Specifies the internet address for the Linux side of the virtual point-to-point Ethernet connection. Specify one of the following values:

*GEN

Specify *GEN to let the INSLNXSVR command configure a virtual point-to-point Ethernet port with a generated internet address.

character-value

Specify the Linux server internet address for the virtual point-to-point Ethernet port in the form, xxx.yyy.zzz.nnn , where xxx , yyy , zzz , and nnn are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the host TCP/IP configuration. The xxx.yyy.zzz value in the internet address must match the xxx.yyy.zzz value for the internet address of the host side of the point-to-point Ethernet port.

Examples

Example 1: Install Linux Using Non-iSCSI Hardware

INSLNXSVR   NWSD(RHEL3MAR)  RSRCNAME(LIN03)  LNXSVRDST(*RHEL4)
            SVRSTGSIZE(200 12000)  LNGVER(2920)
            TEXT('RedHat 4 server')

This command will install a Linux server with a Red Hat 4 distribution on non-iSCSI hardware. It will contain a 12 gb system drive and exist on resource name LIN03. The name RHEL3MAR will be associated with the network server description on the iSeries side. The language version used will be 2920.

Example 2: Install Linux Using iSCSI Hardware

INSLNXSVR   NWSD(RHEL3MAR)  RSRCNAME(*ISCSI)  LNXSVRDST(*SLES8)
            SVRSTGSIZE(200 12000)  SVRSTGASP(2)  LNGVER(2920)
            SHUTDTIMO(2)  ACTTMR(300)  ENBUNICAST(*YES)
            SPINTNETA('9.5.2.32')  SPAUT(JSMITH ())
            TEXT('RedHat 4 server')

This command will install a Linux server with a SuSE 8 distribution on iSCSI hardware. It will contain a 12 gb which resides on user ASP 2. The name RHEL3MAR will be associated with the network server description on the iSeries side. The langauge version used will be 2920. The shutdown timeout will be set to 2 minutes. The system will wait 300 seconds for the connection to be made to the remote server's service processor. Unicast packet distribution will be used over iSCSI. The remote server's service processor internet address will be set to 9.5.2.32. SP authentication will be made with username JSMITH.

Error messages

*ESCAPE Messages

NTA1007

Network server &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 server &1 missing, damaged or not valid.

NTA1030

Internal error occurred.