add_new_client.1m (2012 03)

a
add_new_client(1M) add_new_client(1M)
NAME
add_new_client - add a client to an Ignite-UX server
SYNOPSIS
/opt/ignite/bin/add_new_client -s
Ignite-UX_Server [
-R release_name ][-f ][-d ][-n
]
[
-? ]
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 first.
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 appropri-
ate 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 per-
forms a series of commands which result in the construction of required information files under the client
directory (
/var/opt/ignite/clients/OxLLA
). These files are primarily io.info, hw.info,
host.info, and config.sys along with several other files, 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 first
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 filesets 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:
-s Ignite-UX Server
Specifies the host name of the Ignite-UX server on which the client directory is constructed.
-R release_name
Specifies the release that you intend to install on the client. By default the value of
uname
-r is 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.
-f Instructs add_new_client to overwrite existing client information files found in the
/var/opt/ignite/clients/0x
LLA directory. This option is intended to be used to
refresh the contents of the client directory. The previous contents are not preserved.
-d Instructs add_new_client to use the fully qualified host name of the client for the
client_name .
-n Instructs add_new_client to use NFS as the default file sharing service instead of tftp for
the loadfile. Check DEPENDENCIES section for loadfile.
-? 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 file take effect:
/usr/sbin/shareall -F nfs
For other releases, run the exportfs command to have the edits to the exports file take effect:
HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1