accounts-master command

Run the accounts-master program to process the changes

IncludeSponsorsDataRunAccountsMaster

Note: everyone who runs the sponsor_resources command should be aware that it is really just a portion of the accounts-master command. If only one procedure needed to be chosen, the correct thing to do is run accounts-master, not sponsor_resources. That is, the "correct procedure" is 1) edit sponsors data, 2) run accounts-master, 3) run accounts-client. accounts-master does a superset of what sponsor_resources does. Usually, however, after editing sponsors data, sponsor_resources alone is sufficient. However, in some cases, for example if you have added a new course reference under the REGISTRAR directory, accounts-master must be run instead.

accounts-master updates that data under /software/accounts-master/data/sponsors/REGISTRAR/ wnich is automatically maintained, and then combines that with the rest of the /software/accounts-master/data/sponsors/ data to produce per-user requirements in per-machine (actually per-region) files under /software/accounts-master/data/resources. Along the way, it might detect errors in the changes you made. Fix any problems that are reported and keep rerunning accounts-master until all errors have gone away. Some errors will have fixed themselves in the same run.

Here is an example of a "bad run":

@cscf[140]% accounts-master
[1] 28152
Submitted job (arpepper)
=== Starting make_all_accounts === Fri Feb  4 15:29:39 EST 2011
FYI: /software/accounts-userids/data/Userids has 255659 entries
=== Building user lists for Sponsors database === Fri Feb  4 15:29:41 EST 2011
FYI: 0 errors, 0 warnings, 0 notes
=== Extracting data from Sponsors database === Fri Feb  4 15:29:44 EST 2011
Fatal error: /software/accounts-master/data/sponsors/Research/@1 line 0: no sponsor information
=== Creating userid lists === Fri Feb  4 15:29:48 EST 2011
=== Giving cs grad student quotas on ljp_cs === Fri Feb  4 15:29:53 EST 2011
=== Creating advisor .reginfo lists === Fri Feb  4 15:29:53 EST 2011
=== Making .classlist files === Fri Feb  4 15:29:56 EST 2011
=== Distributing .classlist files === Fri Feb  4 15:29:58 EST 2011
=== Making Man Pages === Fri Feb  4 15:31:16 EST 2011
=== Making HTML Pages === Fri Feb  4 15:31:16 EST 2011
=== Spreading man pages to student and research machines === Fri Feb  4 15:31:25
 EST 2011
*** make_all_accounts finished *** Fri Feb  4 15:35:19 EST 2011
@cscf[141]%

In this case, accounts-master complained someone accidentally left a file named @1 with inappropriate contents in the sponsors data directories.

@cscf[140]% accounts-master
[1] 17829
Submitted job (arpepper)
=== Starting make_all_accounts === Fri Feb  4 17:08:44 EST 2011
FYI: /software/accounts-userids/data/Userids has 255659 entries
=== Building user lists for Sponsors database === Fri Feb  4 17:08:46 EST 2011
FYI: 0 errors, 0 warnings, 0 notes
=== Extracting data from Sponsors database === Fri Feb  4 17:08:48 EST 2011
Error: /software/accounts-master/data/sponsors/Research/Terry line 76: Userid 'bjlafren' is not a standard userid
=== Creating userid lists === Fri Feb  4 17:08:55 EST 2011
=== Giving cs grad student quotas on ljp_cs === Fri Feb  4 17:09:01 EST 2011
=== Creating advisor .reginfo lists === Fri Feb  4 17:09:02 EST 2011
=== Making .classlist files === Fri Feb  4 17:09:05 EST 2011
=== Distributing .classlist files === Fri Feb  4 17:09:08 EST 2011
=== Making Man Pages === Fri Feb  4 17:09:46 EST 2011
=== Making HTML Pages === Fri Feb  4 17:09:46 EST 2011
=== Spreading man pages to student and research machines === Fri Feb  4 17:09:56 EST 2011
*** make_all_accounts finished *** Fri Feb  4 17:13:50 EST 2011
@cscf[141]%

In this case, accounts-master complained because we used the short version of the userid ("bjlafren"), but it always requires the long version (ie: "bjlafreniere").

This is an example of a "good run":

@cscf[143]% accounts-master
[1] 8336
Submitted job (arpepper)
=== Starting make_all_accounts === Fri Feb  4 16:24:39 EST 2011
FYI: /software/accounts-userids/data/Userids has 255659 entries
=== Building user lists for Sponsors database === Fri Feb  4 16:24:41 EST 2011
FYI: 0 errors, 0 warnings, 0 notes
=== Extracting data from Sponsors database === Fri Feb  4 16:24:44 EST 2011
=== Creating userid lists === Fri Feb  4 16:24:51 EST 2011
=== Giving cs grad student quotas on ljp_cs === Fri Feb  4 16:24:56 EST 2011
=== Creating advisor .reginfo lists === Fri Feb  4 16:24:56 EST 2011
=== Making .classlist files === Fri Feb  4 16:25:01 EST 2011
=== Distributing .classlist files === Fri Feb  4 16:25:03 EST 2011
=== Making Man Pages === Fri Feb  4 16:25:38 EST 2011
=== Making HTML Pages === Fri Feb  4 16:25:38 EST 2011
=== Spreading man pages to student and research machines === Fri Feb  4 16:25:47 EST 2011
*** make_all_accounts finished *** Fri Feb  4 16:29:40 EST 2011
@cscf[144]%

As its output indicates, accounts-master also performs other useful tasks, such as verifying the Userids file, and updating .classlist files in the home directorys of course accounts. Unfortunately some of those tasks take rather a long time (you can see over five minutes elapsed time in the examples), and so people tend to directly use sponsor_resources in its place, since that is usually sufficient.

Path to the "accounts-master" command

If you don't happen to have the maintenance commands in your path, the path to the accounts-master command is:
/software/accounts-master/maintenance/accounts-master

-- AdrianPepper - 04 Feb 2011

---

See Also

• accounts-client command
• sponsor_resources command

IncludeAdrianReferers

Referers

This topic IncludeSponsorsDataRunAccountsMaster is referred to by...

• IncludeSponsorsDataRunAccountsClient
• IncludeSponsorsDataRunSponsorResources
• SponsorsDataAccounts
• TemplateSponsorDataAccountsCollapsed