ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/inslnxsvr.htm

1981 lines
76 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Install Linux Server (INSLNXSVR)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="INSLNXSVR.Top_Of_Page"></a>
<h2>Install Linux Server (INSLNXSVR)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#INSLNXSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#INSLNXSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#INSLNXSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="INSLNXSVR"></a>
<p>The Install Linux Server (INSLNXSVR) command installs the Linux server Base Operating System on an Integrated xSeries server. INSLNXSVR also installs <u> Integrated Server Support </u> code on the server.
</p>
<p>Linux server installation occurs in two steps. During the first step, the INSLNXSVR command creates all necessary objects to manage the server. This includes a network server description, message queue, line descriptions, storage spaces and TCP/IP interfaces.
</p>
<p>During the second step of the Linux server installation, the Integrated xSeries server is varied on to start the Linux server installation.
</p>
<p>Further Linux server installation is performed using the file server console and the normal Linux server install process.
</p>
<p>When INSLNXSVR completes normally, the Linux server is left in a varied on state.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have input/output system configuration (*IOSYSCFG), all object (*ALLOBJ) and job control (*JOBCTL) special authorities to run this command.
</li>
<li>The file server must be varied off initially.
</li>
<li>The file server will also be varied off and varied back on during the second step of the install as Linux server installs and requires the server to reboot.
</li>
</ul>
<p><b>Usage Notes:</b>
</p>
<p>Any errors that occur during the first step of configuring the file server will result in the failure of this command.
</p>
<p>After this command is run, if you need to manage the different resources created, use the following commands:
</p>
<ul>
<li>To check out the status of the Linux server, use the Work with Configuration Status command; WRKCFGSTS CFGTYPE(*NWS).
</li>
<li>To manage the server just installed, use the Work with Network Server Descriptions command; WRKNWSD NWSD(network-server-name).
</li>
<li>To manage the line descriptions created by this command, use the Work with Line Descriptions command; WRKLIND LIND(nwsdname*). The line descriptions are named using the network server name (NWSD parameter) specified on the INSLNXSVR command.
</li>
<li>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.
</li>
<li>To manage the network server configurations just created by this command, use the Work with NWS Configuration command; WRKNWSCFG NWSCFG(nwsdname*). The network server configurations are named using the network server name (NWSD parameter) specified on the INSLNXSVR command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="INSLNXSVR.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.NWSD"><b>NWSD</b></a></td>
<td valign="top">Network server description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, *ISCSI</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.LNXSVRDST"><b>LNXSVRDST</b></a></td>
<td valign="top">Linux server distribution</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.LNXSRCDIR"><b>LNXSRCDIR</b></a></td>
<td valign="top">Linux source directory</td>
<td valign="top"><i>Path name</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#INSLNXSVR.TCPPORTCFG"><b>TCPPORTCFG</b></a></td>
<td valign="top">TCP/IP port configuration</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 4 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Port</td>
<td valign="top">
1, 2, 3, 4</td>
</tr>
<tr>
<td valign="top">Element 2: Linux internet address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 3: Linux subnet mask</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 4: Linux gateway address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#INSLNXSVR.VRTETHPORT"><b>VRTETHPORT</b></a></td>
<td valign="top">Virtual Ethernet port</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 4 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Port</td>
<td valign="top">
*VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9</td>
</tr>
<tr>
<td valign="top">Element 2: Linux internet address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 3: Linux subnet mask</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 4: Associated port</td>
<td valign="top">
<i>Name</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.TCPDMNNAME"><b>TCPDMNNAME</b></a></td>
<td valign="top">TCP/IP local domain name</td>
<td valign="top"><i>Character value</i>, <b><u>*SYS</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.TCPNAMSVR"><b>TCPNAMSVR</b></a></td>
<td valign="top">TCP/IP name server system</td>
<td valign="top">Single values: <b><u>*SYS</u></b>, *NONE<br>Other values (up to 3 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.SVRSTGSIZE"><b>SVRSTGSIZE</b></a></td>
<td valign="top">Server storage space sizes</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Install source size</td>
<td valign="top">
200-2047, <b><u>200</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: System size</td>
<td valign="top">
1024-1024000, <b><u>5000</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.SVRSTGASP"><b>SVRSTGASP</b></a></td>
<td valign="top">Storage space ASP</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Install source ASP</td>
<td valign="top">
1-255, <b><u>1</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: System ASP</td>
<td valign="top">
1-255, <b><u>1</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.STGASPDEV"><b>STGASPDEV</b></a></td>
<td valign="top">Server storage ASP device</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Install source ASP device</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: System ASP device</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.LNGVER"><b>LNGVER</b></a></td>
<td valign="top">Language version</td>
<td valign="top"><i>Integer</i>, <b><u>*PRIMARY</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.SYNCTIME"><b>SYNCTIME</b></a></td>
<td valign="top">Synchronize date and time</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.RSTDDEVRSC"><b>RSTDDEVRSC</b></a></td>
<td valign="top">Restricted device resources</td>
<td valign="top">Single values: <b><u>*NONE</u></b>, *ALL<br>Other values (up to 10 repetitions): <i>Name</i>, *ALLTAPE, *ALLOPT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.SHUTDTIMO"><b>SHUTDTIMO</b></a></td>
<td valign="top">Shutdown timeout</td>
<td valign="top">2-45, <b><u>15</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.ACTTMR"><b>ACTTMR</b></a></td>
<td valign="top">Activation timer</td>
<td valign="top">30-1800, <b><u>120</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.CMNMSGQ"><b>CMNMSGQ</b></a></td>
<td valign="top">Communications message queue</td>
<td valign="top">Single values: <b><u>*SYSOPR</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Communications message queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="2"><a href="#INSLNXSVR.STGPTH"><b>STGPTH</b></a></td>
<td valign="top">Storage path</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="2">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Network server host adapter</td>
<td valign="top">
<i>Communications name</i></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.VRTETHPTH"><b>VRTETHPTH</b></a></td>
<td valign="top">Virtual Ethernet path</td>
<td valign="top">Values (up to 5 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Port</td>
<td valign="top">
<b><u>*VRTETHPTP</u></b>, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9</td>
</tr>
<tr>
<td valign="top">Element 2: Network server host adapter</td>
<td valign="top">
<i>Communications name</i></td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.SHUTDPORT"><b>SHUTDPORT</b></a></td>
<td valign="top">Shutdown TCP port</td>
<td valign="top">1024-65535, <b><u>8700</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.VRTETHCTLP"><b>VRTETHCTLP</b></a></td>
<td valign="top">Virtual Ethernet control port</td>
<td valign="top">1024-65535, <b><u>8800</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.RMTNWSCFG"><b>RMTNWSCFG</b></a></td>
<td valign="top">Remote system NWSCFG</td>
<td valign="top"><i>Name</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.SPNWSCFG"><b>SPNWSCFG</b></a></td>
<td valign="top">Service processor NWSCFG</td>
<td valign="top"><i>Name</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.CNNNWSCFG"><b>CNNNWSCFG</b></a></td>
<td valign="top">Connection security NWSCFG</td>
<td valign="top"><i>Name</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.DFTSECRULE"><b>DFTSECRULE</b></a></td>
<td valign="top">Default IP security rule</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *GEN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.IPSECRULE"><b>IPSECRULE</b></a></td>
<td valign="top">IP security rule</td>
<td valign="top">1-16, <b><u>*DFTSECRULE</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.INZSP"><b>INZSP</b></a></td>
<td valign="top">Initialize service processor</td>
<td valign="top"><b><u>*MANUAL</u></b>, *SYNC, *AUTO, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.ENBUNICAST"><b>ENBUNICAST</b></a></td>
<td valign="top">Enable unicast</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.EID"><b>EID</b></a></td>
<td valign="top">Enclosure identifier</td>
<td valign="top">Single values: *AUTO<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Serial number</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Manufacturer type and model</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.SPNAME"><b>SPNAME</b></a></td>
<td valign="top">Service processor name</td>
<td valign="top"><i>Character value</i>, <b><u>*SPINTNETA</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.SPINTNETA"><b>SPINTNETA</b></a></td>
<td valign="top">SP internet address</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.SPAUT"><b>SPAUT</b></a></td>
<td valign="top">SP authentication</td>
<td valign="top">Single values: *DFT<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: User name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: User password</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.SPCERTID"><b>SPCERTID</b></a></td>
<td valign="top">SP certificate identifier</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Component</td>
<td valign="top">
*COMMONNAME, *EMAIL, *ORGUNIT</td>
</tr>
<tr>
<td valign="top">Element 2: Compare value</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.RMTSYSID"><b>RMTSYSID</b></a></td>
<td valign="top">Remote system identifier</td>
<td valign="top">Single values: <b><u>*EID</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Serial number</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Manufacturer type and model</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.DELIVERY"><b>DELIVERY</b></a></td>
<td valign="top">Delivery method</td>
<td valign="top"><i>Character value</i>, <b><u>*DYNAMIC</u></b>, *MANUAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.CHAPAUT"><b>CHAPAUT</b></a></td>
<td valign="top">CHAP authentication</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: CHAP name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: CHAP secret</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#INSLNXSVR.BOOTDEVID"><b>BOOTDEVID</b></a></td>
<td valign="top">Boot device ID</td>
<td valign="top">Single values: <b><u>*SINGLE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Bus</td>
<td valign="top">
0-255</td>
</tr>
<tr>
<td valign="top">Element 2: Device</td>
<td valign="top">
0-31</td>
</tr>
<tr>
<td valign="top">Element 3: Function</td>
<td valign="top">
0-7</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.DYNBOOTOPT"><b>DYNBOOTOPT</b></a></td>
<td valign="top">Dynamic boot options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Vendor ID</td>
<td valign="top">
<i>Character value</i>, <b><u>*DFT</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Alternate client ID</td>
<td valign="top">
<i>Character value</i>, <b><u>*ADPT</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="12"><a href="#INSLNXSVR.RMTIFC"><b>RMTIFC</b></a></td>
<td valign="top">Remote interfaces</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="12">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: SCSI interface</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Adapter address</td>
<td valign="top">
<i>Hexadecimal value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Internet address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Subnet mask</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 4: Gateway address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 5: iSCSI qualified name</td>
<td valign="top">
<i>Character value</i>, <b><u>*GEN</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: LAN interface</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Adapter address</td>
<td valign="top">
<i>Hexadecimal value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Internet address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Subnet mask</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 4: Gateway address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#INSLNXSVR.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.CFGFILE"><b>CFGFILE</b></a></td>
<td valign="top">Configuration file</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Configuration file</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#INSLNXSVR.VRTPTPPORT"><b>VRTPTPPORT</b></a></td>
<td valign="top">Virtual PTP Ethernet port</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Internet address</td>
<td valign="top">
<i>Character value</i>, <b><u>*GEN</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Linux internet address</td>
<td valign="top">
<i>Character value</i>, <b><u>*GEN</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="INSLNXSVR.NWSD"></a>
<h3>Network server description (NWSD)</h3>
<p>Specifies the network server description to be created. The network server description is created using the values specified in this command. The Create Network Server Description (CRTNWSD) command will be used to create a *NWSD object of TYPE(*LINUX). The name is also used as the computer name of the Linux server that is installed as well as the TCP host name for the Linux server.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the network server. The network server name can be up to eight characters. The following characters are allowed in NWSD names:
<ul>
<li>Alphabetical characters A through Z
</li>
<li>Digits 0 through 9
</li>
</ul>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.RSRCNAME"></a>
<h3>Resource name (RSRCNAME)</h3>
<p>Specifies the resource name that identifies the hardware that the description uses.
</p>
<p>This is a required parameter.
</p>
<p>
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. Specify the resource name of the communications adapter. The resource name represents the File Server IOA.
</p>
<dl>
<dt><b>*ISCSI</b></dt>
<dd>This network server resource is an iSCSI attached server.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the resource name. The maximum length of the resource name is 10 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.LNXSVRDST"></a>
<h3>Linux server distribution (LNXSVRDST)</h3>
<p>Specifies the version of Linux server to install on this network server.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the Linux server distribution version to install. You can use F4 while prompting the command to see the complete list of allowed values for this parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.LNXSRCDIR"></a>
<h3>Linux source directory (LNXSRCDIR)</h3>
<p>Specifies the directory associated with the Linux server CD-ROM image that is used as the source for the install. The directory name may reference an optical volume ('/QOPT/volume'), a folder ('/QDLS/folder'), or an integrated file system (IFS) directory ('/dir1/dir2'). An example of a CD-ROM volume path name would be '/QOPT/NTSRV40A'.
</p>
<p>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)
</p>
<p>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.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The default directory path name to use is determined by searching the QOPT file system (/QOPT directory in IFS). The path name for the first volume in QOPT that contains a DOSUTILS directory with a LOADLIN.EXE file in it is used as the default.
<p>
<b>Note: </b>Using *DFT on a system with an optical media library is not recommended. Every volume located in the '/QOPT' path will be searched for a valid Linux install source and will cause each volume to be retrieved and mounted. A specific optical volume path should be specified.
</p>
</dd>
<dt><b><i>path-name</i></b></dt>
<dd>Specify the Linux server source directory path name to use for the install.
<p>
<b>Note: </b>The specified directory must contain a DOSUTILS directory with a LOADLIN.EXE file in it.
</p>
<p>You can use F4 while prompting the command to see a list of path names for optical volumes that are allowed values for this parameter. Folder or IFS path names that are not optical volumes are also allowed, but are not listed when using F4.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.TCPPORTCFG"></a>
<h3>TCP/IP port configuration (TCPPORTCFG)</h3>
<p>Specifies the Linux TCP/IP configuration values that are specific to a port on the network server. This information consists of four parts including the identification of the network server port, the internet address, the subnet mask and the default gateway assigned to the port.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Specifies that there is no Linux TCP/IP port configuration.
</dd>
</dl>
<p><b>Other values (up to 4 repetitions)</b>
</p>
<p><b>Element 1: Port</b>
</p>
<p>Specifies the network server port number to be configured. Specify one of the following values:
</p>
<dl>
<dt><b>1</b></dt>
<dd>Network server port number 1 is configured.
</dd>
<dt><b>2</b></dt>
<dd>Network server port number 2 is configured.
</dd>
<dt><b>3</b></dt>
<dd>Network server port number 3 is configured.
</dd>
<dt><b>4</b></dt>
<dd>Network server port number 4 is configured.
</dd>
</dl>
<p><b>Element 2: Linux internet address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the Linux internet address for the port in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
<p>
<b>Note: </b>The internet address selected must be unique across all NWSD objects and the system's TCP/IP configuration.
</p>
</dd>
</dl>
<p><b>Element 3: Linux subnet mask</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specifies the subnet mask for the Linux internet address in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
<p><b>Element 4: Linux gateway address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specifies the default gateway address for the Linux internet address in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.VRTETHPORT"></a>
<h3>Virtual Ethernet port (VRTETHPORT)</h3>
<p>Specify the TCP/IP configuration for the virtual Ethernet used by the file server.
</p>
<p>
<b>Note: </b>The VRTETHPORT parameter is only available for Integrated xSeries servers.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Specifies that there is no Linux TCP/IP port configuration.
</dd>
</dl>
<p><b>Other values (up to 4 repetitions)</b>
</p>
<p><b>Element 1: Port</b>
</p>
<p>Specifies the network server virtual Ethernet port number to be configured. Specify one of the following values:
</p>
<dl>
<dt><b>*VRTETHn</b></dt>
<dd>The network server virtual Ethernet port 'n' is configured, where 'n' can have a value of 0 through 9.
</dd>
</dl>
<p><b>Element 2: Linux internet address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the Linux internet address for the port in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the system's TCP/IP configuration.
</dd>
</dl>
<p><b>Element 3: Linux subnet mask</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specifies the subnet mask for the Linux internet address in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
<p><b>Element 4: Associated port</b>
</p>
<p>Specifies the resource name that describes the port that is used to establish a connection between a Linux network server and the network.
</p>
<p>
<b>Note: </b>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.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>An associated port resource name is not associated with the line.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the resource name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.TCPDMNNAME"></a>
<h3>TCP/IP local domain name (TCPDMNNAME)</h3>
<p>Specifies the local domain name associated with the network server.
</p>
<p>A domain name can be a text string having 2 to 255 characters. Domain names consist of one or more labels separated by periods. Each label can contain up to 63 characters. The following characters are allowed in domain names:
</p>
<ul>
<li>Alphabetical characters A through Z
</li>
<li>Alphabetical characters a through z
</li>
<li>Digits 0 through 9
</li>
<li>Minus sign (-)
</li>
<li>Period (.). Periods are only allowed when they separate labels of domain style name (refer to RFC 1034).
</li>
</ul>
<p>Uppercase and lowercase characters are allowed, but no significance is attached to the case. The case is maintained as entered. The first and last character of the host name must be an alphabetic character or a digit.
</p>
<dl>
<dt><b><u>*SYS</u></b></dt>
<dd>Specifies that the local domain name for the network server should be the same value as is configured for the system.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify a TCP domain name to be associated with the network server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.TCPNAMSVR"></a>
<h3>TCP/IP name server system (TCPNAMSVR)</h3>
<p>Specifies the internet address of the name server system that is used by the network server. Typically, this is the same value as it is for the system.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SYS</u></b></dt>
<dd>The name server system used by the network server should be the same as for the system.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no name server to be used by the network server.
</dd>
</dl>
<p><b>Other values (up to 3 repetitions)</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify an internet address for the name server system to be used by the network server. Up to three remote name server systems can be specified. The name server systems are used in the order they are specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SVRSTGSIZE"></a>
<h3>Server storage space sizes (SVRSTGSIZE)</h3>
<p>Specifies the size of the server storage spaces, in megabytes.
</p>
<p><b>Element 1: Install source size</b>
</p>
<p>Specifies the size of the storage space that holds the files used to install the Linux server.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>The contents of the DOSUTILS directory of the Linux server installation media and the <u> Integrated Server Support </u> code are copied to the install source drive. The size specified for the install source drive must be large enough to hold this data.
</li>
</ol>
<dl>
<dt><b><u>200</u></b></dt>
<dd>A storage space of 200 megabytes is used for install files.
</dd>
<dt><b><i>200-2047</i></b></dt>
<dd>Specifies the install source size value in megabytes.
</dd>
</dl>
<p><b>Element 2: System size</b>
</p>
<p>Specifies the size, in megabytes, of the storage space that the Linux server operating system is installed on.
</p>
<dl>
<dt><b><u>5000</u></b></dt>
<dd>A storage space of 5000 megabytes is used for system storage.
</dd>
<dt><b><i>1024-1024000</i></b></dt>
<dd>Specifies the system size value, in megabytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SVRSTGASP"></a>
<h3>Storage space ASP (SVRSTGASP)</h3>
<p>Specifies the auxiliary storage pool (ASP) identifiers for the storage space that will contain the files used to install the Linux server and the storage space that will contain the Linux server operating system.
</p>
<p>
<b>Note: </b>You cannot specify values for both the SVRSTGASP and STGASPDEV parameters.
</p>
<p>
<b>Note: </b>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.
</p>
<p><b>Element 1: Install source ASP</b>
</p>
<p>Specifies the auxiliary storage pool for the storage space that holds the files used to install the Linux server.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>The storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.
</dd>
<dt><b><i>1-255</i></b></dt>
<dd>Specify the ASP identifier of the ASP to hold install files. Valid values depend on how many ASPs are defined on the system.
</dd>
</dl>
<p><b>Element 2: System ASP</b>
</p>
<p>Specifies the auxiliary storage pool for the storage space that holds the Linux server operating system.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>The storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.
</dd>
<dt><b><i>1-255</i></b></dt>
<dd>Specify the ASP identifier of the ASP to hold the operating system. Valid values depend on how many ASPs are defined on the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.STGASPDEV"></a>
<h3>Server storage ASP device (STGASPDEV)</h3>
<p>Specifies the auxiliary storage pool (ASP) device for the storage space that will contain the files used to install the Linux server and the storage space that will contain the Linux server operating system.
</p>
<p>
<b>Note: </b>You cannot specify values for both the SVRSTGASP and STGASPDEV parameters.
</p>
<p>
<b>Note: </b>The ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
</p>
<p><b>Element 1: Install source ASP device</b>
</p>
<p>Specifies the independent auxiliary storage pool device for the storage space that holds the files used to install the Linux server.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the device name of the ASP to use for the network server storage space.
</dd>
</dl>
<p><b>Element 2: System ASP device</b>
</p>
<p>Specifies the independent auxiliary storage pool device name for the storage space that holds the Linux server operating system.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the device name of the ASP to use for the network server storage space.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.LNGVER"></a>
<h3>Language version (LNGVER)</h3>
<p>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.
</p>
<dl>
<dt><b><u>*PRIMARY</u></b></dt>
<dd>The installed language environment for Integrated Server Support text and messages is based on the language feature of the system's primary language.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specifies the language feature number that will be used to select the Integrated Server Support text and messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SYNCTIME"></a>
<h3>Synchronize date and time (SYNCTIME)</h3>
<p>Specifies whether the system should synchronize the network server date and time with the host system date and time.
</p>
<p>The QTIMZON system value must be set to the correct value for time synchronization to work correctly.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The system synchronizes the file server date and time with the host system date and time at every vary on and at least every 30 minutes thereafter.
</dd>
<dt><b>*NO</b></dt>
<dd>The system synchronizes the file server date and time with the host system date and time when the network server description is varied on, but will not keep the date and time synchronized while the network server description is in a varied on state.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.RSTDDEVRSC"></a>
<h3>Restricted device resources (RSTDDEVRSC)</h3>
<p>Specifies the system's device resource names that are restricted and cannot be used by the Linux server.
</p>
<p>
<b>Note: </b>Only tape and optical device resources can be restricted.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No device resources are restricted from the network server. Therefore, any tape or optical device resources that exist on the system can be used.
</dd>
<dt><b>*ALL</b></dt>
<dd>All tape and optical resources are restricted from being used by the network server.
</dd>
</dl>
<p><b>Other values (up to 10 repetitions)</b>
</p>
<dl>
<dt><b>*ALLOPT</b></dt>
<dd>All optical resources are restricted from being used by the network server.
<p>
<b>Note: </b>This value can only be specified once.
</p>
</dd>
<dt><b>*ALLTAPE</b></dt>
<dd>All tape resources are restricted from being used by the network server.
<p>
<b>Note: </b>This value can only be specified once.
</p>
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the restricted device resource that cannot be used by the network server.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SHUTDTIMO"></a>
<h3>Shutdown timeout (SHUTDTIMO)</h3>
<p>Specifies the server shutdown time-out value, in minutes. This is used to limit the amount of time that the servers operating system is allowed to shutdown before the server is varied offline.
</p>
<dl>
<dt><b><u>15</u></b></dt>
<dd>The network server default shutdown time-out value is used.
</dd>
<dt><b><i>2-45</i></b></dt>
<dd>Specify the time (in minutes) to wait. The system waits until the network servers operating system has shutdown successfully, or until the specified time passes before varying the network server offline.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.ACTTMR"></a>
<h3>Activation timer (ACTTMR)</h3>
<p>Specifies the amount of time (in seconds) the system will wait for the connection to be established to the remote server's service processor and to power on the remote server.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>120</u></b></dt>
<dd>The activate time of 120 seconds is used.
</dd>
<dt><b><i>30-1800</i></b></dt>
<dd>Specify the number of seconds to wait.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.CMNMSGQ"></a>
<h3>Communications message queue (CMNMSGQ)</h3>
<p>Specifies the name of a message queue to receive communications status messages.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SYSOPR</u></b></dt>
<dd>Causes messages to be placed in the system operator message queue (QSYSOPR) in library QSYS.
</dd>
</dl>
<p><b>Qualifier 1: Communications message queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a message queue to receive communications status messages.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>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.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.STGPTH"></a>
<h3>Storage path (STGPTH)</h3>
<p>Specifies the storage paths the storage spaces can use. This information consists of the <b>Network server host adapter</b> (NWSH) description.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p><b>Element 1: Network server host adapter</b>
</p>
<dl>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the name of an existing <b>Network server host adapter</b> (NWSH) description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.VRTETHPTH"></a>
<h3>Virtual Ethernet path (VRTETHPTH)</h3>
<p>Specifies the virtual Ethernet paths the Ethernet line descriptions can use. This information consists of two parts including the virtual Ethernet port and the <b>Network server host adapter</b> (NWSH) description. You can enter up to five values for this parameter. You must enter at least one virtual Ethernet path which is the path to be used by the *VRTETHPTP line description.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>You can specify 5 values for this parameter.
</p>
<p><b>Element 1: Port</b>
</p>
<dl>
<dt><b><u>*VRTETHPTP</u></b></dt>
<dd>The network server virtual Ethernet point to point port is configured.
</dd>
<dt><b>*VRTETHn</b></dt>
<dd>The virtual Ethernet port 'n' is configured, where 'n' can have a value of 0 through 9.
</dd>
</dl>
<p><b>Element 2: Network server host adapter</b>
</p>
<dl>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the name of an existing <b>Network server host adapter</b> (NWSH) description. The network server host adapter name does not need to be unique for each VRTETHPTH parameter on this NWSD.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SHUTDPORT"></a>
<h3>Shutdown TCP port (SHUTDPORT)</h3>
<p>Specifies the TCP port to use for shutdown.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>8700</u></b></dt>
<dd>Use the TCP port number of 8700.
</dd>
<dt><b><i>1024-65535</i></b></dt>
<dd>Specify the port number identifying the port that is to be used for shutdown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.VRTETHCTLP"></a>
<h3>Virtual Ethernet control port (VRTETHCTLP)</h3>
<p>Specifies the TCP port to use for virtual Ethernet control.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>8800</u></b></dt>
<dd>Use the TCP port number of 8800.
</dd>
<dt><b><i>1024-65535</i></b></dt>
<dd>Specifies the port number identifying the port that is to be used for virtual Ethernet control.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.RMTNWSCFG"></a>
<h3>Remote system NWSCFG (RMTNWSCFG)</h3>
<p>Specifies the remote system network server configuration to use with this server.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Use the system generated default remote system network server configuration name of 'nwsdnameRM' where nwsdname is the name of the network server description.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an existing remote system network server configuration.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SPNWSCFG"></a>
<h3>Service processor NWSCFG (SPNWSCFG)</h3>
<p>Specifies the service processor network server configuration to use with this server.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Use the system generated default service processor network server configuration name of 'nwsdnameSP' where nwsdname is the name of the network server description.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an existing service processor network server configuration.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.CNNNWSCFG"></a>
<h3>Connection security NWSCFG (CNNNWSCFG)</h3>
<p>Specifies the connection security network server configuration to use with this server.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Use the system generated default connection security network server configuration name of 'nwsdnameCN' where nwsdname is the name of the network server description.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an existing connection security network server configuration.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.DFTSECRULE"></a>
<h3>Default IP security rule (DFTSECRULE)</h3>
<p>Specifies the default IP Security (IPSec) rule used between the hosting and remote system.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the connection security network server configuration specified for the <b>Connection security NWSCFG (CNNNWSCFG)</b> parameter already exists.
</p>
<p>A value other than *DFTSECRULE must be specified on the IP security rule (IPSECRULE) parameter in this case.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>IP Security rules are not configured.
</dd>
<dt><b>*GEN</b></dt>
<dd>The system will automatically generate a random pre-shared key.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the pre-shared key. A pre-shared key is a nontrivial string up to 32 characters long using only the following characters: A-Z a-z 0-9 + = % &amp; ( ) , _ - . : ;. These characters are part of the Syntactic Character Set (character set number 640).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.IPSECRULE"></a>
<h3>IP security rule (IPSECRULE)</h3>
<p>Specify the relative entry of the IP security rules (IPSECRULE) parameter, defined in the existing connection security network server configuration that will be used as the initial IP security setting between the hosting and remote system.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<dl>
<dt><b><u>*DFTSECRULE</u></b></dt>
<dd>Use the value specified on the <b>Default IP security rule (DFTSECRULE)</b> parameter.
<p>
<b>Note: </b>This value is not valid when the <b>Connection security NWSCFG</b> specified already exists.
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>Remote interface will not use any security rule.
</dd>
<dt><b><i>1-16</i></b></dt>
<dd>Remote interface will use security rule specified
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.INZSP"></a>
<h3>Initialize service processor (INZSP)</h3>
<p>Specifies how the remote system's service processor is secured.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>Some service processors do not support secure connections. Use *NONE for these service processors. Additional information can be found at Integrated xSeries solutions at http://www.ibm.com/servers/eserver/iseries/integratedxseries.
</p>
<dl>
<dt><b><u>*MANUAL</u></b></dt>
<dd>Security parameters are manually configured on remote system's service processor. *MANUAL provides the highest security. To use this option it is required that the remote system's service processor is pre-configured with a user name, password and certificate. Certificate management will be required. This method is appropriate when connecting to the service processor via public networks to protect the password.
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
</dd>
<dt><b>*AUTO</b></dt>
<dd>Parameters are automatically configured on the remote system's service processor. *AUTO provides security without requiring pre-configuration of the remote system's service processor. The remote system's service processor will automatically generate a certificate. The connection is secure once initialized. This option is appropriate if the interconnecting network is physically secure or is protected by a firewall.
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
</dd>
<dt><b>*SYNC</b></dt>
<dd>This network server configuration will synchronize the self-signed certificate with the service processor.
<p>
<b>Note: </b>This value is only valid when the service processor has already been configured by another network server configuration with *AUTO specified for the Initialize service processor (INZSP) parameter. The current user name and password for the service processor must be specified on the <b>SP authentication (SPAUT)</b> parameter to perform this option.
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>The password is sent in the clear. Use this only if the interconnecting network is physically secure.
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.ENBUNICAST"></a>
<h3>Enable unicast (ENBUNICAST)</h3>
<p>Specifies whether unicast packet distribution is to be used. Unicast is a transmission method where packets are sent directly to the specified <b>Service processor name (SPNAME)</b> or <b>SP internet address (SPINTNETA)</b> parameter. The system identification for the Enclosure identifier (EID) parameter is automatically retrieved if *AUTO is specified and the system hardware supports it.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Disable unicast
</dd>
<dt><b>*YES</b></dt>
<dd>Enable unicast.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.EID"></a>
<h3>Enclosure identifier (EID)</h3>
<p>Specifies the identifying serial number, type and model of the enclosure containing the service processor. They are required to locate the remote system on the network when ENBUNICAST(*NO) is specified. Look for these values on the label of the system.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*AUTO</b></dt>
<dd>Automatically retrieve the identifier when ENBUNICAST(*YES) is specified.
</dd>
</dl>
<p><b>Element 1: Serial number</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the remote system's machine serial number.
</dd>
</dl>
<p><b>Element 2: Manufacturer type and model</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the remote system's machine type and model in the form <u> ttttmmm</u> where <u> tttt</u> is the machine type and <u> mmm</u> is the machine model number.
<p>
<b>Note: </b>The remote system's machine type and model may be ommitted if the systems serial number is unique on the network.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SPNAME"></a>
<h3>Service processor name (SPNAME)</h3>
<p>Specifies the remote system's service processor host name.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
<p>
<b>Note: </b>This parameter is required when ENBUNICAST(*YES) is specified.
</p>
<dl>
<dt><b><u>*SPINTNETA</u></b></dt>
<dd>The remote system is identified by the value specified for the <b>SP internet address (SPINTNETA)</b> parameter.
</dd>
<dt><b><i>host-name</i></b></dt>
<dd>Specify the remote system's service processor host name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SPINTNETA"></a>
<h3>SP internet address (SPINTNETA)</h3>
<p>Specify the remote system's service processor internet address. Internet addresses are expressed in the decimal form <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
<p>This parameter is required when SPNAME(*SPINTNETA) is specified.
</p>
<p>
<b>Note: </b>This parameter is ignored when ENBUNICAST(*NO) is specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the internet address of the service processor.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SPAUT"></a>
<h3>SP authentication (SPAUT)</h3>
<p>Specifies the service processor user name and password.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*DFT</b></dt>
<dd>The default service processor userid and password are used.
<p>
<b>Note: </b>This value is only valid when INZSP(*NONE) is specified on this command or in the existing network server configuration.
</p>
</dd>
</dl>
<p><b>Element 1: User name</b>
</p>
<dl>
<dt><b><i>user-name</i></b></dt>
<dd>Specify the remote system's service processor user name.
</dd>
</dl>
<p><b>Element 2: User password</b>
</p>
<dl>
<dt><b><i>password-value</i></b></dt>
<dd>Specify remote system's service processor password. Password must be at least 5 characters in length and contain at least one alphabetic character and one numeric or symbolic character.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.SPCERTID"></a>
<h3>SP certificate identifier (SPCERTID)</h3>
<p>The SP certificate identifier specifies one of three possible fields that identifies the service processor's certificate. This parameter is specified to provide additional validation that the certificate is from the service processor. The contents of the selected field must exactly match the value of the field that was entered when the certificate was generated or requested from a certificate authority.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the service processor network server configuration specified for the <b>Service processor NWSCFG (SPNWSCFG)</b> parameter already exists.
</p>
<p>This parameter is required when INZSP(*MANUAL) is specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Service processor certificate is not configured.
</dd>
</dl>
<p><b>Element 1: Component</b>
</p>
<dl>
<dt><b>*COMMONNAME</b></dt>
<dd>Selects the certificates common name specified when the certificate was generated or requested from a certificate authority. On the remote supervisor adapter II this correlates to the "ASM Domain Name" field used to generate a self-signed certificate or generate a certificate signing request.
</dd>
<dt><b>*EMAIL</b></dt>
<dd>Selects the certificate's e-mail address specified when the certificate was generated or requested from a certificate authority. On the remote supervisor adapter II this correlates to the "Email Address" field used to generate a self-signed certificate or generate a certificate signing request.
</dd>
<dt><b>*ORGUNIT</b></dt>
<dd>Selects the certificate's organizational unit specified when the certificate was generated or requested from a certificate authority. On the remote supervisor adapter II this correlates to the "Organizational Unit" field used to generate a self-signed certificate or generate a certificate signing request.
</dd>
</dl>
<p><b>Element 2: Compare value</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the certificates component compare value. Specify no more than 255 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.RMTSYSID"></a>
<h3>Remote system identifier (RMTSYSID)</h3>
<p>Specifies the identifying serial number, type and model of the remote system. When specified, they are used to locate the remote system on the network. Look for these values on the label of the remote system.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the remote system network server configuration specified for the <b>Remote system NWSCFG (NWSCFG)</b> parameter already exists.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*EID</u></b></dt>
<dd>Use the service processor identifier.
</dd>
</dl>
<p><b>Element 1: Serial number</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the remote system's machine serial number.
</dd>
</dl>
<p><b>Element 2: Manufacturer type and model</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the remote system's machine type and model in the form <u> ttttmmm</u> where <u> tttt</u> is the machine type and <u> mmm</u> is the machine model number.
<p>
<b>Note: </b>The remote system's machine type and model may be ommitted if the systems serial number is unique on the network.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.DELIVERY"></a>
<h3>Delivery method (DELIVERY)</h3>
<p>Specifies how the parameters necessary to configure the remote system are delivered.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the remote system network server configuration specified for the <b>Remote system NWSCFG (NWSCFG)</b> parameter already exists.
</p>
<dl>
<dt><b><u>*DYNAMIC</u></b></dt>
<dd>Parameters are dynamically delivered to the remote system using DHCP.
</dd>
<dt><b>*MANUAL</b></dt>
<dd>Parameters are manually configured on the remote system using the BIOS utilities (System BIOS or Adapter BIOS - ALT-Q).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.CHAPAUT"></a>
<h3>CHAP authentication (CHAPAUT)</h3>
<p>Specifies the Challenge Handshake Authentication Protocol (CHAP) for the host system iSCSI target to authenticate the remote system initiator node.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the remote system network server configuration specified for the <b>Remote system NWSCFG (NWSCFG)</b> parameter already exists.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>CHAP authentication is not enabled.
</dd>
</dl>
<p><b>Element 1: CHAP name</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the CHAP name. CHAP names are translated to ASCII code page 850 using the job's coded character set identifier (CCSID).
</dd>
</dl>
<p><b>Element 2: CHAP secret</b>
</p>
<dl>
<dt><b><i>character-string</i></b></dt>
<dd>Specify the secret you want to use for the Challenge Handshake Authentication Protocol as a value up to 24-characters long using only the following invariant characters: A-Z a-z 0-9 + = % &amp; ( ) , _ - . : ;. These characters are part of the Syntactic Character Set (character set number 640).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.BOOTDEVID"></a>
<h3>Boot device ID (BOOTDEVID)</h3>
<p>Specifies the PCI Function Address (Bus/Device/Function) of the iSCSI adapter in the remote system that will be used to boot from. This information can be accessed using the BIOS utilities (System BIOS or Adapter BIOS - ALT-Q).
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the remote system network server configuration specified for the <b>Remote system NWSCFG (NWSCFG)</b> parameter already exists.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SINGLE</u></b></dt>
<dd>The single iSCSI adapter is used on the remote system
<p>
<b>Note: </b>Remote systems with more than one iSCSI adapter installed in the server are required to specify which adapter will be used to boot from.
</p>
</dd>
</dl>
<p><b>Element 1: Bus</b>
</p>
<dl>
<dt><b><i>0-255</i></b></dt>
<dd>Specify the bus number of the remote system's iSCSI adapter that will be used to boot.
</dd>
</dl>
<p><b>Element 2: Device</b>
</p>
<dl>
<dt><b><i>0-31</i></b></dt>
<dd>Specify the device number of the remote system's iSCSI adapter that will be used to boot.
</dd>
</dl>
<p><b>Element 3: Function</b>
</p>
<dl>
<dt><b><i>0-7</i></b></dt>
<dd>Specify the function number of the remote system's iSCSI adapter that will be used to boot.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.DYNBOOTOPT"></a>
<h3>Dynamic boot options (DYNBOOTOPT)</h3>
<p>Specifies the configuration of the internel DHCP server.
</p>
<p>This is an advanced function.
</p>
<p>This parameter is used to configure the internal DHCP Server that is part of the iSCSI Target Host Bus Adapter firmware and it's required to provide IP address and diskless boot parameters for the remote iSCSI Initiator.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the remote system network server configuration specified for the <b>Remote system NWSCFG (NWSCFG)</b> parameter already exists.
</p>
<p>This parameter is only valid when DELIVERY(*DYNAMIC) is specified.
</p>
<p><b>Element 1: Vendor ID</b>
</p>
<p>The client and server are pre-configured to a fixed vendor ID (IBM_ISAN). Network administrators can configure clients to define their own idetifying values to convey hardware, operating system or other identifying information. DHCP option 60 described in the IETF RFC 2132 is used for this function.
</p>
<dl>
<dt><b><u>IBM_ISAN</u></b></dt>
<dd>The default vendor ID of IBM_ISAN will be used.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the vendor ID of the remote system's iSCSI adapter that will be used.
</dd>
</dl>
<p><b>Element 2: Alternate client ID</b>
</p>
<p>Used by clients to specify their unique identifier to the server. Each client's identifier must be unique among all other client identifiers used on the effective DHCP network to which the client is attached (that is, the client's local subnet and any remote subnets reachable using DHCP relay). Vendors and system administrators are responsible for choosing client identifiers that meet this requirement for uniqueness. DHCP option 61 described in the IETF RFC 2132 is used for this function.
</p>
<dl>
<dt><b><u>*ADPT</u></b></dt>
<dd>The default Client ID consists of the adapter address for the remote system's iSCSI adapter. This value will be used to identify the remote system.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the Client ID of the remote system's iSCSI adapter that will be used to boot.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.RMTIFC"></a>
<h3>Remote interfaces (RMTIFC)</h3>
<p>Specifies the remote system's interfaces. This information is used to identify and configure the remote system's interfaces. Each adapter has two functions to support a SCSI and a LAN interface.
</p>
<p>
<b>Note: </b>This parameter is only valid when *ISCSI is specified for the <b>Resource name (RSRCNAME)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is ignored when the remote system network server configuration specified for the <b>Remote system NWSCFG (NWSCFG)</b> parameter already exists.
</p>
<p><b>Element 1: SCSI interface</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Adapter address</b>
</p>
<dl>
<dt><b><i>hexadecimal-value</i></b></dt>
<dd>Specify the 12-character hexadecimal adapter address for the remote system's SCSI interface.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Internet address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the internet address for the remote system's SCSI interface in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 3: Subnet mask</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the subnet mask for the remote system's SCSI interface in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 4: Gateway address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the gateway address for the remote system's SCSI interface in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 5: iSCSI qualified name</b>
</p>
<dl>
<dt><b><u>*GEN</u></b></dt>
<dd>The system will automatically generate the iSCSI qualified name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the iSCSI qualified name for the remote system's SCSI interface. iSCSI qualified names are translated to UTF-8 using the job's coded character set identifier (CCSID). The following characters are allowed in iSCSI qualified names:
<ul>
<li>Alphabetical characters A through Z converted to lower case (refer to RFC 3722)
</li>
<li>Alphabetical characters a through z
</li>
<li>Digits 0 through 9
</li>
<li>Period (.)
</li>
<li>Dash (-)
</li>
<li>colon (:)
</li>
</ul>
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: LAN interface</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Adapter address</b>
</p>
<dl>
<dt><b><i>hexadecimal-value</i></b></dt>
<dd>Specify the 12-character hexadecimal adapter address for the remote system's LAN interface.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Internet address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the internet address for the remote system's LAN interface port in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 3: Subnet mask</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the subnet mask for the remote system's LAN interface in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 4: Gateway address</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the gateway address for the remote system's LAN interface in the form, <u> nnn.nnn.nnn.nnn</u> , where <u> nnn</u> is a decimal number ranging from 0 through 255.
</dd>
</dl>
</dd>
</dl>
<p><b>Element 3: TCP/IP name server system</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify an internet address for the domain name server to be used by the the remote system's adapter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the objects created by this command.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.CFGFILE"></a>
<h3>Configuration file (CFGFILE)</h3>
<p>Specifies the source file that contains configuration data, to be used in activating or further defining the server.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No configuration file is specified.
</dd>
</dl>
<p><b>Qualifier 1: Configuration file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a source file containing the configuration data member(s) for the server. At the time the server is activated, all members in the file will be processed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>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.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSLNXSVR.VRTPTPPORT"></a>
<h3>Virtual PTP Ethernet port (VRTPTPPORT)</h3>
<p>Specifies the TCP/IP configuration for the virtual point-to-point Ethernet port.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>The VRTPTPPORT parameter must be used for Integrated xSeries servers running on the host system.
</li>
<li>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.
</li>
</ol>
<p><b>Element 1: Internet address</b>
</p>
<p>Specifies the internet address for the host side of the virtual point-to-point Ethernet connection. Specify one of the following values:
</p>
<dl>
<dt><b><u>*GEN</u></b></dt>
<dd>Specify *GEN to let the INSLNXSVR command configure a virtual point-to-point Ethernet port with a generated internet address.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the host internet address for the virtual point-to-point Ethernet port in the form, <u> xxx.yyy.zzz.nnn</u> , where <u> xxx</u> , <u> yyy</u> , <u> zzz</u> , and <u> nnn</u> are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the host TCP/IP configuration. The <u> xxx.yyy.zzz</u> value in the internet address must match the <u> xxx.yyy.zzz</u> value for the internet address of the Linux server side of the point-to-point Ethernet port.
</dd>
</dl>
<p><b>Element 2: Linux internet address</b>
</p>
<p>Specifies the internet address for the Linux side of the virtual point-to-point Ethernet connection. Specify one of the following values:
</p>
<dl>
<dt><b><u>*GEN</u></b></dt>
<dd>Specify *GEN to let the INSLNXSVR command configure a virtual point-to-point Ethernet port with a generated internet address.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the Linux server internet address for the virtual point-to-point Ethernet port in the form, <u> xxx.yyy.zzz.nnn</u> , where <u> xxx</u> , <u> yyy</u> , <u> zzz</u> , and <u> nnn</u> are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the host TCP/IP configuration. The <u> xxx.yyy.zzz</u> value in the internet address must match the <u> xxx.yyy.zzz</u> value for the internet address of the host side of the point-to-point Ethernet port.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INSLNXSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Install Linux Using Non-iSCSI Hardware</b>
</p>
<p>
<pre>
INSLNXSVR NWSD(RHEL3MAR) RSRCNAME(LIN03) LNXSVRDST(*RHEL4)
SVRSTGSIZE(200 12000) LNGVER(2920)
TEXT('RedHat 4 server')
</pre>
</p>
<p>This command will install a Linux server with a Red Hat 4 distribution on non-iSCSI hardware. It will contain a 12 gb system drive and exist on resource name LIN03. The name RHEL3MAR will be associated with the network server description on the iSeries side. The language version used will be 2920.
</p>
<p><b>Example 2: Install Linux Using iSCSI Hardware</b>
</p>
<p>
<pre>
INSLNXSVR NWSD(RHEL3MAR) RSRCNAME(*ISCSI) LNXSVRDST(*SLES8)
SVRSTGSIZE(200 12000) SVRSTGASP(2) LNGVER(2920)
SHUTDTIMO(2) ACTTMR(300) ENBUNICAST(*YES)
SPINTNETA('9.5.2.32') SPAUT(JSMITH ())
TEXT('RedHat 4 server')
</pre>
</p>
<p>This command will install a Linux server with a SuSE 8 distribution on iSCSI hardware. It will contain a 12 gb which resides on user ASP 2. The name RHEL3MAR will be associated with the network server description on the iSeries side. The langauge version used will be 2920. The shutdown timeout will be set to 2 minutes. The system will wait 300 seconds for the connection to be made to the remote server's service processor. Unicast packet distribution will be used over iSCSI. The remote server's service processor internet address will be set to 9.5.2.32. SP authentication will be made with username JSMITH.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INSLNXSVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>NTA1007</b></dt>
<dd>Network server &amp;1 must be varied off.
</dd>
<dt><b>NTA1199</b></dt>
<dd>Vary on or off of the Linux server not successful.
</dd>
<dt><b>NTA119A</b></dt>
<dd>Linux server installation not successful.
</dd>
<dt><b>NTA1024</b></dt>
<dd>Storage space assigned to server &amp;1 missing, damaged or not valid.
</dd>
<dt><b>NTA1030</b></dt>
<dd>Internal error occurred.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSLNXSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>