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 ]

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

−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, specifying 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:

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. 

SEE ALSO

bootparams(4)

SunOS 5.5.1  —  Last change: 10 Jan 1996