Ignite-UX Reference (March 2010, B3921-90005)

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 ]
[ -? ]
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 appro-
priate 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 con-
structed.
-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/0xLLA 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.
-? 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
1