Man Pages (1MTSOL): Maintenance and Administration Commands
  Search only this book
Download this book in PDF

NAME

install_scripts, add_install_client, rm_install_client, setup_install_server, check - scripts used to install the Solaris software

SYNOPSIS

cdrom-mnt-pt/add_install_client [ -i IP_address ] [ -e Ethernet_address ]
     [ -s server_name: path] [ -c server_name: path] [ -T server_name: path]
     [ -n [server]:name_service[(netmask)]] host_name platform_name
cdrom-mnt-pt/rm_install_client host_name
cdrom-mnt-pt/setup_install_server [ -b ] install_dir_path
cdrom-mnt-pt/check [ -p ] [ -r rulesfile ] install_dir_path

AVAILABILITY

SUNWcdrom (Solaris CD)

DESCRIPTION

These commands are located on the Solaris CD in the /cdrom/cdrom0/s0 directory. (If the Solaris CD has been copied to a local disk, these scripts will be in the path to that directory.) They can be used for a variety of installation tasks. Specifically,
Use add_install_client and rm_install_client to add or remove clients for network installation.
Use setup_install_server to copy the Solaris CD to a disk or to copy just the boot software of the Solaris CD to a disk (for instance, to set up a boot server).
Use check to validate the rules in a rules file (this is only necessary if a custom JumpStart installation is being set up).

OPTIONS

The following options are supported:

add_install_client

-i IP_address
Specify the IP address of the client to be installed.
-e Ethernet_address
Specify the Ethernet address of the system to be installed.
-s server_name:path
This option is required only when using add_install_client from a boot server. Specify the name of the server and the absolute path of the Solaris installation image that will be used for this installation. path is either the path to a mounted Solaris CD or a path to a directory with a copy of the Solaris CD.
-c server_name: path
This option is required only to specify a JumpStart directory for a custom JumpStart installation. server_name is the host name of the server with a JumpStart directory. path is the absolute path to the JumpStart directory.
-T server_name: path
This option is used to specify a Trusted Solaris configuration directory for a network or JumpStart installation. server_name is the host name of the server with a Trusted Solaris configuration directory. path is the absolute path to the Trusted Solaris configuration directory.
-n [server]:name_service[(netmask)]
This option specifies which name service should be used during system configuration. This sets the 'ns' bootparams(4) keyword.
name_service
           Valid entries are 'nis', 'nisplus', and 'none'.

server
The name of the server or IP address of the specified
name service. If the server specified is on a different
subnet, then the netmask may be needed to enable to
client to contact the server.
netmask
A series of four numbers separated by periods, specify-
ing which portion of an IP address is the network part,
and which is the host part.

rm_install_client

-b
This option sets up the server only as a boot server.

check

-p install_dir_path
Specifies the absolute path to the Solaris installation image (either the mounted Solaris CD-ROM or a copy of the Solaris CD-ROM on the local disk). Using this option ensures that the most recent check program is being used to validate the rules file.
-r rulesfile
Specifies a rules file other than the one named rules. Using this option, the validity of a rule can be tested before integrating it into the rules file. check will report whether or not the rule is valid, but it will not create the rules.ok file necessary for a custom
JumpStart installation.

OPERANDS

The following operands are supported:

add_install_client

host_name
This is the name of the client to be installed.
platform_name
Vendor-defined grouping of hardware platforms for the purpose of distributing specific software. Examples of valid platform names are:
SystemPlatform Name
x86i86pc
SPARCstation 1+sun4c
SPARCstation LXsun4c
PowerPCprep

rm_install_client

host_name
This is the name of the client to be removed.
platform_name
Vendor-defined grouping of hardware platforms for the purpose of distributing specific software. (See previous list for valid arguments.)

setup_install_server

install_dir_path
Specify the absolute path of the directory in which the Solaris software is to be copied.
platform_name
Vendor-defined grouping of hardware platforms for the purpose of distributing specific software.

EXAMPLES

The following add_install_client commands add clients for network installation from a mounted Solaris CD on an install server.
example# cd /cdrom/cdrom0/s0
example# ./add_install_client system_1 sun4c
example# ./add_install_client system_2 i86pc

The following add_install_client commands add clients for network installation from a mounted Solaris CD on an install server. The -c option specifies a server and path to a JumpStart directory that has a rules and profile files for performing a custom JumpStart installation.
example# cd /cdrom/cdrom0/s0
example# ./add_install_client -c install_server:/jumpstart system_1 sun4c
example# ./add_install_client -c install_server:/jumpstart system_2 i86pc

The following rm_install_client commands remove system information about the named clients on the install server.
example# cd /cdrom/cdrom0/s0
example# ./rm_install_client holmes
example# ./rm_install_client watson

The following setup_install_server command copies the mounted Solaris CD to a directory named /export/install on the local disk. (This requires approximately 200 Mbytes of disk space.)
example# cd /cdrom/cdrom0/s0
example# ./setup_install_server /export/install

The following setup_install_server command copies the boot software of a mounted Solaris CD to a directory named /boot_dir on system that is going to be a boot server for a subnet. The command must be entered once for each client architecture to be installed on the subnet.
example# cd /cdrom/cdrom0/s0
example# ./setup_install_server -b
example# ./setup_install_server -b

The following check command validates the syntax of the rules file used for a custom JumpStart installation.
example# cd jumpstart_dir_path
example# ./check -p /cdrom/cdrom0/s0

EXIT STATUS

The following exit values are returned:
0
Successful completion.
1
An error has occurred.

SUMMARY OF TRUSTED

The -T option is added to the add_install_client script to allow the specifying of Trusted Solaris configuration information during network or JumpStart installations. The other scripts are unaltered.

SOLARIS CHANGES

SEE ALSO

bootparams(4)