A Comprehensive List of NetBackup (Tm) 6.0 Directories and Commands Relating to Unified Logging. (2)

Embed Size (px)

Citation preview

  • 7/27/2019 A Comprehensive List of NetBackup (Tm) 6.0 Directories and Commands Relating to Unified Logging. (2)

    1/4

    Problem

    DOCUMENTATION: A comprehensive list of NetBackup (tm) 6.0 directories and commands

    relating to Unified Logging.

    Solution

    Manual: VeritasNetBackup (tm) 6.0 Troubleshooting Guide for UNIX and Windows, page(s):

    74 - 87

    Modification Type: Supplement

    Modification:

    NetBackup 6.0 introduces a new style of logging called Unified logging. This new style of

    logging is used by NetBackup 6.0 NetBackup Intelligent Resource Manager (IRM), EnterpriseMedia Manager (EMM) services as well as other NetBackup options. Unified logging is also

    used by other Symantec products as well. The previous style of NetBackup logging is now

    referred to as Legacy logging and is still used by other NetBackup daemons. The following is acomprehensive list of NetBackup 6.0 directories and commands relating to Unified Logging.

    Refer to TechNote 243778 in the "Related Documents" section below, for information on

    NetBackup Legacy logging.

    Different levels of VERBOSEUnified logging stores the verbose levels in the /usr/openv/netbackup/nblog.conf file. While

    this is a text file, it is not recommended to modify this file with a text editor. The vxlogcfgcommand should be used modify the global logging level, or the overrides for individual

    processes (known as originators).

    The vxlogcfg requires several options to configure VERBOSE logging.

    First is the "-a" or "--add" option to add a value. The "-a" option can also be usedto modify existing values in the nblog.conffile.

    The "-p" or "--prodid" is used to set the values for the NetBackup product(ProductID 51216). The "-o" or "--orgid" is used to set the default value or to override the defaultsetting for a specific originator. Refer to TechNote 279564 for additional information

    on using this switch.

    Finally, the "-s" or "--setting" needs to be used to specify the values to bechanged.

  • 7/27/2019 A Comprehensive List of NetBackup (Tm) 6.0 Directories and Commands Relating to Unified Logging. (2)

    2/4

    To set the maximum logging level for all daemons run:

    # cd /usr/openv/netbackup/bin

    # ./vxlogcfg -a -p 51216 -o Default -s DebugLevel=5 -s DiagnosticLevel=5

    Note: For servers with high logging levels and lots of activity, the vxlogview command can takea long time to complete. This delay will be more noticeable the further back the query has to

    search.

    To return to the default level of logging for all daemons run:

    # cd /usr/openv/netbackup/bin

    # ./vxlogcfg -a -p 51216 -o Default -s DebugLevel=1 -s DiagnosticLevel=1

    To disable logging for all daemons run:

    # cd /usr/openv/netbackup/bin

    # ./vxlogcfg -a -p 51216 -o Default -s DebugLevel=0 -s DiagnosticLevel=0

    After setting these options run vxlogcfg -p 51216 -o Default -l to verify the change is in

    place. No process restart is needed for changes to Unified Logging to take affect.

    Note: This will not list any overrides for specific originators. To check for overrides run the

    command:# grep DebugLevel /usr/openv/netbackup/nblog.confDefault.DebugLevel=5116.DebugLevel=2

    The output will list the Default setting as well as any overrides for a specific originator ID. This

    example shows an override set for originator ID 116 (nbpem). If only Default is displayed thenno overrides have been set.

    Configuration Files used with Unified Logging

    Unified logging is meant to work NetBackup as well as other products. As a result, there aredifferent configuration files used with Unified logging.

    The /etc/vx/vrtslog.conffile stores a list of Product Id's that are configured to useUnified logging. This will contain entries for NetBackup as well as other products

    such as the VERITAS Shared Infrastructure Services (VxICS) or the VERITAS File

    System (VxFS). This file will not need to be modified when configuring UnifiedLogging for NetBackup.

  • 7/27/2019 A Comprehensive List of NetBackup (Tm) 6.0 Directories and Commands Relating to Unified Logging. (2)

    3/4

    The /usr/openv/netbackup/nblog.conf file stores a listing of Originator ID's usedby NetBackup. This is the primary file that will be modified with vxlogcfg to

    configure Unified logging for NetBackup.

    Commands used with Unified Logging

    There are three primary commands used with Unified logging. These are:

    vxlogview - This command is used to view the Unified log files. The vxlogviewcommand allows the administrator to search by process (also known as an

    originator), Job ID, timeframe, etc. to display only the log entries needed to help

    isolate a problem.

    vxlogcfg - This command is used to configure Unified logging settings such ashow many days to keep logs, when to rotate log files as well as other settings.

    vxlogmgr - This command is used to manage Unified log files and can be used tomove or delete logs. This can also be used to upload logs to a directory which can

    then be sent to Symantec Enterprise Technical Support for analysis.

    There are additional Unified Logging commands called vxloggen and vxlogadmin. These areused by the VERITAS Shared Infrastructure Services to control Unified Logging at the Product

    ID level and are not needed to configure Unified logging for NetBackup.

    Directories used with Unified Logging

    The /usr/openv/logs directory on the Master/EMM server stores log files. Unlike Legacylogging, no directories need to be created for Unified logging to take effect. By default logging

    is enabled at the lowest level and can be adjusted as needed using thevxlogcfg

    command.

    The format for the file names stores in the /usr/openv/logs directory is as follows:

    ----.log

    The for NetBackup is 51216. A list of Product Id's can be found in the

    /etc/vx/vrtslog.conffile.

    The will indicate what process the log is for. A list of Originator Id's can befound in the /usr/openv/netbackup/nblog.conf file.

    The indicates the host ID of the machine.

  • 7/27/2019 A Comprehensive List of NetBackup (Tm) 6.0 Directories and Commands Relating to Unified Logging. (2)

    4/4

    The indicates the date of the log and is in YYMMDD format.

    The is used to rotate the logs to control log size and disk space usage.

    The /etc/vx directory on the Master/EMM server stores product level configurations forNetBackup and other products such as the Infrastructure Common Services.

    Daemons that use Unified Logging

    A listing of processes and originators that use Unified logging include, but are not limited to:

    NetBackup Policy Execution Manager (nbpem)NetBackup Job Manager (nbjm)

    NetBackup Resource Broker (nbrb)NetBackup Enterprise Media Manager (nbemm)NetBackup Service Layer (nbsl)NetBackup Generic Job (nbgenjob)NetBackup Notification Service (nbnos)NetBackup for NDMP and ndmpagentNetBackup avrd and robotic processesNetBackup Operations Monitor (NOMTRS, NOMClient and NOMServer) Bare Metal Restore daemons (bmrd, bmbbd, bmrc, bmrs, bmrconfig,bmrsavecfg, bmrsrtadm, bmrprep, bmrsetupmaster, bmrsetupboot, bmrpkg,

    bmrcreatepkg, bmrcreatefloppy.exe, bmrrst.exe and bmrmap.exe)

    VERITAS Private Branch Exchange (VxPBX)

    Daemons that continue to use Legacy loggingA listing of daemons that use Legacy logging include, but are not limited to:

    NetBackup Master Server daemons (bprd, bpdbm, bpjobd, bpdbjobs, admin)NetBackup Media Server daemons (bpbrm, bptm, bpdm)NetBackup Robotic daemons (vmd, avrd, ltid and robotic daemons)NetBackup Client daemons (bpcd, bpbkar, tar)

    For assistance with viewing Unified log files check the NetBackup 6.0 Troubleshooting Guide

    for UNIX and Windows. TechNote 278059 in the Related Documents section below alsocontains examples for using the vxlogview command to view Unified log files.