admrelease(1M) DG/UX 5.4R3.00 admrelease(1M)
NAME
admrelease - manage software release areas
SYNOPSIS
admrelease -o create [ -g share-directory ] [ -r root-directory ] [
-s swap-directory ] [ -u usr-directory ] release-area
admrelease -o delete release-area ...
admrelease -o list [ -qv ] [ -f format ] [ release-area ... ]
DESCRIPTION
The admrelease command is used to manipulate software release areas.
A release is a collection of software packages intended for a
specific architecture and operating system. Multiple versions of the
operating system software or application packages can be installed on
a single machine by using several independent release areas. A
release area is a directory tree which contains the host-independent
portion of a release (the /usr part) as well as a prototype of the
host-specific part (the root). When client machines are associated
with a release, the host-specific prototype is copied to a private
portion of the release area reserved for use by that host, and the
host-independent portion is shared with other clients.
The PRIMARY release area is created automatically and cannot be
deleted. This release area usually holds the main operating system
on servers and stand-alone machines. Other releases are secondary.
They have identifying names and other attributes assigned by the
system administrator during the create operation
After a release area is created, software can be loaded into it using
admpackage(1M). Client machines are associated with a release area
using admclient(1M).
Operations
create Construct a new release area. This construction involves
making several directory trees. A release area name must
be specified, as well as pathnames to be used for /usr
software, client roots, client swap files, and shared
software.
delete Erase files and remove the directory trees associated with
a release area that was created by the create operation.
The PRIMARY release area cannot be deleted. Release areas
that are still in use cannot be deleted. (Use the
admclient's delete operation to disassociate client
machines from a release area.)
list Provide information about release areas. If release area
names are given, all the information about a release is
displayed, including its directory structure and installed
packages. If all is specified instead of a release area
name, a short list of all release areas and their /usr
directories is displayed, or just the release area names
Licensed material--property of copyright holder(s) 1
admrelease(1M) DG/UX 5.4R3.00 admrelease(1M)
are displayed if the -q option is used too.
Options
Options recognized by the create operation are:
-g share-directory
The name of the directory for shared software. If not
specified, the default is /srv/share.
-r root-directory
The name of the directory for the clients' root directory
parent. If not specified, the default is
/srv/release/release-area/root. The root (host-specific)
directory for a client will be named for the client and
appear under this directory.
-s swap-directory
The name of the directory for clients' swap space. If not
specified, the default is /srv/swap. A file for each
client, named for the client, will be created under this
directory to serve as the client's swap area.
-u usr-directory
The name of the directory for the /usr file system. If not
specified, the default is /srv/release/release-area/usr.
The prototype of the host specific portion of the release
will eventually get loaded into the root.proto directory
under this directory.
Options recognized by the list operation are:
-f format Select the list format. Possible values are
long All information about release areas (default except
when listing all release areas).
short Release area name and /usr directory root (default
when listing all release areas).
names List only the names of release areas.
clients List only the clients of the indicated release areas.
packages List only the packages that have been installed in the
indicated release areas.
-q Quiet. Do not include header lines.
-v Verbose. When used with all, a header line is displayed.
EXAMPLES
To create a new release area named version2 with the default
directory structure, use
admrelease -o create version2
Licensed material--property of copyright holder(s) 2
admrelease(1M) DG/UX 5.4R3.00 admrelease(1M)
FILES
/srv/release/release-area Release area root
/srv/admin/releases Release database
OUTPUT
The list operation writes to stdout. The long format shows the
directory structure, installed packages, and attached clients. The
short format shows only the release area name and the name of the
/usr file system for each release. Other formats show only the
information requested.
DIAGNOSTICS
Warnings
Attempts to delete a release area that does not exist are indicated
and the operation on that release area is skipped.
Errors
It is not possible to delete the PRIMARY release area or a release
area which still has clients associated with it.
It is an error to add a release area that already exists.
Exit Codes
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
The /srv directory structure must be established appropriately before
admrelease or admpackage can function. Both commands will check the
directory structure and establish the /srv directory tree if
necessary.
Only the superuser may use the create and delete operations.
SEE ALSO
admclient(1M), admpackage(1M), sysadm(1M).
Installing the DG/UX System, Managing the DG/UX System.
Licensed material--property of copyright holder(s) 3