Install Integrated Server (INSINTSVR)

The Install Integrated Server (INSINTSVR) command installs the integrated server Operating System.

Integrated server installation occurs in two steps. During the first step, the INSINTSVR command creates necessary objects to manage the server. This includes a network server description, message queue, line descriptions, storage spaces and TCP/IP interfaces. Once completed, the integrated server is varied on to continue with the integrated server operating system install.

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

When the Install Integrated Server (INSINTSVR) completes normally, the integrated 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/powered off initially.
  4. The integrated server may reboot during the second step of the install as the operating system installs.

Usage Notes:

  1. Any errors that occur during the first step of configuring the integrated server will result in the failure of this command.
  2. 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 integrated 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(nwsdname).
    • 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 install 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 used by this command, use the Work with NWS Configuration (WRKNWSCFG) command.

Parameters

Keyword Description Choices Notes
NWSD Network server description Communications name Required, Key, Positional 1
OSTYPE Operating system type *WIN2008, *WIN2012, *ESXIE, *ESXII Required, Positional 2
RMTNWSCFG Remote system NWSCFG Name Optional
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
SVRSTGSIZE Server storage space sizes Element list Optional
Element 1: System size Integer, *CALC
SVRSTGASP Storage space ASP Element list Optional
Element 1: System ASP 1-255
STGASPDEV Server storage ASP device Element list Optional
Element 1: System ASP device Name
TEXT Text 'description' Character value, *BLANK Optional
LNGVER Language version Integer, *PRIMARY Optional
PRPDMNUSR Propagate domain user *YES, *NO Optional
ALWDEVRSC Allowed device resources Single values: *UNRSTD
Other values (up to 16 repetitions): Name, *ALLTAPE, *ALLOPT		 Optional
RSTDDEVRSC Restricted device resources Single values: *OSTYPE, *NONE, *ALL
Other values (up to 16 repetitions): Name, *ALLTAPE, *ALLOPT		 Optional
VRTPTPPORT Virtual PTP Ethernet port Single values: *OSTYPE, *NONE
Other values: Element list		 Optional
Element 1: Internet address Character value, *GEN
Element 2: Integrated IP address Character value, *GEN
UNIT Preferred storage unit *ANY, *SSD Optional

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

Operating system type (OSTYPE)

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

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

Supported operating system version values include:

*WIN2008
Windows Server 2008
*WIN2012
Windows Server 2012
*ESXII
VMware ESXi Installable
*ESXIE
VMware ESXi Embedded

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.

Prompting (F4) on this field provides a list of all network server configurations available for this parameter on this system.

Storage path (STGPTH)

Specifies the storage path the storage spaces can use.

Element 1: Network server host adapter

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

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

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.

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

Server storage space sizes (SVRSTGSIZE)

Specifies the size (in megabytes) of the storage spaces.

Note: This parameter is ignored when an VMware ESXi Embedded server (*ESXIE) is specified for the Operating system type (OSTYPE) parameter.

Element 1: System size

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

*CALC
Specify that the size should be calculated by the system based on the values specified on other parameters.
15000-1024000
Specify the system size value in megabytes.

Storage space ASP (SVRSTGASP)

Specifies the auxiliary storage pool (ASP) identifiers for the network server storage spaces.

Note: This parameter is ignored when an VMware ESXi Embedded server (*ESXIE) is specified for the Operating system type (OSTYPE) parameter.

Element 1: System ASP

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

Note: You cannot specify both a SVRSTGASP and STGASPDEV parameter value for the same element.

1
The network server storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.
2-255
Specify the number of the ASP to be used. Valid values depend on what ASPs are defined on the system.

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

Server storage ASP device (STGASPDEV)

Specifies the auxiliary storage pool (ASP) device names for the network server storage spaces.

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

Note: This parameter is ignored when an VMware ESXi Embedded server (*ESXIE) is specified for the Operating system type (OSTYPE) parameter.

Element 1: System ASP device

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

Note: You cannot specify both a SVRSTGASP and STGASPDEV parameter value for the same element.

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

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

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.

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

Propagate domain user (PRPDMNUSR)

Specifies if this server should be used to propagate and synchronize users to the Windows domain or active directory.

Note: When multiple network servers belong to the same Windows domain, only one needs to propagate users to the domain. Selecting a network server with a domain role of *DMNCTL will provide the fastest performance and may eliminate the need for the special QAS400NT userid. At least one network server should specify *YES for each Windows domain that you wish to propagate users to.

Note: This parameter is only valid when OSTYPE(*WIN2008) or OSTYPE(*WIN2012) is specified.

*YES
Propagation of domain user enrollment is allowed for this network server description.
*NO
Propagation of domain user enrollment is not allowed for this network server description.

Allowed device resources (ALWDEVRSC)

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

The resource is used when the integrated server is active and a request is issued from a client that is running an application. The device resource cannot be used by the client application and IBM i based application at the same time. If the device resource is intended to be used by an application, it will need to be available when the application is ready to use it.

Notes:

  1. This parameter is mutually exclusive with the RSTDDEVRSC parameter. If a value other than *UNRSTD is specified, *NONE must be specified on the RSTDDEVRSC parameter.
  2. Only tape and optical device resources can be allowed.
  3. If other device resources are specified that are not valid or are not detected, they will not allow the network server description to vary on.
  4. This parameter can be changed only while the network server description is varied off.
  5. This parameter is not valid when Server operating system specified *AUX for the Network server type (TYPE) parameter.

Single values

*SAME
The value does not change.
*UNRSTD
All tape and optical device resources not specified on the RSTDDEVRSC parameter are allowed from the integrated server.

Other values (up to 16 repetitions)

Note: Each value can only be specified once.

*ALLOPT
All optical device resources are allowed from the integrated server.
*ALLTAPE
All tape device resources are allowed from the integrated server.
name
Specify the resource name of an allowed device resource that can be used by the integrated server.

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

*OSTYPE
Restricted device resources are configured depending on the Operating system type (OSTYPE) parameter.

If OSTYPE(*WIN2008) or OSTYPE(*WIN2012) is specified, *NONE is configured so that no tape and optical device resources are restricted from the integrated server.

For all other types, *ALL is configured so that all tape and optical device resources are restricted from being used by the integrated server.

*NONE
No tape and optical device resources are restricted from the integrated server.
*ALL
All tape and optical device resources are restricted from the integrated server.

Other values (up to 16 repetitions)

Note: Each value can only be specified once.

*ALLOPT
All optical device resources are restricted from the integrated server.
*ALLTAPE
All tape 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.

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

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.

Single values

*OSTYPE
Virtual point-to-point Ethernet port is configured depending on the Operating system type (OSTYPE) parameter.

If OSTYPE(*WIN2008) or OSTYPE(*WIN2012) is specified, *GEN is configured to let the system configure a virtual point-to-point Ethernet port with a generated internet address.

For all other types, *NONE is configured so that no virtual point-to-point Ethernet port is configured.

*NONE
Do not configure any virtual point-to-point Ethernet port.

Note: This value is not valid when OSTYPE(*WIN2008) or OSTYPE(*WIN2012) is specified.

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: Integrated IP 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.

Preferred storage unit (UNIT)

Specifies the preferred storage media for this network server storage space.

*ANY
No storage media is preferred. Storage will be allocated from any available storage media.
*SSD
Solid-state drive storage media is preferred. Storage should be allocated from solid-state drive storage media if available.

Note: This parameter is ignored when an VMware ESXi Embedded server (*ESXIE) is specified for the Operating system type (OSTYPE) parameter.

Examples

Example 1: Installing Windows Server 2008 on an iSCSI attached server 

INSINTSVR  NWSD(WS08COR)
             OSTYPE(*WIN2008)
             RMTNWSCFG(BLADE01RM)
             STGPTH(HBACMN03)
             POOL(*SHRPOOL2)
             TEXT('Windows Server 2008 Enterprise Core')

This command installs a Windows Server 2008 named WS08COR. Network server host adapter (NWSH) device HBACMN03 is configured for the storage and virtual Ethernet path.

Shared data pool *SHRPOOL2 will be used by the integrated server to handle virtual disk requests.

The remote system configuration BLADE01RM is used.

Example 2: Installing VMware ESX Server on an iSCSI attached server 

INSINTSVR  NWSD(ESXSVR)
             OSTYPE(*ESXII)
             RMTNWSCFG(BLADE01RM)
             STGPTH(HBACMN03)
             POOL(*SHRPOOL2)
             TEXT('VMware ESX Server')

This command installs a VMware ESX server named ESXSVR. *ESXII is an iSCSI attached server using VMware ESXi Installable. Network server host adapter (NWSH) device HBACMN03 is configured for the storage path.

Shared data pool *SHRPOOL2 will be used by the integrated server to handle virtual disk requests.

The remote system configuration BLADE01RM is used.

Error messages

ESCAPE Messages

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