pkginstall(1M) pkginstall(1M)
NAME
pkginstall - install software from a server onto a target host
SYNOPSIS
pkginstall [-v] [-N] [-n tcp|spx] -s source package
DESCRIPTION
The pkginstall command provides a software installation
mechanism within a distributed TCP/IP or IPX/SPX network.
This command is typically used after software is staged on a
UnixWare Install Server. For details on setting up and
administering an Install Server, 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 or see
installsrv(1M).
Flags
-v turns on verbose output mode and causes additional
description of pkginstall events to be written to the
/var/sadm/dist/log log file.
-n tcp|spx
Specifies the preferred networking protocol.
If the -n option is used, pkginstall attempts a network
connection between the target and source hosts using the
requested networking protocol (-n tcp for TCP/IP and -n
spx for IPX/SPX). If a connection cannot be made using
the requested protocol, pkginstall exits.
If the -n option is not used, pkginstall attempts a
network connection between the target and source hosts
using the first available protocol (TCP/IP or IPX/SPX).
If a connection cannot be made using this protocol,
pkginstall exits.
-N Specifies non-interactive mode. By default, interactive
mode is used. If the installation requires user
interaction while running in non-interactive mode, the
installation halts. See pkgadd(1M) for details.
-s source
specifies the software source for the copy. The format
for the source location is either:
Copyright 1994 Novell, Inc. Page 1
pkginstall(1M) pkginstall(1M)
host[:device] or [host:]device
where:
host is the name or Internet address (IP) of the host
where the package(s) to be distributed reside.
When the host argument is omitted, the local host
(the system where pkginstall is invoked) is
assumed.
If the host IP address is given then TCP/IP
networking must be used. This can be accomplished
by either including -n tcp on the command line or
by having only TCP/IP and not IPX/SPX available on
your system.
device
indicates the device or directory where the
software that is being copied resides.
Alternatively, the device argument may be a file
containing a data stream in pkgadd format. The
full path name of the device (for example,
/dev/rmt/c0s0), directory, or file must be used.
package
lists the software package to be distributed, where
package is the package short package name as returned by
the pkginfo(1) command.
If the path specified in the source is a device or file
containing a data stream in pkgadd format, then the
package parameter may be omitted. If the package option
is omitted, you are prompted for which set(s) or
package(s) you want to copy from that data stream.
This feature works the same as in pkgtrans(1), which is
the underlying mechanism used by pkginstall to copy
software.
Output
pkginstall messages are written to the /var/sadm/dist/log log
file.
Exit Codes
The pkginstall command exits with one of the following values:
Copyright 1994 Novell, Inc. Page 2
pkginstall(1M) pkginstall(1M)
0 Success
101 Usage error
102 Bad system call
103 No such file or directory
104 No such file or directory on server
105 No file permissions
106 Bad network connection
107 Protocol was misused
108 Invalid option specified
109 Invalid host in location specification
110 Execution was interrupted by user
111 Invalid source specification
112 Invalid target specification
113 Data stream closed by client
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. The session log is also
mailed to root.
USAGE
Examples
Install the terminf package from the myhost system onto the
local host:
pkginstall -s myhost: terminf
Using the IPX/SPX protocol, install the terminf package from
the myhost system onto the local host.
Copyright 1994 Novell, Inc. Page 3
pkginstall(1M) pkginstall(1M)
pkginstall -n spx -s myhost: terminf
Install all the packages from the cartridge tape on the myhost
system onto the local host:
pkginstall -s myhost:/dev/rmt/ctape1 all
REFERENCES
installsrv(1M), pkgcat(1M), pkgcopy(1M), pkginfo(1),
pkglist(1M), pkgtrans(1)
Copyright 1994 Novell, Inc. Page 4