| 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:
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 |
| 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 |
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.
The network server name can be up to eight characters. The following characters are allowed in NWSD names:
| Top |
Specifies the integrated server operating system version to install on the integrated server.
| Top |
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
Element 1: Port
Specifies the locally managed integrated server port number.
Element 2: Linux internet address
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
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
The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.
| Top |
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
Element 1: Port
Element 2: Linux internet address
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
The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.
| Top |
Specifies the local domain name 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:
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 |
Specifies the internet address of the name server system that is used by the integrated server.
Single values
Other values (up to 3 repetitions)
The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.
| Top |
Notes:
Element 1: Install source size
Specifies the size of the storage space that holds the files used to install the integrated server operating system.
| Top |
| Top |
| Top |
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| Top |
Specifies whether IBM i should synchronize the integrated server date and time with IBM i date and time.
| Top |
Specifies the tape and optical device resource names that are restricted and cannot be used by the integrated server.
Single values
| Top |
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.
| Top |
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.
| Top |
Specifies the name of a message queue to receive network server host adapter communications status messages.
Single values
Qualifier 1: Communications message queue
Qualifier 2: Library
| Top |
| Top |
Specifies the shared data storage pool this integrated server should use.
| Top |
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 |
Specifies the TCP port to use for virtual Ethernet control.
| Top |
Specifies the remote system network server configuration to use with this server.
| Top |
Specifies the service processor network server configuration to use with this server.
| Top |
Specifies the connection security network server configuration to use with this server.
| Top |
Specifies how the remote system service processor is secured.
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.
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 |
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.
| Top |
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
Element 1: Serial number
Element 2: Manufacturer 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 |
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:
The remote system is identified by the value specified for the SP internet address (SPINTNETA) parameter.
| Top |
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:
The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.
| Top |
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
Element 1: User name
Element 2: User password
| Top |
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
Element 1: Serial number
Element 2: Manufacturer 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 |
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.
| Top |
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
Element 1: CHAP name
Valid characters are upper case A through Z, lower case a through z, numbers 0 through 9, and the following special characters:
Element 2: CHAP secret
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:
| Top |
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
Element 1: CHAP name
Valid characters are upper case A through Z, lower case a through z, numbers 0 through 9, and the following special characters:
Element 2: CHAP secret
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:
| Top |
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
Element 1: Bus
Element 2: Device
Element 3: Function
| Top |
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.
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.
| Top |
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
Element 2: Internet address
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
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
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
The following characters are allowed in iSCSI qualified names:
Element 2: LAN interface
Specifies the LAN interface.
Element 1: Adapter address
Element 2: Internet address
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
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
The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.
| Top |
Specifies text that briefly describes the network server configuration.
| Top |
Specifies the source file containing configuration data to be used in activating or further defining the integrated server.
Single values
Qualifier 1: Configuration file
Qualifier 2: Library
| Top |
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.
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.
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 |
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 |
*ESCAPE Messages
| Top |