nsrdbmi(8)

NAME
nsrdbmi - Legato NetWorker Module for Informix command

SYNOPSIS
nsrdbmi [ -v ] [ -s server ] [ -c client ] [ -N saveset_name ] [ -e expiration ] [ -g group ] [ -l level ] [ path ... ]

DESCRIPTION

This shell script is used by savegrp(8) to trigger backups on an Informix database server in conjunction with the use of ON-Bar, the backup interface provided by Informix. nsrdbmi is normally only run by savegrp and not run manually. To use this command for scheduled backups, the client resource (see nsr_client(5)) should list nsrdbmi in the backup command attribute.

Users wishing to modify this command should use the template provided in /etc/nsrdbmi.sh. Do not modify the template file so you always have a reference to the original behavior.

There are several configurable variables users can set in the command to control backups to the NetWorker server. Variable: PRECMD
Default value: NONE
Description: This variable can be used to run a command before dbspace and log file backups. If this command does not run successfully (in other words, if it returns a non-zero status), nsrdbmi will exit.
Variable: POSTCMD
Default value: NONE
Description: This variable can be used to run a command after dbspace and log file backups have completed. This command is not run if onbar returns a non-zero exit code. Variable: NSR_DATA_VOLUME_POOL
Default value: DBMIData
Description: If this variable is set to name a media pool, then dbspace backups will be directed to the given media pool. Variable: DO_LOGFILE_BACKUPS
Default value: YES
Description: If this variable is set to YES, then logfile backups will be executed after dbspace backups. If set to NO, no logfile backups will occur. Variable: NSR_LOG_VOLUME_POOL
Default value: DBMILogs
Description: If this variable is set to name a media pool, then logfile backups will be directed to the named media pool. Variable: DO_BOOTFILE_BACKUPS
Default value: YES
Description: If this variable is set to YES, then Informix critical file backups will be executed after dbspace backups. Variable: BOOTFILE_LIST
Default value: NONE
Description: This environment variable specifies the file name that lists the Informix critical files to backup. If not specified and DO_BOOTFILE_BACKUPS is set to YES, a default list of files will be backed up. Note that the default list might not include all the necessary files for XPS. Variable: NSR_COMPRESSION
Default value: FALSE
Description: This environment variable determines if compression is performed on the data. The default value is "FALSE" indicating no compression should take place. Set this value to "TRUE" to turn on client-side compression. Variable: PATH
Default value: $INFORMIXDIR/bin:/bin:/usr/sbin
Description: Set up PATH environment variable. This must be configured to include the path to the onbar executable and the NetWorker program mminfo(8). Variable: INFORMIXDIR
Default value: /usr/informix
Description: Set up INFORMIXDIR environment variable which lists the directory where the Informix RDBMS is installed. Variable: ONCONFIG
Default value: onconfig.std
Description: Lists the name of the Informix RDBMS configuration file being used. Variable: INFORMIXSQLHOSTS
Default value: $INFORMIXDIR/etc/sqlhosts
Description: Describes where the sqlhosts file is located.

The nsrdbmi command also backs up the emergency boot file and $ONCONFIG file using the save command. These files will be backed up to the same pool as the dbspace backups. If you wish to have these files sent to another pool, the shell script should be modified appropriately.

OPTIONS
Please see the save(8) man page for a description of options supported by nsrdbmi.

Note that each optional path argument is typically of the form INFORMIX:/<IDS_server_name>/<dbspace_name>.

FILES

/etc/nsrdbmi.sh
    A template of this command is provided in /etc.

SEE ALSO
mminfo(8), nsr_client(5), nsr_pool(5), nwadmin(8), save(8), savegrp(8).