#
# This is the sample init.utl file.
#
# This file contains settings for the NetWorker Module for SAP with
# Oracle (a.k.a. NMSAP).
#
# Note: Comments have a "#" in the first column.
#
###########################################################################


# Default Value: FALSE
# Valid Values: FALSE/TRUE
# Set to 'TRUE' if you want client-side software compression.
# No compression unless set to 'TRUE'.
# This parameter is mutually exclusive from 'checksum' and 'NSR_AES_ENCRYPTION'.
# The priority order is: 'compress', 'checksum', 'NSR_AES_ENCRYPTION'.
# So, if you specify all, only compression will be done.
#
# compress = TRUE
#compress = TRUE

# Default Value: 20
# Valid Values: > 0 integer
# Number of savesets to use for backups.
# This parameter will be ignored if 'ss_group_by_fs' is set to 'TRUE'.
#
# savesets = 20
#savesets = 20


# Default Value: 8
# Valid Values: > 0 integer
# Number of simultaneous savesets/savestreams to send to server. 
# Be sure your server and devices are configured to support at least
# as many streams.
#
# parallelism = 8
#parallelism = 8


# Default Value: <none>
# Valid Values: any pool defined in your NetWorker server
# Uncomment to set the media pool to use for saves.  If not specified
# for a manual backup, a pool selected by NetWorker server is used.
# For scheduled backups, a pool associated with the group is used.
#
# pool = Default
pool = Default

# Default Value: <none>
# Valid Values: any string which is a valid mail command in your system
# Notifications for backint activity. Unices only. See documentation
# for details.
#
# notify_start = mailx -s 'backint start' root
# notify_done = mailx -s 'backint done' root
# notify_success = mailx -s 'backint success' root
# notify_error = mailx -s 'backint error' root


# Default Value: local host
# Valid Values: your NetWorker server hostname
# Set the NetWorker server hostname to use for backups and restores.
#
# server = prelude
server = gbbackup

# Default Value: local host
# Valid Values: your NetWorker client hostname
# Use the client name under which the current backup should be catalogued.
# Setting the client name will append the "-c <hostname>" to the save
# command that is built by backint. This should always be set if the client
# is a virtual cluster client.
#
# client = mars
client = epprd

# Default Value: FALSE
# Valid Values: FALSE/TRUE
# Dump more information from NetWorker functions into log file.
# For other diagnostic procedures, please contact Technical Support.
#
# verbose = TRUE
verbose = TRUE


# Default Value: <none>
# Valid Values: the directory name(s) of your raw disk partitions
# Set raw partition directory other than /dev and /devices. Any files below
# these two directories are considered to be raw disk partitions. If you
# have raw partitions under another directory, you must use this option.
# Use a semicolon to separate directory paths
#	e.g. raw_dir = /oracle/data;/sap/data;/lotus/data
# raw_dir = /oracle/data


# Default Value: FALSE 
# Valid Values: FALSE/TRUE
# Unices only (query_index is always forced to 'TRUE' for Windows).
# This variable controls querying of the NetWorker server indexes (indices) 
# before backint starts a recover. If the value is 'FALSE', the query will not 
# take place. If the value is 'TRUE', before recover starts the server will be 
# queried for validation of the requested files & backup id's. 
#
# query_index = TRUE


# Default Value : old
# Valid Values : old/new
# This variable controls the saveset naming convention. If the 
# value is "old" the saveset name for ALL backups is "backint:<ORACLE_SID>". If 
# the value is "new" the saveset name for each session will differ according 
# to the files being backed up. The saveset name will be 
# "backint:<ORACLE_SID>:<absolute path of the first filename in the saveset>".
#
# Please be aware that setting ssNameFormat=new will eliminate the
# possibility of recovering the database with NetWorker recover -S and brrestore
# will be the only alternative to recover the savesets. Recovering with
# NetWorker recover is at your sole discretion.
#
# ssNameFormat = old


# Default Value : 30.
# Valid Values : > 0 integer.
# This variable controls the amount of time (in minutes) 
# that backint will wait for brbackup/brconnect to remove the semaphore file. 
# At the end of this timeout period, if the semaphore file was not deleted 
# backint will exit with an error.
#
# sem_timeout = 30


# Default Value: TRUE
# Valid Values: TRUE/FALSE, setting to 'FALSE' is at your sole discretion.
# This variable controls the "-l Full" invocation of save. If set to 'TRUE'
# the file will be saved with the "-l Full" parameter set.
#
# level_full = TRUE


# Default Value: 0
# Valid Values: > 0 integer
# This variable controls the number of times a failed backup
# is retried for each saveset.
#
# retry_count = 0


# Default Value: 0
# Valid Values: > 0 integer
# This variable sets the maximum number backint session logs to be saved in
# the log file. If the value of this parameter is 0, ALL backup logs will be
# saved in the log file. Please refer to backint_log parameter.
#
# max_logs = 1


# Default Value: /nsr/applogs/arch_backint<ORACLE_SID>.log
# Valid Values: any valid fullpath name with proper permission
# Fullpath name (absolute path and filename) of backint log file for running
# brarchive.
#
# arch_backint_log = c:\temp\logfile\ar_backint.log
#arch_backint_log = /nsr/apps/logs/arch_backint.log


# Default Value: /nsr/applogs/backint<ORACLE_SID>.log
# Valid Values: any valid fullpath name with proper permission
# Fullpath name of backint log file for running brbackup/brrestore.
#
# You can specify a separate log file for restore by modifying this parameter
# before running brrestore. Alternatively, you can specify your own value for 
# backint_log in your own init<ORACLE_SID>_restore.utl file, which can be
# referenced from your own init<ORACLE_SID>_restore.sap's 'util_par_file'
# parameter (brrestore -p init<ORACLE_SID>_restore.sap).
#
# backint_log = c:\temp\logfile\backint.log
#backint_log = /nsr/apps/logs


# Default Value: /nsr/applogs
# Valid Values: any valid directory name with proper permission
# Directory name of backint temporary files
#
# backint_tmpdir = c:\temp\logfile
backint_tmpdir = /nsr/apps/tmp/logfile

# Default Value: FALSE
# Valid Values: FALSE/TRUE
# Group saveset by file system
# If set to 'TRUE', savesets parameter will be ignored
#
# ss_group_by_fs = TRUE
ss_group_by_fs = FALSE


# Default Value: 0
# Valid Values: > 0 integer
# saveset grouping max size in MB. If not set, unlimited sizing takes
# effect.
#
# ss_size_max = 4096


# Default Value: FALSE
# Valid Values: FALSE/TRUE
# Unices only: whether to allow restoring previous backup if the required one 
# cannot be found when query_index = FALSE.
#
# prev_bk_restore = TRUE


# Default Value: FALSE
# Valid Values: FALSE/TRUE
# Set to "TRUE" if you want to do CRC checking on restore.
# This parameter is mutually exclusive from 'compress' and 'NSR_AES_ENCRYPTION'.
# The priority order is: 'compress', 'checksum', 'NSR_AES_ENCRYPTION'.
# So, if you specify all, only compression will be done.
#
# checksum = TRUE


# Default Value: FALSE
# Valid Values: FALSE/TRUE
# Set to "TRUE" if you want to encrypt the backup data.
# This parameter is mutually exclusive from 'compress' and 'checksum'.
# The priority order is: 'compress', 'checksum', 'NSR_AES_ENCRYPTION'
# So, if you specify all, only compression will be done.
#
# NSR_AES_ENCRYPTION = TRUE


#
# New parameters added in NMSAP 3.5
#

# Default Value: /nsr/applogs on Unix and 
# C:\program files\Legato\nsr\applogs on Windows.
# Valid Values: any valid directory name with proper permission.
# Directory name of backint debug log files.
#
# NSR_DEBUG_DIR = c:\PROGRA~1\legato\nsr\applogs
NSR_DEBUG_DIR = /nsr/apps/applogs


# Default Value: <none>
# Valid Values: any string in getdate(man nsr_getdate) format.
# Uncomment to set the explicit NSR_SAVESET_RETENTION date for this save set.
# By default, no explicit retention date is used and the server determines
# this date for the save set based on the retention policies in effect.
# e.g. 3 Months. Do not use quotes.
#
# NSR_SAVESET_RETENTION = 2 Weeks
#NSR_SAVESET_RETENTION = "2 Weeks"


# Default Value: <none>
# Valid Values: any string in getdate(man nsr_getdate) format.
# Uncomment to set the explicit NSR_SAVESET_BROWSE date for this save set.
# By default, no explicit browse_time date is used and the server determines
# this date for the save set based on the browse policies in effect.
# e.g. 3 Months. Do not use quotes.
#
# NSR_SAVESET_BROWSE = 2 Weeks
#NSR_SAVESET_BROWSE = "2 Weeks"


# Default Value: <none>
# Valid Values: DATA_DOMAIN
# Set to 'DATA_DOMAIN' when the backup pool contains a mixture of Networker
# Data Domain devices and other types of devices to ensure the backup data is
# always stored on Data Domain devices.
# This parameter is optional for manual backup only.
#
# NSR_DEVICE_INTERFACE = DATA_DOMAIN

# Default Value: Default
# Valid Values: Yes/No/Default
# Yes enforces the Direct File Access(DFA) method. No does not attempt DFA at
# all. Default(recommended) tries DFA and falls back to traditional methods if
# DFA cannot be used.
# This parameter is optional for manual and scheduled backups.
#
# NSR_DIRECT_ACCESS = Default
#

###########################################################################
#
# NMSAP parameters for snapshot operations with PowerSnap (PS).
# NMSAP and the accompanying PS modules only officially support scheduled
# backups as invoked from savegrp, whereby PS snapshot disk hardware resources
# will be automatically managed by NetWorker.
#

# Default Value: FALSE
# Valid Values: FALSE/TRUE
# This variable controls whether to enable the new PS (aka snapshot) feature's
# mode.  An accompanying PS module must be installed and licensed.
#
# Note that PS savesets will be named "backint:<SID|UID>:PS:". You should
# set all ps_xxx_mode variables to TRUE (or all to FALSE or commented out). Setting
# ps_backup_mode to TRUE (and ps_archive_mode to TRUE or FALSE) generally requires
# ps_restore_mode and ps_inquire_mode both be set to TRUE; doing otherwise
# is intended only for diagnostic/exploratory purposes and is to be used at
# your sole discretion.
#
# ps_backup_mode = TRUE
# ps_archive_mode = TRUE
# ps_restore_mode = TRUE
# ps_inquire_mode = TRUE


# Default Value: <none>
# Valid Values: any string, but should be a valid absolute path name of
# a PS file that has parameters which will be blindly passed by backint to
# the PS module. Refer to the documentation of the relevant PS module for
# details.
# 
# This variable indirectly controls the behaviour of the PS module. It is
# mandatory once the ps_xxx_mode variables are set to TRUE. PS module specific
# parameters are specified in one or more "x = y" lines, e.g.:
# NSR_SNAP_TYPE = symm-dmx
#
# ps_opaque_pfilename = /nsr/res/nsrsapps.cfg
#ps_opaque_pfilename = /nsr/apps/res/nsrsapsv_SOL.cfg


# Default Value: <none>
# Valid Values: any string of numbers, but should be one or more valid backint
# run numbers, e.g. "2" --- minus the quotes in actuality.  Run#2 is usually
# the second backint run invocation by brtools that only backs up the parameter
# files, the SAP backup catalogue files, etc. The first backint run will usually
# be for the main database data files; these files are usually very large and
# are the only ones that will really benefit from undergoing PS snapshot
# processing.
# 
# This variable says whether to force all "PS" files in a backint session
# to follow the traditional non-snapshot processing, i.e., whether to exclude
# them from any PS snapshot processing, thereby saving valuable snapshot
# disk hardware resources for the large files.
#
# The following starting values are recommended:
#
ps_exclude_backup_bi_run_nums = 2
ps_exclude_archive_bi_run_nums = 1;2


# Default Value: <none>
# Valid Values: any fullpath string, including standard Unix wild-card
# characters. The values should be based on actual brtools input file names
# passed to backint.
# 
# This variable controls whether to force "PS" files to follow the traditional
# non-snapshot processing, i.e. whether to exclude them from any PS processing.
# A "PS" file is one that is on a NetWorker-aware snapshot-capable file system.
#
# Note that there is limited support for wildcard characters on Windows: a
# single trailing '*' denotes simple case-insensitive prefix matching, e.g.,
# C:\DB01\FOO.DBF will be excluded from PS backups if ps_exclude_backup_paths =
# C:\*, or = c:\db*, or = C:\DB01\*, and so forth.  Under Unix, the wildcard
# matching is as provided by standard shell support for full file path names,
# e.g., /db01/foo.dbf will be excluded if ps_exclude_backup_paths =
# /db01/foo.*, or /db??/*.dbf, but not excluded if ps_exclude_backup_paths =
# /db*.
#
# Preference should be given to setting ps_exclude_xxx_bi_run_nums before
# using this parameter.
#
# ps_exclude_backup_paths =
# ps_exclude_archive_paths =


# Default Value: TRUE
# Valid Values: FALSE/TRUE
# This variable says whether to do all PS file processing before any
# traditional, non-snapshot nonPS file processing. This can help prevent
# potential resource conflicts.  This can be set to FALSE to allow for concurrent
# processing of PS and nonPS files during backup/archive and restore modes,
# when there is no possibility of resource usage conflicts --- to be used
# solely at your own discretion.
#
# ps_ps_before_nonps = FALSE


# Default Value: TRUE
# Valid Values: FALSE/TRUE
# This variable says whether to group all session files (aka objects) in
# each PS operation (prepare/sync, snapshot/split, save/restore, postpare).
# Certain DB disk/filesystem configurations and brbackup usage can show
# better NMSAP performance if ps_group_objs is set to TRUE, e.g. large number of
# files being processed by current BRTools & PS engines, with util_file_online.
# However, grouping objects also reduces the potential parallelism during
# certain backup and restore sub-operations; consider setting to FALSE for these
# cases.
#
# ps_group_objs = FALSE
#