admpackage(1M) DG/UX 5.4R3.00 admpackage(1M)
NAME
admpackage - manage DG/UX-style software packages
SYNOPSIS
admpackage -o load [ -qv ] [ -r release-area ] [ -f release-medium ]
[ package ... ]
admpackage -o setup [ -F ] [ [ -r release-area ] [ -c client-list ] [
package ... ]
admpackage -o install [ -qv ] [ -r release-area ] [ -f release-medium
] [ -c client-list ] [ package ... ]
admpackage -o list [ -qvR ] -f release-medium
admpackage -o list [ -qv ] [ -r release-area ] [ package ... ]
admpackage -o list [ -qv ] -c client-list [ -r release-area ]
DESCRIPTION
admpackage is used for loading and performing necessary setup of
DG/UX packages. All software products that come from Data General
for the AViiON series computers are considered to be DG/UX packages.
The software release format is a superset of that used for SunOS 4.0.
Operations
load Load the specified package(s) from the release-medium into
a release area on the disk. If no packages are specified
on the command line, then all packages on the release-
medium will be loaded.
setup Execute the package's setup script(s), stored in the
specified release area, to prepare the package for use. If
no packages are specified, then all packages that have not
previously been set up will be set up.
install This operation combines the load and setup operations into
a single step. Note that all packages will first be
loaded, then all packages will be set up. If a package
does not have setup scripts, then no action will be taken
for the setup step.
list The list operation has three forms. In the first form,
distinguished by the -f option, the operation will list to
the standard output the packages which exist on the
specified release-medium. For the second form, if no
options are specified, or only a release area is specified,
then the operation will list to the standard output the
packages which have been installed in a given release area.
A package is considered to be installed when it has been
loaded and set up. In the final form, distinguished by the
-c option, the operation will list packages that are loaded
but require set up for the specified list of operating
system clients. You may use MYHOST or the output from
Licensed material--property of copyright holder(s) 1
admpackage(1M) DG/UX 5.4R3.00 admpackage(1M)
hostname(1C) for the client list if you want to list
packages on your host that require set up. For all forms
of this operation, the -q option is automatically enabled
unless the -v option is specified.
Options
-f release-medium
Specify the medium from which the packages will be loaded.
The default release-medium is obtained through
admdefault(1M). The medium may be the name of a tape
device or a directory.
-F Force setup for packages that have been set up already.
Use of this option is potentially dangerous. You should
use this option only when instructed to do so by the
package's documentation. When -F is specified, the package
or packages to be set up must be listed on the command
line.
-r release-area
Specify the release area into which the package is to be
(or was) installed. The default release area is PRIMARY.
-c client-list
Specify the list of operating system clients for which the
package is to be set up. This list must be a
comma-separated list of clients that are served by your
host. The default client list is MYHOST.
-q Quiet. Print minimal information about the files on the
system or the release-medium.
-v Verbose. Print detailed information about the files on the
system or release-medium.
-R Print release information for the release-medium itself in
addition to information about the files on the release-
medium.
Loading from Disk
The release-medium value may be a disk directory name instead of a
tape device name. When this is the case, admpackage expects to find
a table of contents file named 1.xdrtoc in that directory. This file
is the same file that would appear as the second file on a
distribution tape, and contains names of other images. These other
images must also appear in the disk directory with filenames composed
of the ``tape'' file number, a period, and the image name from the
table of contents file. For example, if the table of contents file
says that file 4 has the image ``tcpip__r.base'', then the directory
should contain a file named 4.tcpipr.base.
DIAGNOSTICS
Warnings
- The load operation is requested and the tape contains a file
Licensed material--property of copyright holder(s) 2
admpackage(1M) DG/UX 5.4R3.00 admpackage(1M)
load destination that is not /, or a part of /usr or /opt.
- The load operation is requested and admpackage was unable to
update the root prototype directory.
- The load operation is requested and the database file for the
client being updated is missing.
- The setup operation is requested and the setup script failed.
The setup script should provide more specific information
regarding the failure.
Errors
- admpackage is unable to read or manipulate the release-medium.
- The release-medium does not contain a table of contents.
- admpackage is unable to create necessary temporary files. The
root file system is probably out of space.
- The table of contents found on the tape is in an invalid
format.
- The specified release-area does not exist or is invalid. The
user must create a release area before loading packages into
that release area (see admrelease(1M)).
Exit Codes
This section lists the possible exit codes and what they mean.
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
NOTES
Superuser privilege is required for all operations except list.
For all of the operations that optionally take a package argument,
the key word all may be used to perform the operation on all of the
available packages.
SEE ALSO
admclient(1M), admdefault(1M), admrelease(1M), admtape(1M),
sysadm(1M).
Licensed material--property of copyright holder(s) 3