admin - package admin wrapper

admin provides a single interface for package administration. Operations include making, testing, localizing, packaging, and posting to the web. If no action options are specified then admin.db is listed. admin only runs in the $PACKAGEROOT/lib/package/admin directory.

admin is controlled by several input files that provide default values for repeated operations.

VERSION

A sh(1) file that specifies default values for the following shell variables:

ANNOUNCE

The --announce mail group address.

BETA

The packages named by --beta.

DIALECTS

The default dialects updated by --catalog. The default is chef,fudd,piglatin,valley.

EXTERNAL

These packages will be posted to the internal and external download web sites.

HOST

The internal url host name. The default is silk.research.att.com.

HOST_PUBLIC

The public url host name. The default is public.research.att.com.

HOST_STAGE

The stage url host name. The default is silk-stage.research.att.com.

IMPORT

These packages have tarballs that are imported from other systems and are not to be generated on the local system.

INTERNAL

These packages be posted to the internal download web site only.

SAVE

The packages named by --save.

SOURCE

These packages are source only.

TITLE

The software title for the --announce message.

USER

The url cgi user name. The default is the user name of the caller.

VERSION

The YYYY-MM-DD for the current base.

VERSION_BETA

The YYYY-MM-DD for the beta base.

VERSION_PRESERVE

A space-separated list of package::YYYY-MM-DD to preserve for --clean-* operations. package- matches all packages with package- as a prefix. package * matches all packages and YYYY-MM-DD * matches all versions.

WWW

The external url host name. The default is www.research.att.com.

WWWLOCAL

Local directory for internal server files. If not defined then files may only be accessed from $HOST.

admin.db

A table of local hosts and architectures used by the admin action of the package(1) command.

post.db

A sh(1) file of post(1) functions that describes the files and packages to be posted to the download web site.

-a, --all

Equivalent to --make --locale --binary --source --force --post.

-A, --log

Append terminal output to admin.log. On by default; -A means --nolog.

-B, --base

Generate new base archives. By default delta archives on the previous base are generated.

-Q, --beta

Operate on the BETA packages.

-b, --binary

Generate binary package archives in ../tgz.

-c, --catalog

Generate and update local message catalogs and html man pages.

-q, --check

Check generated --binary tarballs. By default only current architectures in admin.db are checked. --force checks all previously generated architectures.

-K, --clean-binary

Clean out binary packages in ../tgz by removing all but the most recent release.

-j, --clean-download

Clean out /home/gsf/wwwfiles/download/tgz tarballs, removing all but the most recent and preserved releases.

-X, --columns=columns

Print --list output in columns columns.

-W, --cygwin

Local and remote steps required to generate cygwin.i386 components.

--debug

Enable debug diagnostics.

-d, --ditto

Run package admin ditto.

-f, --failed

List only failed --results.

-F, --force

Force --catalog and --post actions to ignore timestamps.

-g, --generate

List the package generation results.

-G, --git

Sync private ast git repositories to the internal and external www.

-h, --html

Update html --post files and copy to the internal site.

-H, --hosts=host

Limit remote actions to the space and/or colon separated host list.

-I, --onall

Execute the command line (all operands) on all hosts. The following shell variables are available to the command:

h

The host name.

a

The host architecture.

r

The host remote access: s for ssh(1)/scp(1), r for rsh(1)/rcp(1).

-k, --kick

Kick NFS to freshen up stale file handles -- puke.

-l, --list=op

List op information:

admin

List admin.db. This is the default if no actions are specified.

architectures

List the architecures in admin.db.

hosts

List the hosts in admin.db.

remote

List the remote host type access for each host. access is r for rsh and s for ssh. If --only is specified then only one host per type is listed.

-Y, --local

Generate local --post files but to not post(1).

-L, --locale

Operate on the *-locale packages for the specified packages.

-m, --make

Run package admin make.

-M, --announce

Mail a www posting announcement to ast-users.

-n, --show

Show admin actions but do not execute.

-N, --SHOW

Passes --show, show or -n, as appropriate, to wrapped commands.

-o, --only

Operate only on the specified packages. By default a package closure is generated.

-O, --official

Operate on the INTERNAL and EXTERNAL packages.

-e, --patch

Generate a delta2patch(1) patch on the standard output of the latest delta tarball from its base for each package operand.

-p, --post

Post binary packages and download web pages using admin-post(1).

-P, --public

Copy external web pages from the internal site to the public site.

-y, --regress

Compare --test results with previous. Results are stored in the regress.log directory.

-R, --remote-actions

List boilerplate actions to take on remote hosts.

-r, --results

List --make results for the host name operands or all hosts if there are no operands. If --test is also specified then an rt(1) summary of test results is listed.

-U, --runtime

Generate runtime binary base package archives in ../tgz. --base and --only are also set.

-s, --source

Generate source package archives in ../tgz.

-S, --save

Generate the SAVE source package archives in ../lcl.

--stage

Copy external web pages from the internal site to the stage site.

-t, --test

Run package admin test.

-T, --targets=targets

Optional --make targets.

--trace

Enable sh -x tracing.

-u, --update

Update local --post files but do not copy to the internal site.

-w, --uwin

Local and remote steps required to generate win32.i386 components.

-v, --release|version=YYYY-MM-DD

Set the current --base package release version.

-i, --wwwman

Update html man pages in /home/gsf/wwwfiles/man.

-D, --wwwstatic

Generate cgi-bin static ast commands in bin/wwwstatic.tgz.

-x, --etxtbsy

Remove all ETXTBSY files. These files are copied during installation to avoid clobbering running programs/dlls on stateless filesystems.

-z, --leadlag

Extract filesystem timestamp lead/lag messages from the file operands. If no file operands are specified then make.log/* is assumed.

-Z, --tst

Write tst packages (no source copyright prepended).

The typical development cycle is:

# generate base source packages for beta testing in ../tgz
admin --base --source --beta
# or delta source packages for beta testing in ../tgz
admin --source --beta
# make the local executables
admin --make
# check the make results
admin --results --failed | z
# run the regression tests
admin --test
# check the test results
admin --regress
# or
admin --results --failed --test | z
# or
rt -f - test.log/*

The typical packaging steps are:

# generate the locale message catalogs
admin --catalog
# generate base locale, source and binary packages in ../lcl, ../tgz
admin --base --save --locale --source --binary --official
# or delta locale, source and binary packages in ../lcl, ../tgz
admin --save --locale --source --binary --official
# generate astksh cygwin.i386 packages and --static-link standalone
admin --show --cygwin
# check the package generation results
admin --results --failed --generate | z
# make sure the source package(s) build in at least one empty vanilla environment
vanilla; bin/package read; bin/package make
# make sure the source package(s) build against the previous release
vanilla; export PATH=/prev/ast/bin:$PATH; bin/package read; bin/package make
# remove old binaries
admin --clean-binary
# check the generated binaries
admin --check
# update the internal web man pages
admin --wwwman
# update the internal web site with the latest release source/binaries
admin --post --base
# or update the internal web site with the latest release source
admin --post --base --source
# remove old download tarballs
admin --clean-download

To update the stage and external web sites:

# update the internal and stage www git repositories
admin --git
# surf http://silk.research.att.com/sw/download/
# check for internal seepage into /home/gsf/wwwfiles/download/@(make|test).*.html
# update the stage site
admin --stage
# update the public site
admin --public
# surf http://public.research.att.com/sw/download/
# mail ast-users # to announce the posting
admin --announce

admin-external(1), admin-man(1), admin-post(1), package(1)

version

admin (AT&T Research) 2012-06-27

author

Glenn Fowler <gsf@research.att.com>

copyright

Copyright © 2000-2012 AT&T Intellectual Property

license

http://www.eclipse.org/org/documents/epl-v10.html