Install Windows Server (INSWNTSVR)

The Install Windows Server (INSWNTSVR) command installs the Windows server Operating System on an integrated server. INSWNTSVR also installs Integrated Server Support code on the server.

Windows server installation occurs in two steps. During the first step, the INSWNTSVR 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 Windows server installation, the integrated server is varied on to start the Windows server installation.

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

When INSWNTSVR completes normally, the Windows 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
WNTVER Windows server version *WIN2003, *WIN2008 Optional
RSRCNAME Resource name Name, *ISCSI Optional
WNTSRCDIR Windows 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: Windows internet address Character value
Element 3: Windows subnet mask Character value
Element 4: Windows 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: Windows internet address Character value
Element 3: Windows 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
MSGQ Server message queue Single values: *JOBLOG, *NONE
Other values: Qualified object name		 Optional
Qualifier 1: Server message queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
EVTLOG Event log Single values: *ALL, *NONE
Other values (up to 3 repetitions): *SYS, *SEC, *APP		 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
Element 2: System ASP 1-255
STGASPDEV Server storage ASP device Element list Optional
Element 1: Install source ASP device Name
Element 2: System ASP device Name
CVTNTFS Convert to NTFS *YES, *NO Optional
TOWRKGRP To workgroup Character value Optional
TODMN To domain Character value Optional
FULNAM Full Name Character value Optional
ORG Organization Character value Optional
LNGVER Language version Integer, *PRIMARY Optional
SYNCTIME Synchronize date and time *NONE, *YES, *NO Optional
PRPDMNUSR Propagate domain user *YES, *NO Optional
DSBUSRPRF Disable user profile *AUTO, *NO Optional
WNTLICKEY Windows license key Character value Optional
LICMODE License mode Element list Optional
Element 1: License mode *PERSEAT, *PERUSER, *PERSERVER
Element 2: Client licenses 5-9999, *NONE
Element 3: Terminal services *NONE, *PERDEVICE, *PERUSER
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, *STGPTH
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
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
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: 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
TEXT Text 'description' Character value, *BLANK Optional
KBDTYPE Keyboard layout Hexadecimal value, *DEFAULT Optional
CFGFILE Configuration file Single values: *NONE
Other values: Qualified object name		 Optional
Qualifier 1: Configuration file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CLU Cluster name Name, *NONE Optional
CLUCFG Cluster configuration Single values: *CLU
Other values: Element list		 Optional
Element 1: Cluster domain name Character value
Element 2: Quorum resource size 550-1024000, *CALC
Element 3: Quorum resource ASP 1-255, 1
Element 4: Quorum ASP device Name
Element 5: Connection port *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9
Element 6: Cluster internet address Character value
Element 7: Cluster subnet mask Character value
VRTPTPPORT Virtual PTP Ethernet port Element list Optional
Element 1: Internet address Character value, *GEN
Element 2: Windows internet address Character value, *GEN

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

Windows server version (WNTVER)

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

Resource name (RSRCNAME)

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

*ISCSI
This network server resource is an iSCSI attached server using a network server host adapter device description. Use the Work with Device Descriptions (WRKDEVD) with *NWSH specified for the DEVD parameter to help determine which Network Server Host Adapters are configured.
name
Specify the resource name of the File Server IOA communications adapter to use. Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.

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

Windows source directory (WNTSRCDIR)

Specifies the directory of the image that is used as the source for the install. The directory name may reference an optical volume ('/QOPT/volume'), or an IFS directory ('/dir1/dir2').

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.

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.

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

Note: The specified directory must contain an I386 directory with a WINNT.EXE file in it.

*DFT
The default directory path name to use is determined by searching the QOPT file system (/QOPT directory in IFS).
path-name
Specify the server Operating System source path name to use for the install.

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.

Other values (up to 4 repetitions)

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

Virtual Ethernet port (VRTETHPORT)

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

Single values

*NONE
Do not configure any virtual Ethernet ports.

Other values (up to 4 repetitions)

Element 1: Port

Specifies the virtual Ethernet port number.

Note: Each value can only be specified once.

*VRTETHn
Virtual Ethernet port 'n' is configured, where 'n' is a number from 0 to 9.

Element 2: Windows 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: Windows 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: Associated port

Specifies the resource name that describes the port that is used to establish a connection between the integrated 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 associated port resource name.

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

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.

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.

Server message queue (MSGQ)

Specifies the message queue to receive integrated server messages.

Integrated Server Support messages and event logs received from the server are logged.

This message queue should be monitored so that it does not become full. If it becomes full, messages will be rerouted to the joblog of the monitor job.

Care should be taken if QSYSOPR is specified as the message queue to receive all messages related to Windows server running on an integrated server because the volume of Windows server event log messages is unpredictable.

If both a message queue name and library name is specified, and the message queue does not exist, the message queue will automatically be created with authority *EXCLUDE. If the library specified for the message queue does not exist, the command will fail.

Single values

*JOBLOG
Messages are placed on the joblog of the monitor job.
*NONE
Messages are not placed on any message queue.

Qualifier 1: Server message queue

name
Specify the name of the message queue to receive messages issued by the integrated server.

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.

Event log (EVTLOG)

Specifies whether or not messages from the event logs are received from the server.

Note: Event log messages are placed in the message queue that is specified for the Server message queue (MSGQ) parameter. The MSGQ value cannot be *NONE if a value other than *NONE is specified for this parameter. See the MSGQ parameter description for more information.

Single values

*ALL
All the event log messages are received.
*NONE
No event log messages are received.

Other values (up to 3 repetitions)

Note: Each value can only be specified once.

*SYS
The system event log messages are received.
*SEC
The security event log messages are received.
*APP
The application event log messages are received.

Server storage space sizes (SVRSTGSIZE)

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

Notes:

  1. The install source drive contains the contents of the Integrated Server Support code. The contents of the I386 directory of the Windows server installation media is also copied to the install source drive for Windows Server 2003. The size specified for the install source drive must be large enough to hold this data.
  2. The minimum size allowed is determined by the Windows server version specified on the WNTVER parameter.

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.

Element 2: 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.
1024-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: You cannot specify both a SVRSTGASP and STGASPDEV parameter value for the same element.

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 that are used to install the integrated server operating system.

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.

Element 2: System ASP

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

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: You cannot specify both a SVRSTGASP and STGASPDEV parameter value for the same element.

Element 1: Install source ASP device

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

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.

Element 2: System ASP device

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

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.

Convert to NTFS (CVTNTFS)

Specifies if the primary partition of the system drive should be converted to the NT File System (NTFS).

Note: Conversion to NTFS may be automatically performed under some situations such as the File system limitations for system drives greater than 32000 megabytes. When one of these conditions exist, the Convert to NTFS (CVTNTFS) parameter is automatically set to *YES by this command.

*YES
Windows server will convert the system drive to NTFS during the install.
*NO
Windows server will not convert the system drive to NTFS during the install.

To workgroup (TOWRKGRP)

Specifies the workgroup in which the computer will participate. The Windows server will prompt for a value during the install if no parameter value is specified.

Characters allowed for this parameter include any upper-case character A-Z, lower-case a-z, 0-9, and any character in the ASCII code page 850 except:

character-value
Specify the workgroup in which the computer will participate. The computer can be part of either a workgroup or a domain.

To domain (TODMN)

Specifies the name of an existing server domain in which the computer will participate. Windows server will prompt for a value during the install if no parameter value is specified.

Characters allowed for this parameter include any upper-case character A-Z, lower-case a-z, 0-9, and any character in the ASCII code page 850 except:

character-value
Specify the name of the server domain in which the computer will participate. The computer can be part of either a workgroup or a domain.

Full Name (FULNAM)

Specifies the users' full name for the Windows server being installed. Windows server will prompt for a value during the install if no parameter value is specified.

character-value
Specify the name of the user installing Windows server who holds the license.

Organization (ORG)

Specifies the organization name for the Windows server being installed. Windows server will prompt for a value during the install if no parameter value is specified.

character-value
Specify the name of the organization installing Windows server who holds the license.

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.

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.

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.

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

Disable user profile (DSBUSRPRF)

Specifies whether to disable the integrated servers user profiles if the corresponding IBM i user profiles are disabled.

*AUTO
Integrated server user profiles are disabled if corresponding IBM i user profiles are disabled.
*NO
Integrated server user profiles are not disabled if corresponding IBM i user profiles are disabled.

Windows license key (WNTLICKEY)

Specifies the license key for Windows server. Windows server will prompt for a value during the install if no parameter value is specified.

character-value
Specify the license key for the Windows server, including any dashes ('-'). The length of the Windows license key (WNTLICKEY) is limited to 34 characters.

License mode (LICMODE)

Determines the license mode to install the Windows server as.

Element 1: License mode

*PERSEAT
Indicates that the end user purchased a client access license for each device or user accessing the server.
*PERUSER
Indicates that the end user purchased a client access license for each device or user accessing the Windows Server 2003 server.
*PERSERVER
Indicates that the end user purchased client access licenses for each server, which allows a certain number of concurrent connections to the server.

Element 2: Client licenses

*NONE
Indicates that no client licenses are installed. *NONE must be specified when *PERSEAT or *PERUSER is specified.
integer
Number of client licenses purchased for the server being installed. A number greater than five must be specified when *PERSERVER is specified for the license type. The valid range is from 5 to 9999.

Element 3: Terminal services

*NONE
Do not install the Terminal Server component for this server.
*PERDEVICE
Installs and configures the Windows Server 2003 Terminal Services to require that each connected device has a valid Terminal Server Client Access License (CAL). If the client has a Terminal Server CAL, it can access more than one Terminal Server.
*PERUSER
Installs and configures Windows Server 2003 Terminal Server to provide one Terminal Server CAL for each active user.

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

Shutdown timeout (SHUTDTIMO)

Specifies the shutdown timeout value in minutes. This is used to limit the amount of time to allow the asynchronous vary off processing to complete before the network server description is varied off. This processing includes the shutdown of the integrated server operating system.

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.

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.

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 network server host adapter communications status messages.

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

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.

Storage path (STGPTH)

Specifies the storage path the storage spaces can use.

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

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.

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

Other values (up to 5 repetitions)

Element 1: Port

Specifies the virtual Ethernet port number.

Note: Each value can only be specified once.

*VRTETHPTP
The network server virtual Ethernet point to point port is configured.
*VRTETHn
Virtual Ethernet port 'n' is configured, where 'n' is a number from 0 to 9.

Element 2: Network server host adapter

*STGPTH
Use the Network server host adapter (NWSH) description specified for the Storage path (STGPTH) parameter.
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.

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

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

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

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.

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

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.

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

Initialize service processor (INZSP)

Specifies how the remote system service processor is secured.

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

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

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

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.

Service processor name (SPNAME)

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

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

SP internet address (SPINTNETA)

Specifies the remote system service processor internet address.

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.

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.

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

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.

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.

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

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.

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

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

*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

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

*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

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.

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

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.

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

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

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.

Keyboard layout (KBDTYPE)

Specifies the keyboard layout identifier to install on the Windows server. The valid keyboard layout identifiers are listed in the TXTSETUP.SIF file in the I386 directory of the Windows server installation media.

*DEFAULT
The default keyboard layout for the version of Windows server being installed is used.
hexadecimal-value
Specify the keyboard layout identifier to be used by the Windows server.

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.

Cluster name (CLU)

Specifies the name of the cluster.

*NONE
Do not form or join a Windows Cluster.
name
Specify the name of the cluster. Administrators will use this name for connections to the cluster. The cluster name must be different from the domain name, from all computer names on the domain, and from other cluster names on the domain.

Cluster configuration (CLUCFG)

Specifies the parameters required to configure a new Windows Cluster.

Note: This parameter is only required when forming a new Windows cluster using the Cluster name (CLU) parameter.

Single values

*CLU
Use the values already defined by a previous installation of the Windows Cluster service to join the existing cluster name.

Element 1: Cluster domain name

Specifies the domain to which the cluster belongs. If the cluster already exists, the cluster will be joined, otherwise, the cluster will be formed. If forming a cluster, the Cluster configuration (CLUCFG) parameter must be specified.

character-value
Specify the domain name to which the cluster belongs when forming a new cluster.

Element 2: Quorum resource size

Specifies the size in megabytes of the storage space used as the Windows quorum resource.

*CALC
Specifies that the size should be calculated to be the default value based on the Windows server version (WNTVER) parameter.
550-1024000
Specify the Windows quorum resource size in megabytes. The size must be at least 550 megabytes but no larger than 1024000 megabytes.

Element 3: Quorum resource ASP

Specifies the auxiliary storage pool for the storage space used as the Windows quorum resource.

Note: You cannot specify both a Quorum resource ASP and a Quorum ASP device value.

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.

Element 4: Quorum ASP device

Specifies the independent auxiliary storage pool device name for the storage space used as the Windows quorum resource.

Note: You cannot specify both a Quorum resource ASP and a Quorum ASP device value.

name
Specify the name of the independent auxiliary storage pool device. Valid values depend on which IASPs are defined on the system.

Element 5: Connection port

Specifies the connection port used for the Cluster service communication.

*VRTETHn
Virtual Ethernet port 'n' is configured, where 'n' is a number from 0 to 9.

Element 6: Cluster internet address

Specifies the internet address for the cluster.

character-value
Specify the Cluster internet address.

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 7: Cluster subnet mask

character-value
Specify the subnet mask for the Cluster internet address.

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

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

Examples

Example 1: Installing a Windows Cluster Node 

INSWNTSVR  NWSD(W2KNODE1) WNTVER(*WIN2003)
            RSRCNAME(LIN03)
            WNTSRCDIR(*DFT)
            TCPPORTCFG((1 '206.5.8.60' '255.255.255.128'
                        '206.5.8.1'))
            VRTETHPORT((*VRTETH5 '192.168.9.3'
                        '255.255.255.0'))
            TCPDMNNAME(xyzdomain.xyzcorp.com)
            TCPNAMSVR('206.5.69.165' '206.5.8.8'
                      '206.10.244.100')
            SVRSTGSIZE(*CALC 4000) SVRSTGASP(1 1)
            CVTNTFS(*YES) TODMN(XYZDOMAIN)
            FULNAM('John Smith') ORG('XYZ Corporation')
            WNTLICKEY('VVVVV-WWWWW-XXXXX-YYYYY-ZZZZZ')
            LICMODE(*PERSEAT *NONE *NONE)
            TEXT('Windows 2003 Cluster Node 1')
            CLU(CLU1XYZ)
            CLUCFG(XYZDOMAIN 600 1 *N *VRTETH5 '206.5.8.65'
                  '255.255.255.128')

This command installs a Windows server named W2KNODE1. W2KNODE1 is the network server description associated with the Windows Server 2003 operating system that will be installed on the Integrated xSeries Server resource LIN03.

A fully controlled install will be performed with a system drive size of 4000 MB that will automatically be converted to NTFS during the install. The Windows Server 2003 will join the XYZDOMAIN domain. A per seat license mode will be configured on the server. The TCP/IP address 206.5.8.60 will automatically be configured for the first LAN adapter detected on the Integrated xSeries Server. A virtual ethernet LAN will be created on virtual ethernet 5 configured with TCP/IP address 192.168.9.3.

The TCP/IP local host name is the same as the server description name. The TCP/IP local domain name is xyzdomain.xyzcorp.com. The TCP/IP name servers will use 206.5.69.165 206.5.8.8 and 206.10.244.100.

A new Microsoft Cluster will be enabled by creating a quorum resource drive named XYZDOMAIN that is 600 MB is size. Virtual ethernet 5 will be used for the private communication between clustered nodes.

Example 2: Installing Windows Server 2003 on an iSCSI attached server 

INSWNTSVR  NWSD(WS03LAN) WNTVER(*WIN2003)
            RSRCNAME(*ISCSI)
            WNTSRCDIR(*DFT)
            SVRSTGSIZE(*CALC 2500) SVRSTGASP(1 1)
            CVTNTFS(*YES) TOWRKGRP(XYZGROUP)
            FULNAM('John Smith') ORG('XYZ Corporation')
            WNTLICKEY('VVVVV-WWWWW-XXXXX-YYYYY-ZZZZZ')
            STGPTH(NWSHRG1)
            POOL(*SHRPOOL1)
            VRTETHPTH((*VRTETHPTP *STGPTH))
            INZSP(*SYNC)
            SPNAME('ws03lan')
            EID(1234567 418477U)
            SPAUT(spadmin spuid)
            RMTSYSID(*EID)
            DELIVERY(*DYNAMIC)
            CHAPAUT(mychapid mychapsecret)
            RMTIFC((020134304760 '206.5.8.92' '255.255.255.128'))
                   (020134604750 '206.5.8.96' '255.255.255.128'))
            TEXT('Windows Server 2003 iSCSI Server')

This command installs a Windows server named WS03LAN. WS03LAN is an iSCSI attached server using Windows Server 2003. Network server host adapter (NWSH) device NWSHRG1 is configured for the storage and virtual Ethernet path.

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

The service processor is automatically configured and is located using the ws03lan host name.

The service processor is verified using the enclosures serial number 1234567 and type/model 418477U.

The remote system is dynamically configured and secured using a specified CHAP name and secret.

Remote SCSI and LAN interfaces for the remote systems iSCSI initiator ports are configured.

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.