package administration

Package Administration

The internal and external sites are populated from the master PACKAGEROOT directory raptor:/home/gsf. The sites are maintained by the admin(1), package(1), post(1), external(1) and htmlrefs(1) commands. To update the sites:

master PACKAGEROOT administration is done from this directory
```
     cd $PACKAGEROOT/lib/package/admin
```
update the VERSION file to reflect the default packages and release date

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 | less -p "^(==>).*"

run the regression tests
```
     admin --test
```
check the test results
```
     admin --regress
```

     admin --results --failed --test | less -p "^(==>|TEST).*"

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
```
- check the package generation results
```
     admin --results --failed --generate | less
```
- remove old binaries
```
     admin --clean
```
- check the generated binaries
```
     admin --check
```
- update the internal web site
```
     admin --post
```
- update /usr/common/ast by following the instructions from
```
     admin --common
```
To update the stage and external web sites:
- surf http://www.research.att.com/sw/download/
- check for internal seepage into ~/www/download/@(make|test).*.html
- update the stage site
```
     admin --stage
```
- surf http://akstage.research.att.com/sw/download/
- update the public site
```
     admin --public
```
- surf http://akpublic.research.att.com/sw/download/
- mail ast-users # to announce the posting
```
     admin --announce
```

November 09, 2004