swcluster(1M)

NAME

swcluster − install or remove software from diskless server

SYNOPSIS

swcluster [XToolkit Options] [-v][v] [-i] [-p] [-f] [-r] [-b] [-l list_class] [-n] [-s source]
[-C session_file] [-S session_file] [-x option=value] [-X option_file] [software_selections] [ @ target_selections]

DESCRIPTION

The swcluster command launches SD commands such as swinstall and swremove to install or remove software from a HP-UX 10.* NFS diskless cluster. The swcluster command may only be run on a diskless server or a stand alone system, not on a client. On stand alone systems, swcluster operates in interactive mode only.

swcluster can be run in install mode, which causes software to be installed to a diskless server and its clients, in remove mode, which removes non kernel software from a cluster and its clients, or in list mode, which lists various parameters of an NFS diskless cluster.

Install Mode
In install mode, swcluster installs software from a software source, which must be a valid SD depot, to the local diskless server. If the selected software does not require a kernel build, this software is then installed to the diskless clients, and all the clients which are booted will then mount the software from the server and run the swconfig command to configure the software. If the software does require a kernel build, then the diskless clients will be halted. As part of the software installation to the server, the server will rebuild its kernel and reboot. After the server boots and runs configure scripts, a server RC script will run swcluster again, installing the software to the diskless clients. These clients must then be turned on by hand, at which time they will boot and configure the software.

Remove Mode
In remove mode (using the -r flag), swcluster only supports the removal of non kernel software from clusters. When non kernel software is removed, swcluster first contacts all booted clients and unconfigures the software. It then removes the software from the clients, and lastly, from the server. Clients which are not currently booted or are not accessible will not have the software unconfigured.

Both install and remove modes support the -n flag, which causes swcluster to skip the installation or removal of the software from the diskless server. This is useful, for example, if the software is already installed on the server and simply needs to be propagated to the clients.

In all modes, swcluster is normally silent in the absence of warnings or errors. Using the -v flag causes status messages to be printed during operation. More than one flag (i.e. -vvv ) may be used to generate more verbose output. Up to 4 -v flags are meaningful.

Options

swcluster recognizes the following options:

-f software_file The parameter specifies a file from which to read software selections. Not valid in interactive (-i) mode.

-i Invoke the command in interactive mode. Software selections are read using a graphical user interface and need not be specified on the command line. If -i is used, the -s, -S, and -f options are invalid.

-p Preview operation only. Operations which change the state of the system (such as installs, removals, /etc/fstab modifications, etc.) are not performed. However, other analyses, such as the determination of the client nodes, happen normally.

-r Operate in removal mode. In this mode software is removed from the cluster instead of being installed.

-b Forces a shutdown of all clients even if non-kernel software is being installed.

-l Display information about a cluster. List_class can be one of:

shroot Lists shared roots.

prroot Lists private roots.

clients Lists all clients

booted_clients Lists booted clients only.

bundle @ <root> Lists bundles on root.

product @ <root> Lists products on root.

subproduct @ <root> Lists subproducts on root.

fileset @ <root> Lists filesets on root.

-s source The next parameter specifies the software source for install operations. If the -n option is used, -s is not needed, since the source is always set to the local diskless server’s installed software.

-n Skips installation or removal of the software to or from the server. This can be used to propagate software already on the diskless server to the clients.

-x option=value Propagates the given option to the SD swinstall or swremove commands used to perform the install or removal task.

-C session_file Save the current options and operands to session_file. You can enter a relative or absolute path with the file name. The default directory for session files is /.sw/sessions/. You can recall a session file with the -S option.

-S session_file Reads options from sessionfile, including the software source and software selections. You can save session information to a file with the -C option.

EXAMPLES

Install the UUCP software package from a depot source on hpdepot named /release/10.0 to the local S700 diskless cluster, using very verbose output:

swcluster -vvv -s hpdepot:/release/10.0 UUCP @
/

Remove the UUCP software package from the local HP Series 700 diskless cluster using very verbose output:

swcluster -vvv -r UUCP @
/

Install the UUCP software package to the local diskless clients, given that UUCP is already installed on the diskless server:

swcluster -vvv -n UUCP @
/

AUTHOR

swcluster was developed by HP.

FILES

/var/adm/sw/swinstall.log Log files from swinstall commands.

/var/adm/sw/swremove.log Log files from swremove commands.

/var/adm/sw/swcluster.log Log files from swcluster commands.

/var/adm/sw/swagent.log Log files from swagent commands.

/sbin/init.d/swcluster Cluster install startup script.

/etc/bootptab Control file for bootpd (see bootpd(1M)) that contains most of the client information returned by dcnodes

Museum

Related Articles