12.2 UPSTREAM Server Configuration Parameters
The UPSTREAM Server configuration file (usserver.cfg) is a plain text file and it can be modified with a text editor (like notepad) if you do not wish to use the Server Configurator program (usservercfg.exe).
The following are its valid parameters:
Parameter | Default | Reg. | Description |
|---|---|---|---|
ACSLSSCRATCHPOOL | 0 | No | No longer used. |
CONFIGCALCDISKSIZE | Y | No | Y: Available disk space is compared to the estimate from the client (as modified by DASDOVERRIDE) to determine if the backup should run. N: Disk space is not used to determine whether a backup should run. |
CONFIGFILE | usserver.cfg | No | Used as the last saved name and can be ignored. |
CONFIGLINTAPE | N | No | Y: Use the IBM LINTAPE (ATAPE) interface. Requires that the LINTAPE interface be installed and that you have IBM drives and changers but offers high performance failover and load-balancing. N: Use the standard generic interface that supports all device vendor's hardware. |
CONSOLEREFRESH | 3 | No | The number of seconds between Director console status updates. |
DETAILS | N | No | Whether detailed logging and reporting should be performed. |
DISKFORMAT | 0 | No | 0: Standard, compatible disk backups. 1: Simple disk format that may save a small amount of space. 2: Data Domain format. See Data Domain De-duplication Device Support on page 4-27 for use of this option. |
DISKREADASYNC | Y | No | (Windows only) If specified, disk reads will be performed asynchronously. |
DISKREADBUFFER | 1048576 | No | The buffer size in bytes used for reads and writes of data to/from disk for backups, restores or vault/migrate/copy. 0 disables; minimum size is 32768, we recommend powers of 2. |
DISKWRITEASYNC | Y | No | (Windows only) If specified, disk writes will be performed asynchronously. |
FORCEEOV | 0 | No | A testing only parameter, if specified non zero, the number of records before a tape volume switch is forced. |
HISTORY | Y | No | Y: UPSTREAM writes XML history records to the file USHistory.XML. N: UPSTREAM does not write XML history records. |
LIBRARYMGRADDRESS | Localhost | Yes for Unix | The IP address of the ACSLS control system. Not required for Windows. |
LIBRARYTYPE | 0 | No | The type of tape library supported: 0: RSM 1: ACSLS 2: UPSTREAM Tape Manager 3: No library 4: IBM 3494 |
LOGFILE | usserver.log | No | The name of the Reservoir log file. |
MAINTTIME | 03:00:00 | No | The time when system maintenance is run if RUNMAINT is set to Y. |
MAXHISTORYDAYS | 365 | No | The maximum number of days to preserve in the USHistory.XML file during maintenance if RUNMAINT Y and HISTORY Y is specified. |
MAXLOGDAYS | 30 | No | The maximum number of days to preserve in the USSERVER.LOG file during maintenance if RUNMAINT Y is specified. |
MAXMOUNTRETRIES | 1500 | No | For non-RSM mounted tapes, the number of 200 millisecond delays before the mount is failed. |
MAXREGISTRYDAYS | 0 | No | The number of days that registered name entries will be preserved unless they are re-registered or modified. 0 disables the feature. |
MAXTAPES | 256 | No | The maximum number of tapes for a given backup. |
MESSAGEBOXNOTIFY | Y | No | Y: UPSTREAM will generate a message box on the Reservoir system for the notification of any local operator when RSM notification isn’t used (for scratch tapes for example). These message boxes do not automatically go away. N: UPSTREAM will not generate message box notifications. |
MESSAGEFILE | upstream.msg | Yes | The name of the predefined UPSTREAM message file. |
MT3494EMULATION | N | No | Y: You are connected to a 358x emulating a 3494. N: You are connected to a real 3494 |
MT3494LIBRARY | None | Yes | The name of the 3494 library. |
MT3494UPSTREAM | 0 | Yes | The 3494 category to use for UPSTREAM generated tapes. |
NOMAINTTAPESETS | N | No | Y: Empty tape sets are preserved during maintenance. |
NOSOCKETINHERITANCE | N | No | (Windows only) Set to Y only if you get socket operation on non-socket errors. |
OSTAPEACCESS | Y | No | Y: Operating system access to tapes. This is especially recommended on Windows |
REPORT | N | No | If set to Y, a us<task ID>.rpt file is created detailing all of the files backed up or restored. |
RUNINTERVENTION | N | No | N: Will not run an intervention script. Y: Will run an intervention script when a tape user event occurs that you may want to handle programmatically. See page 6-4 for a description of details about intervention scripts. |
RUNMAINT | Y | No | Whether maintenance should be run daily. If you specify Y, you must also specify a MAINTTIME. |
SANEXPRESSDIRECTNEG | N | No | Whether the SAN Express Direct Negotiation will be performed with clients. This can be expensive and is not recommended unless you are using the SAN Express Direct. |
SCSILOCKLIBRARY | N | No | Whether an UPSTREAM Tape Manager library should be locked between calls (avoids overlapping calls). Not needed for most libraries, except the Sun SL500. |
SECLEVEL | 0 | No | 0: No security. 1: User name and password is verified against the Windows security system’s database. 2: User name and password are verified along with the right to create files in the Reservoir subdirectory: Backups\<Backup Profile> |
SUMMARYREPORT | Y | No | If set to Y, UPSTREAM will generate a single line summary for each operation that is performed in the file summary.rpt. This is a very useful feature and is thus set by default |
TAPENOTIFYTARGETS | None | No | Can be set to the name of a notification file in the UPSTREAM client directory of a user to be notified to perform UPSTREAM Tape Manager manual functions. |
TAPEUSELOCATE | Y | No | If set to Y, UPSTREAM will use the SCSI Locate to move the tape to a specific block (when available). If set to N, UPSTREAM will use the SCSI Seek to move the tape to a specific block. |
TCPRECVBUFFER | 65535 | No | The total per socket buffer space reserved for receives. A TCP performance tuning parameter. |
TCPSENDBUFFER | 65535 | No | The total per-socket buffer space reserved for sends. A TCP performance tuning parameter. |
TCPTIMEOUT | 0 | No | The number of seconds without communications which elapse before the connection is timed out. Specify 0 for no timeout. |
USEDATABASE | Y | No | N: Operates in non-database mode (the UPSTREAM/SAR product) Y: Operates in full database mode (UPSTREAM Reservoir product) |
USHOSTTRACE | N | No | Enables very verbose tracing. Turn on only on request of UPSTREAM technical support. |
USPORT | 1972 | No | The port that the UPSTREAM Reservoir listens for remote requests on. |
WORKPATH | The default directory/workpath | No | Where UPSTREAM will store its databases and other files. Must not be changed without also moving these files. |