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(TM) Install Server (an Install Sever allows remote installation of UnixWare onto other systems in a TCP/IP or IPX/SPX(TM) 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 RIGHT ARROW 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(TM)/Sequenced Packet eXchange(TM) (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.