SYNOPSIS

       /usr/openv/netbackup/bin/vxlogmgr { -d | -c | -m | -F}  [-a]  -f  Abso-
              luteDir

       /usr/openv/netbackup/bin/vxlogmgr  {-c | -m | -A filename} -f Absolute-
              Dir [-p ProductID] [-o OriginatorID] [-n  Days]  [-t  Time]  [-b
              Date] [-e Date] [-q] [-z]

       /usr/openv/netbackup/bin/vxlogmgr  {-c | -m | -A filename} -f Absolute-
              Dir -w QueryString [-q] [-z]

       /usr/openv/netbackup/bin/vxlogmgr {-d | -F |  -s}  [-p  ProductID]  [-o
              OriginatorID] [-n Days] [-t Time] [-b Date] [-e Date] [-q] [-z]

       /usr/openv/netbackup/bin/vxlogmgr  {-d  |  -F | -s} -w QueryString [-q]
              [-z]

       /usr/openv/netbackup/bin/vxlogmgr -h

       /usr/openv/netbackup/bin/vxlogmgr -v


DESCRIPTION

       The vxlogmgr utility manages the log files generated  by  unified  log-
       ging-enabled applications. Log file management includes actions such as
       deleting or moving the log files that are based on log management  con-
       figuration settings.

       Unified  logging  uses  a  standardized naming format for log files, as
       follows:

       productID-originatorID-hostID-date-rotation.log

       For more information about the unified logging naming format,  and  the
       logging  originator  IDs,  refer to the NetBackup Troubleshooting Guide
       for UNIX, Windows, and Linux.


OPTIONS

       Specify the log management action to perform.

       -A, --arch FileName
                  Creates an archive named FileName for the specified  set  of
                 conditions. The compressed zip file requires WinZip and wzzip
                 on Windows to produce a zip file. On UNIX, a tar utility  and
                 GnuZip are required to produce a tar.gzip file.

       -a, --auto
                  Retrieves the log files that are based on individual config-
                 uration settings for NumberOfLogFiles. The actions are  taken
                 based  on  the  given  action  type  (such  as move, copy, or
                 delete). When the -a option is specified, the  other  options
                 cannot be used.
                  Manages the log files created up to the specified date.  The
                 Date format is set from the current locale at run-time and is
                 locale-specific.  NOTE: Use single quotes for in option.

       -f, --dir AbsoluteDir
                  Specify the absolute name of the directory  into  which  the
                 log  files  are  to be copied. This option is valid only with
                 the -c option.

       -F, --flush

                 Deletes all log files for the host originating  this  command
                 except  the most current log file. If the host that runs this
                 command uses a shared directory, all log files for all  hosts
                 that  use  the  same directory will be removed. Only the most
                 current file is perserved for the host  that  originated  the
                 flush command.

       -h, --help

                 Lists  and  describes  the command-line options available for
                 this command.

       -m, --mv   Moves log files from the folder that  the  product  that  is
                 configured to the specified folder.

       -n --days NumberOfDays


                 Manage  the  log  files created in last NumberOfDays days for
                 the specified action

       -o, --origid OriginatorID
                  Manage the log files identified by  a  given  originator  ID
                 (OriginatorID).

       -p, --prodid ProductID
                   Manage the log files identified by a given product ID (Pro-
                 ductID) for the specified action. Instead of  an  identifier,
                 the user can provide the product name.

       -q, --quiet

                 Do not display any messages; quiet mode.

       -s, --vw   View the log files for a given query.

       -t, --tail hh:mm:ss
                  Manage the log files for the last hh:mm:ss hours.

       -v, --version

       0          Successful completion.

       -1        An error occurred.


QUERY STRINGS

       A  query  string  is  a  text  expression,  similar to a database WHERE
       clause, that is used to retrieve log entries from the  unified  logging
       system.  The  expression is a combination of relational operators, con-
       stant integers, constant strings, and names of log fields that evaluate
       to  a  single value. Logical operators, such as AND and OR, are used to
       group expressions.

       Supported relation operators include:

              <         Less than

              >         Greater than

              <=       Less than and equal to

              >=      Greater than and equal to

              =         Equal to

              !=        Not equal to

       Supported logical operators include &&  (logical  AND)  and  ||
       (logical OR).

       Predefined log fields include:

              PRODID        Product identifier (integer or string)

              ORGID           Originator identifier (integer or string)

              STDATE        Locale-specific start date (long integer or string
              [such as `mm/dd/yy'])

              ENDATE       Locale-specific end date (long  integer  or  string
              [such as `mm/dd/yy'])

              PREVTIME   Previous time (string [hh:mm:ss])


EXAMPLES

       Example 1

       The  following  automatically  moves the older log files that NetBackup
       created to the folder /tmp/nblogs. The --auto  option  depends  on  the
       configuration setting NumberOfLogFiles.

               vxlogmgr -m --auto --dir /tmp/nblogs


       The following copies the log files created from date 01/22/07  by  Net-
       Backup:

               vxlogmgr -c --where "(prodid = NB) && (stdate >= '01/22/07')"
               --dir /usr/openv/logs

       Example 5

       The  following  copies  the  log  files  created  between  10/10/06 and
       10/28/06 inclusive by product ID 100:

               vxlogmgr -c --where "(PRODID == 100) && ((STDATE >= '10/10/06')
               && (ENDATE <= '10/28/06'))" --dir /usr/openv/logs


SEE ALSO

       vxlogview(1), vxlogcfg(1)





                                  22 Mar 2007                     vxlogmgr(1M)