installsrv(1M)
installsrv --
configure a server to be a UnixWare Install Server
Synopsis
installsrv -q
installsrv -e|-u [-n spx|tcp]
installsrv -l image -d device -c spool|mount [-L locale]
installsrv -l image -s server [-p product_name] [-L locale]
Description
The installsrv command is the command-line interface for managing a
UnixWare
Install Server (an Install Sever allows remote installation of
UnixWare onto other systems in a TCP/IP or IPX/SPX
network).
This command provides options for querying the configuration,
enabling and disabling the service,
and for staging software for other systems to install.
The preferred way of setting up an installation server is to use
the graphical Install_Server command, by entering
/usr/X/bin/Install_Server from a graphical terminal window
or selecting
Software Management
Install Server
from the SCOadmin launcher.
For details,
see
``Setting up and administering an install server''.
Flags
The -q option may be used by any user;
however,
only root may use the other options.
- -q
-
queries the Install Server and writes the following to standard output:
-
-
The network protocol(s) that are configured on this Install Server:
Transmission Control Protocol/Internet Protocol (TCP/IP) and/or
Internetwork Packet eXchange
/Sequenced Packet eXchange
(IPX/SPX).
-
-
The network protocol(s) for which this UnixWare system is currently
configured as an Install Server:
TCP/IP and/or IPX/SPX.
-
-
The software that is available (staged) on this Install Server for network
installation by other systems on the network.
If -q is specified then none of the other options can be used.
- -e
-
enables the Install Server:
-
-
The -n option may be used with the -e option to specify which
networking protocol (TCP/IP or IPX/SPX) is enabled for network installation.
If a connection cannot be made using this protocol on the
system running installsrv,
as defined in the /etc/netconfig file (see
netconfig(4bnu)),
installsrv exits.
-
-
If the -n option is not used,
and if both TCP/IP and IPX/SPX are configured on the system,
then network installation is enabled for both protocols.
- -u
-
disables the Install Server:
-
-
The -n option may be used with the -e option to specify which
networking protocol (TCP/IP or IPX/SPX) is disabled for network installation.
-
-
If the -n option is not used,
and if both TCP/IP and IPX/SPX are configured on the system,
then network installation is disabled for both protocols.
- -n spx|tcp
-
specifies which networking protocol (TCP/IP or IPX/SPX) is enabled/disabled for
network installation from this Install Server.
If the -n option is specified,
either the -e (enable) or -u (disable) option must also be
specified.
If -n is specified more than once,
the action (enable/disable) is applied for both networking protocols.
- -l image
-
Loads an installable image of the UnixWare operating system. The images
necessary for a complete installation of UnixWare 7 are
UnixWare, BaseWeb, doc,
arcserve, and winsrvcs.
Other systems on the network can then perform network installations
of UnixWare using these installable images.
If the -l option is specified,
then either the -d or -s options must also be
specified.
- -d device
-
specify a device from which to load an installable image.
The device specification may be a device alias (such as
ctape1 or cdrom2) for any cartridge tape or CD-ROM
device configured on your system.
If you specify a device alias and no entry exists in the device
table for this alias,
installsrv aborts.
If the -d option is specified,
then both the -l and -c options must also be specified.
You may not use both the -d and -s options.
- -c spool|mount
-
The -c option selects whether the installable image of UnixWare on
the media (CD-ROM or cartridge tape) is spooled to the Install Server's
hard drive or mounted as a file system.
Any valid device may be spooled but only a CD-ROM device can be mounted.
If the -c option is specified,
then both the -l and -d options must also be specified.
- -s server
-
specify another,
already configured Install Server from which to load an installable image of
the UnixWare operating system.
If the -s option is specified,
then the -l must also be specified.
You may not use both the -s and -d options.
- -p product_name
-
specifies the product name of the product you are serving.
- -L locale
-
specifies a locale other than that set in your environment's LANG
environment variable.
If -L is not specified and LANG is not set in your environment
then the installsrv command fails.
If you plan to support network installation for clients whose locales
differ from your native locale,
you must load installable product images for each of these locales using
the -L option.
Exit codes
When invoked with the -q option,
installsrv returns the number of networking interfaces for which
the Install Server is enabled.
When invoked with any options other than -q,
an exit status of 0 indicates success and a non-zero value indicates that
installsrv did not complete successfully.
Diagnostics
Each session (on both the server and client side) generates a log which
is appended to the system-wide logfile /var/sadm/dist/log after
completion.
Optionally,
the session log is mailed to root.
Usage
Examples
Enable the Install Server service for TCP/IP networking:
-
-
installsrv -e -n tcp
Disable the Install Server service:
-
-
installsrv -u
Load the UnixWare operating system from the first CD-ROM:
-
-
installsrv -l UnixWare -d cdrom1 -c spool
Load the UnixWare operating system from the server myhost:
-
-
installsrv -l UnixWare -s myhost
-
-
References
pkgcat(1M),
pkgcopy(1M),
pkginfo(1),
pkginstall(1M),
pkglist(1M),
pkgtrans(1)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.