installsrv(1M) installsrv(1M)
NAME
installsrv - configure a server to be a UnixWare Install
Server
SYNOPSIS
installsrv -q
installsrv -e|-u [-n spx|tcp]
installsrv -l as|pe -d device -c spool|mount [-L locale]
installsrv -l as|pe -s server [-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.
Alternatively, the UnixWare Desktop provides a graphical
interface for managing an Install Server. To invoke the
graphical interface, from the UnixWare Desktop select the
"Admin Tools" icon followed by the "Install Server" icon. For
details, see the section ``Setting Up and Administering an
Install Server'' in the chapter ``Installing Add-On Software''
of part ``System Setup and Configuration'' of the book System
Administration.
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 Application 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 Application
Server is currently configured as an Install
Server: TCP/IP and/or IPX/SPX.
Copyright 1994 Novell, Inc. Page 1
installsrv(1M) installsrv(1M)
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 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 as|pe
loads an installable image of either the Application
Server (as) or the Personal Edition (pe). Other systems
on the network can then perform network installations of
UnixWare using this installable image of the Personal
Edition or Application Server.
Copyright 1994 Novell, Inc. Page 2
installsrv(1M) installsrv(1M)
If the -l option is specified, then either but not both
the -d option or -s option must also be specified.
-d device
specify a device from which to load the installable
image of the Application Server or the Personal Edition.
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 either the
Application Server or the Personal Edition.
If the -s option is specified, then the -l must also be
specified. You may not use both the -s and -d options.
-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.
Copyright 1994 Novell, Inc. Page 3
installsrv(1M) installsrv(1M)
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 Application Server from a cartridge tape:
installsrv -l as -d ctape1 -c spool
Load the Personal Edition from the server myhost:
installsrv -l pe -s myhost
REFERENCES
pkgcat(1M), pkgcopy(1M), pkginfo(1), pkginstall(1M),
pkglist(1M), pkgtrans(1)
Copyright 1994 Novell, Inc. Page 4