HP HP-UX Manpages User's Guide

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

-? ]

[

DESCRIPTION

add_new_client

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

add_new_client

The sion. (See the privileges (5) manpage for more information on the privileged user.) The

/var/opt/ignite/clients

ate permissions so that the client may mount the directory using NFS. For help exporting the client directory from the server, see the

add_new_client

forms a series of commands which result in the construction of required information ﬁles under the client directory (

/var/opt/ignite/clients/OxLLA

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

command must be executed on the client and requires privileged user permis-

directory must be exported from the Ignite-UX server with the appropri-

Exporting the Client Directory

mounts /var/opt/ignite/clients

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 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 method be sure to note the commands too.

The second method is to use

rcp or ftp the add_new_client

DEPENDENCIES section of the manpage and pull the additional supporting

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:

-s Ignite-UX Server

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

-R release_name

Speciﬁes the release that you intend to install on the client. By default the value of

-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 ﬁles found in the

/var/opt/ignite/clients/0x

refresh the contents of the client directory. The previous contents are not preserved.

-d Instructs add_new_client to use the fully qualiﬁed host name of the client for the

client_name .

-n Instructs 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:

Ignite-UX_Server [

). These ﬁles are primarily io.info, hw.info,

command directly to the client. If you elect to use this

-R release_name ][-f ][-d ][-n

section.

from the Ignite-UX server. It then per-

has successfully executed, ignite (5) may be

uname

LLA directory. This option is intended to be used to

]

AaA

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

AaA

add_new_client(1M) add_new_client(1M)

/usr/sbin/exportfs -av

International Code Set Support

Ignite-UX uses a variety of system commands to accomplish its functionality. Because the output of many of these commands is parsed, Ignite-UX ensures that the POSIX locale is normally used by modifying environment variables. Help text and some command output not parsed by Ignite-UX will be left in the user’s speciﬁed locale.

RETURN VALUE

add_new_client

corresponding client directory on the Ignite-UX server. A non-zero value is returned if any problem occurs.

EXAMPLES

Initialize the client using the speciﬁed Ignite-UX server:

add_new_client -s

Initialize the client and overwrite existing contents of the client directory on the Ignite-UX server:

add_new_client -s

Initialize the client using the speciﬁed Ignite-UX server, for target OS release B.11.23:

add_new_client -s Ignite-UX_Server

Initialize the client using the speciﬁed Ignite-UX server to use NFS as the default ﬁle sharing service for the loadﬁle :

add_new_client -s Ignite-UX_Server

will exit with a status of 0 (zero) if the client was able to successfully initialize its

Ignite-UX_Server

-f

-R B.11.23

-n

FILES

/opt/ignite/boot/Rel_ /opt/ignite/boot/Rel_ /opt/ignite/boot/Rel_ /opt/ignite/boot/Rel_

PA-RISC 32-bit, PA-RISC 64-bit (V class), PA-RISC 64-bit (non V class), and Itanium-based ﬁle systems used by install clients. Conﬁguration information available at client boot-time is stored in the ﬁrst 8KB of these ﬁles. These are the default ﬁles

/var/opt/ignite/clients/0x

File that contains the hardware model and system name of the client.

/var/opt/ignite/clients/0x

File containing hardware information about the client such as any information about the hard drives, tape drives, LAN devices, etc. This ﬁle will be deprecated in a future release and is being replaced by the

io.info ﬁle.

release /INSTALLFS release /VINSTALLFS release /WINSTALLFS release /IINSTALLFS

LLA/host.info

LLA/hw.info

/var/opt/ignite/clients/0xLLA/io.info

File containing hardware information about the client such as any information about the hard drives, tape drives, LAN devices, etc.

/var/opt/ignite/clients/0xLLA/config.sys

File that contains the system information about the clients such as IP address, system name, etc.

/var/opt/ignite/clients/0xLLA/client_name

File that contains the name of the client.

/var/opt/ignite/clients/0xLLA/client_status

File containing information about the status of each of the client addition steps.

instl_adm modiﬁes.

DEPENDENCIES

lanscan (1M)

/opt/ignite/lbin/loadfile

/opt/ignite/lbin/rescan_hw_host

2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: March 2012

+ 2 hidden pages