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

instl_adm(1M) instl_adm(1M)
default file system and software configuration that is selectable during an
install. This file is referenced by the INDEX file on the media. On an Ignite-
UX server, there may be numerous configuration files referenced by the INDEX
file.
−T Tests for proper syntax of all the configuration files listed in the INDEX file, as
well as the configuration file data in the first 8K of the *INSTALLFS file
(when no -f or -D option is given). The INDEX file to use may be changed
using the -i option. If the -f option is given, only the supplied file is
checked for syntax. If the -D option is given, not only is the syntax of the con-
figuration file associated with the given client directory checked, but runs
through a set of sanity checks to determine its validity. See FILES below for
the location of the INDEX and *INSTALLFS files. instl_adm no longer
treats uninitialized integer variables as an error. That functionality has been
moved to instl_dbg -l.
-i index_file Used with the -T option to specify an alternate INDEX file to be read for the
list of configuration files that are checked for syntax.
-D client_directory
Used with the -T option causes detailed configuration checks to be run against
the configuration for the specified client. This may be used to ensure the
client’s configuration has a good chance of installing successfully. This option
may only be used after the client has been booted and has created the data files
in the respective client_directory. The client_directory is of the form
/var/opt/ignite/clients/0xLLA.
−b Clears any previous configuration values set.
-? Displays the help screen.
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 envi-
ronment variables. Help text and some command output not parsed by Ignite-UX will be left in the user’s
specified locale.
RETURN VALUE
instl_adm returns 0 (zero) value if the operation was successful, and returns a non-zero value if either a
failure occurred or if the configuration file has syntax errors.
EXAMPLES
Display the current message and defaults:
instl_adm -d
Test the syntax of all the configuration files listed in the INDEX file:
instl_adm -T
Test the configuration of a client for any problems:
instl_adm -T -D /var/opt/ignite/clients/0xLLA
Change the message contents of file new_message while leaving the current network defaults in place:
instl_adm -a new_message
Install new default parameters for the default gateway and netmask. The −d option will cause the informa-
tion to be displayed after installation:
instl_adm -d -g 192.168.48.1 -m 255.255.248.0
Extract the current default configuration, edit it, and reinstall the new configuration:
instl_adm -d > /tmp/cfg
3