Overview

Always read the plugin's README file, because it gives you hints about ports, and it covers other additional configuration steps. Things can change between on version of the plugin and the next, so you need to check to ensure that the server is correctly configured for the current version of the plugin.

 

The content of the README file is always:

 

• About OST plugin
• Compatibility Information
• Installation
• Uninstallation
• Usage
• Troubleshooting
• Performance tuning

Some older plugins used a different port for the dm_server/client connection. Always read the information provided very carefully, and modify the services as described in the plugin's README file.

 

To check the plugin version on the NBU server, use this command:  

 

• Windows: %install_path%\NetBackup\admincmd\bpstsinfo -plugininfo
• Linux: /usr/openv/netbackup/bin/admincmd/bpstsinfo -plugininfo

To check the plugin version on the BUE server, use this command:  

 

•  

• Windows: Go into the \Program Files\Symantec\Backup Exec\RAWS folder and right click on the libstspiQuantum.dll file and the version will be under the Version tab.
 

You will find this information on the version of the plugin that existed when this section was written:

 

• Plugin Name: libstspiQuantum.dll 
• Prefix: Quantum 
• Label: Quantum OST plugin 
• Build Version: 9 
• Build Version Minor: 4 
• Operating Version: 9 
• Vendor Version: 2.1.17_513 Quantum plugin

The Windows and Linux plugins are very different from each other. Please keep this in maind as you use these two plugins. 

 

Look at the configuration files and read the information in them. You can change the DEBUG settings for the logs, but do not use trace, because it will slow the system down. Use DEBUG and then disable it after you have collected the data. In the case of real errors, the logs will be full with WARN and ERROR messages, even without DEBUG enabled.

 

---

OstPlugin Config Files and Logs

Windows:
CONFIG ==  %WINDIR%libstspiQuantum.ini
LOGS   ==  %WINDIR%libstspiQuantum*

 

Linux:
CONFIG == /usr/Quantum/QuantumPlugin.conf
LOGS   == /var/log/ost/client

---

Plugin Configuration Modifications

Windows

 

You can change the logfile size, timeouts, and the log level (only change the log level if instructed to do so):

 

• LOG_LEVEL - defines the level of logging to enable. This option is available for all loggers. The value of this option defines the level of log messages to output. 
  • NONE  - disables logging for the logger
  • TRACE - enables tracing for error messages
  • DEBUG - enables debug for error messages
  • INFO  - enables information for error messages
  • WARN  - enables warning and error messages
  • ERROR - enables only error messages.

Log File Logger Options

 

[log_file]

        LOG_LEVEL=ERROR

        LOG_PATH=%WINDIR%

        LOG_NAME=libstspiQuantum

        LOG_LIMIT=10485760

        LOG_TIMEOUT=60000

 

Changing the I/O Path from Data Mover to Normal NAS /CIFS Protocol (should not be performed!)

 

; IO_PATH specifies which data transport method to use
; 1 for DM v2
; 2 for NAS
; 3 for DM v1
[io_path]
IO_PATH=1

 

Linux
# DEBUG_LEVEL - Defines the level of logging to enable. The value of
#          this option defines the level of log messages to
#          output. Set it to one of the following.         
#
#          EMERGENCY                  
#          ALERT
#          CRITICAL                 
#          ERROR     
#          WARNING
#           NOTICE     
#          INFO     
#          DEBUG     
#  
#          Default: ERROR     
#
DEBUG_LEVEL=DEBUG
#
#
# OPDUP_TIMEOUT - Defines timeout of an Optimized Duplication/Copy
#    of an extent in seconds.
#    Default: 180 secs
OPDUP_TIMEOUT=180
#
#
# BLOCK_SIZE - Defines the preferred block size of OST Plugin for the
#              I/O
#              Default: 262144 bytes
BLOCK_SIZE=262144
# 1 for DM v2
# 2 for NAS

# 3 for DM v1
IO_PATH=1

 

 

------ Some Details ----

 

**OPDUP_TIMEOUT =   During opt duplication, if we have to wait for a fragment to be deduplicated or unlocked, optimized duplication fails after this # of seconds. On earlier systems running duplication, this required modification, but with the new version of OST Duplication, this should not be needed.

IO_PATH == DM v   == Data mover, a Quantum-owned data transfer technology
                  == NAS  == Either NFS or standard CIFS data transfer method

 

DM v2  vs DM v1 = DM v2 uses authentication from the server to the DXi system and requieres that a username and password be entered on the DXi. (This is pointed out in the OST Configuration Guides)

---

What's Next?

Basics of OST Troubleshooting >