pkginstall(1M)

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, see ``Setting up and administering an install server'' or the manual page for 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 on the system running pkginstall, as defined in the /etc/netconfig file (see netconfig(4bnu)), 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 on the system running pkginstall, as defined in the /etc/netconfig file (see netconfig(4bnu)), 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:

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 (that is, the IP address of the Install Server). 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 source directory is a directory containing package(s), then you must specify the package option. If the source device is a package datastream, then you do not need to specify the package option. 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:

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.

: 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)