NetBackup™ 10.1 Application Guide

Last Published:
Product(s): Appliances (2.1.4, 2.1.3, 2.1.2, 2.1.1)
Platform: Flex Appliance OS
  1. Product overview
    1.  
      Introduction to NetBackup applications for Flex Appliance
    2.  
      About the Flex Appliance documentation
  2. Release notes
    1.  
      NetBackup 10.1 application new features, enhancements, and changes
    2.  
      Supported upgrade paths to this release
    3.  
      Operational notes
  3. Geting started
    1.  
      Prerequisites before you can create NetBackup application instances
    2.  
      Installing the NetBackup Administration Console and client packages
  4. Creating NetBackup application instances
    1. Creating application instances
      1.  
        Creating a NetBackup primary server instance
      2.  
        Creating a NetBackup media server instance
      3.  
        Creating a NetBackup WORM storage server instance
  5. Managing NetBackup application instances
    1.  
      Managing application instances from Flex Appliance and NetBackup
    2. Accessing NetBackup primary and media server instances for management tasks
      1. Managing users on a primary or media server instance
        1.  
          Adding and removing local users on a primary or media server instance
        2.  
          Connecting an Active Directory user domain to a primary or a media server instance
        3.  
          Connecting an LDAP user domain to a primary or a media server instance
        4.  
          Changing a user password on a primary or media server instance
      2. Running NetBackup commands on a primary or media server application instance
        1.  
          Creating a NetBackup touch file on a primary or media server application instance
        2.  
          Installing NetBackup notify scripts on a primary or media server application instance
      3.  
        Monitoring NetBackup services on a NetBackup primary server instance
      4.  
        Mounting an NFS share on a NetBackup primary server instance
      5.  
        Setting environment variables on primary and media server instances
      6.  
        Storing custom data on a primary or media server instance
      7.  
        Modifying or disabling the nbdeployutil utility on a primary server instance
      8.  
        Disabling SMB server signing on a media server instance
      9.  
        Establishing trust with a NetBackup 7.7.3 primary server instance
      10.  
        Using a primary server instance for disaster recovery
    3. Accessing NetBackup WORM storage server instances for management tasks
      1. Managing users from the deduplication shell
        1.  
          Adding and removing local users from the deduplication shell
        2.  
          Adding MSDP users from the deduplication shell
        3.  
          Connecting an Active Directory domain to a WORM storage server for Universal Shares and Instant Access
        4.  
          Disconnecting an Active Directory domain from the deduplication shell
        5.  
          Changing a user password from the deduplication shell
      2.  
        Managing VLAN interfaces from the deduplication shell
      3.  
        Viewing the lockdown mode on a WORM storage server
      4.  
        Managing the retention policy on a WORM storage server
      5.  
        Managing images with a retention lock on a WORM storage server
      6.  
        Auditing WORM retention changes
      7. Managing certificates from the deduplication shell
        1.  
          Viewing the certificate details from the deduplication shell
        2.  
          Importing certificates from the deduplication shell
        3.  
          Removing certificates from the deduplication shell
      8.  
        Managing FIPS mode from the deduplication shell
      9.  
        Encrypting backups from the deduplication shell
      10. Configuring an isolated recovery environment on a Flex Appliance WORM storage server instance
        1.  
          Configuring data transmission between a production environment and a Flex Appliance IRE
      11.  
        Managing an isolated recovery environment on a Flex Appliance WORM storage server instance
      12.  
        Tuning the MSDP configuration from the deduplication shell
      13.  
        Setting the MSDP log level from the deduplication shell
      14. Managing NetBackup services from the deduplication shell
        1.  
          Managing the cyclic redundancy checking (CRC) service
        2.  
          Managing the content router queue processing (CRQP) service
        3.  
          Managing the online checking service
        4.  
          Managing the compaction service
        5.  
          Managing the deduplication (MSDP) services
        6.  
          Managing the Storage Platform Web Service (SPWS)
        7.  
          Managing the Veritas provisioning file system (VPFS) mounts
        8.  
          Managing the NGINX service
        9.  
          Managing the SMB service
      15. Monitoring and troubleshooting NetBackup services from the deduplication shell
        1.  
          About the support command

About the support command

The support command lets you access and upload the relevant logs and configuration files for troubleshooting.

The following table describes the options and arguments for the support command.

Table: The options and arguments for the support command.

Option and its description

Argument

Description

MSDP-history

Access the MSDP history files.

tail

Append the last 10 lines of each file to standard output.

This command requires the following parameters:

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

collect

Collect files for transferring to the target host.

This command requires the following parameters:

  • mmin

    Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15.

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*.

  • mtime

    Finds files that are modified n*24 hours ago. Same as mtime option in find command. For example, 2, +2, -2.

ls

List information about the FILEs.

Use the dir parameter to enter the directory name.

scp

Securely transfer selected files to the target host.

This command requires the following parameters:

  • scp_port

    Specifies the port to connect to on the remote host.

  • scp_target

    Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.

cat

Concatenate files and print on the standard output.

Use the file parameter to enter the file name.

grep

Print lines that match patterns.

This command requires the following parameters:

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*. This is a required parameter.

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

process

Displays information about the MSDP processes.

MSDP-process

Display the MSDP processes.

htop

Display the CPU and memory information.

atop

Display information about the operating system.

pidstat

Display the PID statistics.

memory-usage

Displays the free and used memory.

software

Displays information about the software.

show-MSDP-version

Display the MSDP version.

show-OS-version

Display the operating system information.

MSDP-log

Access the MSDP log files.

tail

Append the last 10 lines of each file to standard output.

This command requires the following parameters:

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

collect

Collect files for transferring to the target host.

This command requires the following parameters:

  • mmin

    Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15.

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*.

  • mtime

    Finds files that are modified n*24 hours ago. Same as mtime option in find command. For example, 2, +2, -2.

ls

List information about the files.

Use the dir parameter to enter the directory name.

scp

Securely transfer selected files to the target host.

This command requires the following parameters:

  • scp_port

    Specifies the port to connect to on the remote host.

  • scp_target

    Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.

cat

Concatenate files and print on the standard output.

Use the file parameter to enter the file name.

grep

Print lines that match patterns.

This command requires the following parameters:

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*. This is a required parameter.

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

hardware

Displays information about the hardware.

cpumem

Display the CPU and memory information.

MSDP-config

Access the MSDP configuration files.

tail

Append the last 10 lines of each file to standard output.

This command requires the following parameters:

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

collect

Collect files for transferring to the target host.

This command requires the following parameters:

  • mmin

    Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15.

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*.

  • mtime

    Finds files that are modified n*24 hours ago. Same as mtime option in find command. For example, 2, +2, -2.

ls

List information about the FILEs.

Use the dir parameter to enter the directory name.

scp

Securely transfer selected files to the target host.

This command requires the following parameters:

  • scp_port

    Specifies the port to connect to on the remote host.

  • scp_target

    Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.

cat

Concatenate files and print on the standard output.

Use the file parameter to enter the file name.

grep

Print lines that match patterns.

This command requires the following parameters:

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*. This is a required parameter.

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

diskio

Displays information about the disk I/O.

iostat

Displays the information about the disk I/O.

vmstat

Displays the information on the wait on the disk I/O.

nmon

Display the information about the monitor system.

disk-volume

Display information about the disk volume.

syslogs

Access the system logs.

tail

Append the last 10 lines of each file to standard output.

This command requires the following parameters:

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

collect

Collect files for transferring to the target host.

This command requires the following parameters:

  • mmin

    Find files that are modified n minutes ago. Same as mmin option in find command. For example, 15, +15, -15.

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*.

  • mtime

    Finds files that are modified n*24 hours ago. Same as mtime option in find command. For example, 2, +2, -2.

ls

List information about the FILEs.

Use the dir parameter to enter the directory name.

scp

Securely transfer selected files to the target host.

This command requires the following parameters:

  • scp_port

    Specifies the port to connect to on the remote host.

  • scp_target

    Specifies the target host and path for transferring files. Use the user@host:/directory path/ format. This is a required parameter.

cat

Concatenate files and print on the standard output.

Use the file parameter to enter the file name.

grep

Print lines that match patterns.

This command requires the following parameters:

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*. This is a required parameter.

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

proc

Access process information about the pseudo-filesystem.

tail

Append the last 10 lines of each file to standard output.

This command requires the following parameters:

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

ls

List information about the FILEs.

Use the dir parameter to enter the directory name.

cat

Concatenate files and print on the standard output.

Use the file parameter to enter the file name.

grep

Print lines that match patterns.

This command requires the following parameters:

  • pattern

    Specify the naming pattern to find and select matching files and folders. For example, spoold, or spad*. This is a required parameter.

  • file

    Enter the filename. This is a required parameter.

  • options

    Enter the supported options for grep: -i, -w, -E, or tail: -f, -n.

Here are some examples of the support command usage:

support MSDP-log ls dir=spoold
support MSDP-log ls dir=spad/sof1vm08.tec.com/spoold/spad/072320.log
support MSDP-log cat file=pdde-config.log
support MSDP-log cat file=spad/sof1vm08.tec.com/spoold/spad/072320.log
support MSDP-log tail file=pdde-config.log
support MSDP-log tail file=pdde-config.log options="-f"
support MSDP-log tail file=pdde-config.log options="-n 5"
support MSDP-log tail file=spad/sofia11vm08/spoold/spad/072320.log options="-f -n 5"
support MSDP-log grep file=spad* pattern=sessionStartAgent options="-r"
support MSDP-log grep file=pdde-setup.log pattern="pid  455"
support MSDP-log grep file=pdde-setup.log pattern="Pid" options="-w -i"
support MSDP-log grep file=spoold* pattern="Pid" options="-w -i -r"
support MSDP-log grep file=pdde-setup.log pattern="MSDP-X|PureDisk" options="-w -i -r -E"

To collect logs

  1. Open an SSH session to the server as the msdpadm user.
  2. If you plan to collect and transfer a large log file, you may need to increase the amount of time before the SSH connection times out. The default is 10 minutes. Use the following steps to increase the time:

    • Run the following command:

      setting ssh set-ssh-timeout ssh_timeout=<number of seconds>

    • Run the following command to verify the change:

      setting ssh show-ssh-timeout

    • Close the current SSH session and open a new one.

  3. Run the collect command for the desired category to collect files of interest. For example:
    support MSDP-log collect pattern=spoold* mmin="+2"
support MSDP-history collect
support MSDP-config collect
support syslogs collect pattern=crash mmin="-2"
  4. Run the scp command from any category to create a tarball of all previously collected files (from all categories) and transfer the tarball to the target host using the scp protocol. For example:

    support MSDP-config scp scp_target=user@example.com:/tmp

  5. If applicable, run the following command to set the SSH time-out back to the default:

    setting ssh set-ssh-timeout ssh_timeout=600

    Verify the change with the setting ssh show-ssh-timeout command.