add_new_client(1M)

add_new_client(1M)

NAME

 

add_new_client - add a client to an Ignite-UX server

 

SYNOPSIS

[-Rrelease_name ] [ -f] [ -d] [ -n]

/opt/ignite/bin/add_new_client -s Ignite-UX_Server

[ -?]

 

DESCRIPTION

add_new_client is used to construct a client directory on an Ignite-UX server without requiring the

client to be booted from the Ignite-UX server ®rst.

A aA

 

The add_new_client command must be executed on the client and requires privileged user permis- sion. (See the privileges (5) manpage for more information on the privileged user.) The /var/opt/ignite/clients directory must be exported from the Ignite-UX server with the appropriate permissions so that the client may mount the directory using NFS. For help exporting the client directory from the server, see the Exporting the Client Directory section.

add_new_client mounts /var/opt/ignite/clients from the Ignite-UX server. It then performs a series of commands which result in the construction of required information ®les under the client directory (/var/opt/ignite/clients/OxLLA). These ®les are primarily io.info, hw.info, host.info, and config.sys along with several other ®les, which are used by the Ignite-UX server to recognize and manage the client. Once add_new_client has successfully executed, ignite (5) may be invoked on the Ignite-UX server and used to perform additional actions on the client.

If you do not have this command installed on the client, here are two possible ways to obtain it. The ®rst is to simply rcp or ftp the add_new_client command directly to the client. If you elect to use this method be sure to note the DEPENDENCIES section of the manpage and pull the additional supporting commands too.

The second method is to use swinstall to install the required ®lesets onto the the client. For example:

swinstall -s source_depot Ignite-UX.RECOVERY Ignite-UX.MGMT-TOOLS

Options

add_new_client recognizes the following options:

-sIgnite-UX Server

Speci®es the host name of the Ignite-UX server on which the client directory is constructed.

-Rrelease_name

Speci®es the release that you intend to install on the client. By default the value of uname -ris used as the target OS release. This option is also useful when the Ignite-UX server does not support the OS release that the client is currently running.

-fInstructs add_new_client to overwrite existing client information ®les found in the /var/opt/ignite/clients/0xLLA directory. This option is intended to be used to refresh the contents of the client directory. The previous contents are not preserved.

-dInstructs add_new_client to use the fully quali®ed host name of the client for the client_name .

-nInstructs add_new_client to use NFS as the default ®le sharing service instead of tftp for the load®le. Check DEPENDENCIES section for load®le.

-?Display the help screen.

Exporting the Client Directory

On the server, the client's directory may be exported as follows:

For 11.31 or later, edit /etc/dfs/dfstab to add following entry:

share -F nfs -o anon=2 /var/opt/ignite/clients

For other releases, edit /etc/exports to add the following entry:

/var/opt/ignite/clients -anon=2

For 11.31 or later, run the shareall command to have the edits to the exports ®le take effect:

/usr/sbin/shareall -F nfs

For other releases, run the exportfs command to have the edits to the exports ®le take effect:

HP-UX 11i Version 3: March 2012

− 1 −

Hewlett-Packard Company 1