ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzau9_5.4.0.1/rzau9comparameters.htm

665 lines
24 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="task" />
<meta name="DC.Title" content="INSLNXSVR command parameter descriptions" />
<meta name="abstract" content="This topic describes the command parameters associated with INSLNXSVR." />
<meta name="description" content="This topic describes the command parameters associated with INSLNXSVR." />
<meta name="DC.Relation" scheme="URI" content="rzau9startos400install.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzau9comparameters" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>INSLNXSVR command parameter descriptions</title>
</head>
<body id="rzau9comparameters"><a name="rzau9comparameters"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">INSLNXSVR command parameter descriptions</h1>
<div><p>This topic describes the command parameters associated with INSLNXSVR.</p>
<div class="section"><p><strong><u>Network server description (NWSD)</u></strong> </p>
<p></p>
<p>The
network server description is created using the values specified in this command.
This name is also used as the prefix for the system and install drives, as
well as the Point-to-Point Virtual Ethernet line description. By default,
this is the name 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></p>
<p>This is a
required parameter. </p>
<p> </p>
<p><strong><em>name</em></strong> </p>
<p> 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:</p>
<p></p>
<p>• Alphabetical
characters A through Z </p>
<p>• Digits 0 through 9</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Resource
name (RSRCNAME)</u></strong></p>
<p></p>
<p>Specifies the resource name that identifies
the hardware that the network server description uses. 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>
<p></p>
<p>This
is a required parameter.</p>
<p></p>
<p><strong><em>name</em></strong></p>
<p>Specify the
resource name. The maximum length of the resource name is 10 characters. </p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Linux
server distribution (LNXSVRDST)</u></strong></p>
<p></p>
<p>Specifies the version
of Linux server to install on this network server. At the time of writing,
the valid options are *RHEL3, *RHEL4, *SLES8 or *SLES9. This might change
as newer Linux distributions become available.</p>
<p></p>
<p>This is a required
parameter.</p>
<p></p>
<p><strong>character-value</strong> </p>
<p>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. </p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Linux
source directory (LNXSRCDIR)</u></strong></p>
<p></p>
<p>This parameter is only used
to install RHEL 3. This parameter is not used with RHEL 4, SLES 8 or SLES
9 because these versions install from the media located in the optical drive
of an IXA-attached xSeries server.</p>
<p></p>
<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/RHEL_3 I386/. </p>
<p></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></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>
<p></p>
<p><strong><u>*DFT </u></strong></p>
<p>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>
<p></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> 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. </div>
</div>
<p></p>
<p><strong>path-name</strong> </p>
<p>Specify
the Linux server source directory path name to use for the install. </p>
<p></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> The
specified directory must contain a DOSUTILS directory with a LOADLIN.EXE file
in it.</div>
</div>
<p></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>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>TCP/IP
port configuration (TCPPORTCFG)</u></strong></p>
<p></p>
<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></p>
<p></p>
<p></p>
<p></p>
<p><strong> <u>Virtual Ethernet
port (VRTETHPORT)</u></strong></p>
<p></p>
<p>Specify the TCP/IP configuration for
the virtual Ethernet used by the file server.</p>
<p></p>
<p><strong>Single values</strong></p>
<p></p>
<p><strong><u>*NONE</u></strong></p>
<p>Specifies
that there is no Linux TCP/IP port configuration.</p>
<p></p>
<p><strong>Other values
(up to 4 repetitions)</strong></p>
<p></p>
<p><strong>Element 1: Port </strong></p>
<p></p>
<p>Specifies
the network server virtual Ethernet port number to be configured. Specify
one of the following values:</p>
<p></p>
<p><strong>*VRTETHn</strong> </p>
<p>The network
server virtual Ethernet port 'n' is configured, where 'n' can have a value
of 0 through 9. </p>
<p></p>
<p><strong>Element 2: Linux internet address</strong></p>
<p></p>
<p><strong>character-value</strong></p>
<p>Specify
the Linux internet address for the port in the form, nnn.nnn.nnn.nnn, where
nnn 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.</p>
<p></p>
<p><strong>Element
3: Linux subnet mask</strong></p>
<p></p>
<p><strong>character-value</strong></p>
<p>Specifies
the subnet mask for the Linux internet address in the form, nnn.nnn.nnn.nnn,
where nnn is a decimal number ranging from 0 through 255.</p>
<p></p>
<p><strong>Element
4: Associated port</strong> </p>
<p></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></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> 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. </div>
</div>
<p></p>
<p><strong><u>*NONE</u></strong> </p>
<p>An
associated port resource name is not associated with the line.</p>
<p><strong><em>name</em></strong></p>
<p>Specify
the resource name.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>TCP/IP local domain
name (TCPDMNNAME)</u></strong></p>
<p></p>
<p>Specifies the local domain name associated
with the network server.</p>
<p></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>
<p></p>
<p>• Alphabetical characters A through
Z</p>
<p>• Alphabetical characters a through z</p>
<p>• Digits 0 through 9</p>
<p>
Minus sign (-) </p>
<p>• Period (.). Periods are only allowed when they separate
labels of domain style name (refer to RFC 1034).</p>
<p></p>
<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>
<p></p>
<p><strong><u>*SYS</u></strong></p>
<p>Specifies
that the local domain name for the network server should be the same value
as is configured for the system.</p>
<p><strong><em>character-value</em></strong></p>
<p>Specify
a TCP domain name to be associated with the network server.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>TCP/IP
name server system (TCPNAMSVR)</u></strong></p>
<p></p>
<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></p>
<p><strong>Single values</strong> </p>
<p></p>
<p><strong><u>*SYS</u></strong></p>
<p>The
name server system used by the network server should be the same as for the
system.</p>
<p><strong>*NONE</strong> </p>
<p>There is no name server to be used by the
network server.</p>
<p></p>
<p><strong>Other values (up to 3 repetitions)</strong> </p>
<p></p>
<p><strong><em>character-value</em></strong> </p>
<p>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.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p> <strong><u>Server
storage space sizes (SVRSTGSIZE)</u></strong></p>
<p></p>
<p>Specifies the size of
the server storage spaces, in megabytes.</p>
<p></p>
<p></p>
<p><strong>Element 1:
Install source size</strong></p>
<p></p>
<p>Specifies the size of the storage space
that holds the files used to install the Linux server.</p>
<p></p>
<p><strong><u>*CALC</u></strong></p>
<p></p>
<p>Specifies
that the size should be calculated based on the space required to hold the
install source. Typically, a storage space of 200 megabytes is created for
the install source disk.</p>
<p></p>
<p><strong>integer</strong></p>
<p></p>
<p>Specifies
the install source size value in megabytes. The size must be at least 200
megabytes but no larger than 2047 megabytes.</p>
<p></p>
<p><strong>Note:</strong> </p>
<p></p>
<p>The
Integrated Server Support code is copied to the install source drive. The
size specified for the install source drive must be large enough to hold this
data. </p>
<p></p>
<p><strong>Element 2: System size</strong> </p>
<p></p>
<p>Specifies
the size, in megabytes, of the storage space that the Linux server operating
system is installed on.</p>
<p></p>
<p><strong><u>*CALC</u></strong></p>
<p></p>
<p>Specifies
that the size should be calculated based on the space required to hold the
Linux installation. Typically, a storage space of 12000 megabytes is created
for the system disk.</p>
<p></p>
<p><strong>integer</strong></p>
<p></p>
<p>Specifies the
size of the system disk value in megabytes. The size must be at least 1024
megabytes but no larger than 1024000 megabytes.</p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> Be careful about
specifying a system drive size less than the calculated value. While this
might work initially, over time as you install more distribution updates you
might run out of space.</div>
</div>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Storage
space ASP (SVRSTGASP)</u></strong></p>
<p></p>
<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></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> You cannot specify values for
both the SVRSTGASP and STGASPDEV parameters.</div>
</div>
<p></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> 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.</div>
</div>
<p></p>
<p><strong>Element 1: Install source
ASP</strong></p>
<p></p>
<p>Specifies the auxiliary storage pool for the storage
space that holds the files used to install the Linux server. </p>
<p></p>
<p><strong><u>1</u> </strong></p>
<p>The
storage space is created in auxiliary storage pool 1, the system auxiliary
storage pool. </p>
<p><strong><em>1-255</em> </strong></p>
<p>Specify the ASP identifier
of the ASP to hold install files. Valid values depend on how many ASPs are
defined on the system.</p>
<p></p>
<p><strong>Element 2: System ASP</strong> </p>
<p></p>
<p>Specifies
the auxiliary storage pool for the storage space that holds the Linux server
operating system.</p>
<p></p>
<p><strong><u>1</u></strong> </p>
<p>The storage space is
created in auxiliary storage pool 1, the system auxiliary storage pool.</p>
<p><strong><em>1-255 </em></strong></p>
<p>Specify
the ASP identifier of the ASP to hold the operating system. Valid values depend
on how many ASPs are defined on the system.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Server
storage ASP device (STGASPDEV)</u></strong></p>
<p></p>
<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></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> You cannot specify values
for both the SVRSTGASP and STGASPDEV parameters.</div>
</div>
<p></p>
<p>The ASP
must have been activated (by varying on the ASP device) and have a status
of 'Available'.</p>
<p></p>
<p><strong>Element 1: Install source ASP device </strong></p>
<p></p>
<p>Specifies
the independent auxiliary storage pool device for the storage space that holds
the files used to install the Linux server.</p>
<p></p>
<p><strong><em>name</em></strong> </p>
<p>Specify
the device name of the ASP to use for the network server storage space.</p>
<p></p>
<p><strong>Element
2: System ASP device</strong> </p>
<p></p>
<p>Specifies the independent auxiliary
storage pool device name for the storage space that holds the Linux server
operating system.</p>
<p></p>
<p><strong><em>name</em></strong></p>
<p>Specify the device
name of the ASP to use for the network server storage space.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Language
version (LNGVER)</u></strong></p>
<p></p>
<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>
<p></p>
<p><strong><u>*PRIMARY </u></strong></p>
<p>The
installed language environment for Integrated Server Support text and messages
is based on the language feature of the system's primary language.</p>
<p><strong><em>integer</em></strong></p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Synchronize
date and time (SYNCTIME)</u></strong></p>
<p></p>
<p>Specifies whether the system
should synchronize the network server date and time with the host system date
and time.</p>
<p></p>
<p>The QTIMZON system value must be set to the correct
value for time synchronization to work correctly.</p>
<p></p>
<p><strong><u>*YES </u></strong></p>
<p>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</p>
<p><strong>*NO</strong></p>
<p>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.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Restricted device
resources (RSTDDEVRSC)</u></strong></p>
<p></p>
<p>Specifies the system's device
resource names that are restricted and cannot be used by the Linux server.
The installation of RHEL 3 requires that at least one optical drive is not
restricted.</p>
<p></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> Only tape and optical device resources can
be restricted.</div>
</div>
<p></p>
<p><strong>Single values</strong></p>
<p></p>
<p><strong><u>*NONE</u> </strong></p>
<p>No
device resources are restricted from the network server. Therefore, any tape
or optical device resources that exist on the system can be used.</p>
<p><strong>*ALL</strong> </p>
<p>All
tape and optical resources are restricted from being used by the network server. </p>
<p></p>
<p><strong>Other
values (up to 10 repetitions)</strong> </p>
<p></p>
<p><strong>*ALLOPT </strong></p>
<p>All
optical resources are restricted from being used by the network server.</p>
<p></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> This
value can only be specified once.</div>
</div>
<p></p>
<p><strong>*ALLTAPE</strong> </p>
<p>All
tape resources are restricted from being used by the network server.</p>
<p></p>
<div class="p"><div class="note"><span class="notetitle">Note:</span> This
value can only be specified once.</div>
</div>
<p></p>
<p><strong><em>name</em></strong></p>
<p>Specify
the name of the restricted device resource that cannot be used by the network
server.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Shutdown timeout (SHUTDTIMO)</u></strong></p>
<p></p>
<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>
<p></p>
<p><strong><u>15</u></strong></p>
<p>The network
server default shutdown time-out value is used.</p>
<p><strong><em>2-45</em></strong></p>
<p>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.</p>
<p></p>
<p></p>
<p><strong><u>Text
'description' (TEXT)</u></strong></p>
<p></p>
<p>Specifies the text that briefly
describes the objects created by this command.</p>
<p></p>
<p><strong><u>*BLANK</u></strong></p>
<p>Text
is not specified.</p>
<p><strong><em>character-value</em></strong></p>
<p>Specify no more
than 50 characters of text, enclosed in apostrophes.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Configuration
file (CFGFILE)</u></strong></p>
<p></p>
<p>Specifies the source file that contains
configuration data, to be used in activating or further defining the server.</p>
<p></p>
<p><strong>Single
values</strong></p>
<p></p>
<p><strong><u>*NONE</u></strong></p>
<p>No configuration file is
specified.</p>
<p></p>
<p><strong>Qualifier 1: Configuration file </strong></p>
<p></p>
<p><strong><em>name </em></strong></p>
<p>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.</p>
<p></p>
<p><strong>Qualifier 2: Library</strong></p>
<p></p>
<p><strong><u>*LIBL</u></strong></p>
<p>All
libraries in the job's library list are searched until the first match is
found.</p>
<p><strong>*CURLIB</strong></p>
<p>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.</p>
<p><strong><em>name</em></strong></p>
<p>Specify the name of the library to
be used.</p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><strong><u>Virtual PTP Ethernet port
(VRTPTPPORT)</u></strong></p>
<p></p>
<p>Specifies the TCP/IP configuration for the
virtual point-to-point Ethernet port.</p>
<p></p>
<p><strong>Notes:</strong></p>
<p></p>
<p>1.
The VRTPTPPORT parameter must be used for Integrated xSeries servers running
on the host system. </p>
<p>2. 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.</p>
<p></p>
<p><strong>Element 1: Internet address</strong></p>
<p></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>
<p></p>
<p><strong><u>*GEN </u></strong></p>
<p>Specify
*GEN to let the INSLNXSVR command configure a virtual point-to-point Ethernet
port with a generated internet address. </p>
<p><strong><em>character-value</em></strong> </p>
<p>Specify
the host internet address for the virtual point-to-point Ethernet port in
the form, xxx.yyy.zzz.nnn, where xxx, yyy, zzz, and nnn 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 xxx.yyy.zzz value
in the internet address must match the xxx.yyy.zzz value for the internet
address of the Linux server side of the point-to-point Ethernet port.</p>
<p></p>
<p><strong>Element
2: Linux internet address</strong></p>
<p></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>
<p></p>
<p><strong><u>*GEN</u></strong></p>
<p>Specify
*GEN to let the INSLNXSVR command configure a virtual point-to-point Ethernet
port with a generated internet address.</p>
<p><strong><em>character-value</em></strong></p>
<p>Specify
the Linux server internet address for the virtual point-to-point Ethernet
port in the form, xxx.yyy.zzz.nnn, where xxx, yyy, zzz, and nnn 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 xxx.yyy.zzz
value in the internet address must match the xxx.yyy.zzz value for the internet
address of the host side of the point-to-point Ethernet port.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzau9startos400install.htm" title="This topic describes the installation of Linux initiated from an i5/OS command line.">Starting the installation from i5/OS</a></div>
</div>
</div>
</body>
</html>