gx-convert-log - Convert a requests.log file from a previous version
gx-convert-log -help
gx-convert-log -version
gx-convert-log [options] [files]
gx-convert-log, part of the gx-map system, is an administrative command. It reads an existing requests.log file, possibly from an older release of the gx-map system. It writes to stdout a requests.log file compatible with the current release of gx-map.
Option processing is done using the Perl Getopt::Long module.
Options may be specified with a single or double leading '-' character. Option names may be abbreviated to whatever is unique. Arguments may be separated either by a blank or by an '=' character. For example, ``-foobar 42'', ``--foobar=42'', and ``-foob 42'' would all be equivalent.
The gx-convert-log command is used to help in upgrading from an older version of gx-map. The format of the requests.log file has changed between the 0.4.X and 0.5.X series of releases; using gx-convert-log, you can convert your old log to the new format and use it in the new installation.
It also allows you to change the set of users recognized as administrators. The recommended practice is to define a single administrative account, preferably not a user account. The ``globus'' account is often a good choice, or you can create a dedicated ``gxmap'' account. The -old-admins and -new-admin options give you an opportunity to replace any existing administrative accounts with a single account. If you want to leave the administrative accounts alone, you don't need to use these options.
If you're not sure which accounts were configured as administrative accounts in your old installation, you can use the gx-admins command (q.v.).
After running the gx-convert-log command, you can optionally use gx-cleanup-logs to delete or comment out any redundant requests.
An alternative to using gx-convert-log is to use gx-ingest (q.v.) to read an existing grid-mapfile, translating it into a sequence of gx-request commands (from which a new requests.log file is generated). One disadvantage of this approach is that it loses much of the audit trail information from the old requests.log file.
gx-map(7), gx-map-requests-log(5), gx-cleanup-logs(8)
Keith Thompson, San Diego Supercomputer Center, <kst@sdsc.edu>
See the file LICENSE in the gx-map distribution, installed in the etc/gx-map subdirectory.