| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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:
Usage Notes:
| Top |
| 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 |
| 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 resource name that identifies the hardware that the description uses.
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| Top |
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.
| 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
Other values (up to 4 repetitions)
Element 1: Port
Specifies the locally managed integrated server port number.
Element 2: Windows 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: Windows 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: Windows 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.
Single values
Other values (up to 4 repetitions)
Element 1: Port
Specifies the virtual Ethernet port number.
Note: Each value can only be specified once.
Element 2: Windows 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: Windows 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: 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.
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| 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 |
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
Qualifier 1: Server message queue
Qualifier 2: Library
| Top |
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
Other values (up to 3 repetitions)
Note: Each value can only be specified once.
| Top |
Specifies the size (in megabytes) of the storage spaces.
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.
Element 2: System size
Specifies the size in megabytes of the storage space that the integrated server operating system is installed on.
| Top |
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.
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.
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| Top |
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.
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.
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| Top |
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.
| Top |
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:
| Top |
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:
| Top |
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.
| Top |
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.
| Top |
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.
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 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.
| Top |
Specifies whether to disable the integrated servers user profiles if the corresponding IBM i user profiles are disabled.
| Top |
Specifies the license key for Windows server. Windows server will prompt for a value during the install if no parameter value is specified.
| Top |
Determines the license mode to install the Windows server as.
Element 1: License mode
Element 2: Client licenses
Element 3: Terminal services
| Top |
Specifies the tape and optical device resource names that are restricted and cannot be used by the integrated server.
Single values
Other values (up to 10 repetitions)
Note: Each value can only be specified once.
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| 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.
Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.
| Top |
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
Qualifier 1: Communications message queue
Qualifier 2: Library
| Top |
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
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| Top |
Specifies the shared data storage pool this integrated server should use.
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| 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.
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.
Element 2: Network server host adapter
Prompting (F4) on this field provides a list of values supported for this parameter on this system.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
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.
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 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
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 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.
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 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:
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 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
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.
Note: This parameter is only valid when *ISCSI is specified for the Resource name (RSRCNAME) parameter.
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 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.
| 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 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
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 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
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 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.
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 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
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: 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.
| Top |
Specifies text that briefly describes the network server configuration.
| Top |
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.
| 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 name of the cluster.
| Top |
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
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.
Element 2: Quorum resource size
Specifies the size in megabytes of the storage space used as the Windows quorum resource.
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.
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.
Element 5: Connection port
Specifies the connection port used for the Cluster service communication.
Element 6: Cluster internet address
Specifies the internet address for the cluster.
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
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 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: Windows 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: 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.
| Top |
ESCAPE Messages
| Top |