backupserver

Syntax

backupserver
	[-C server_connections]
	[-S b_servername]
	[-I interfaces_file]
	[-e error_log_file]
	[-M sybmultbuf_binary]
	[-N network_connections]
	[-T trace_value]
	[-L Sybase_language_name]
	[-J Sybase_character_set_name]
	[-c tape_config_file]
	[-D n]
	[-A pathname]
	[-P active_service_threads]
	[-V level_number]
	[-p n]
	[-m max_shared_memory]

backupserver -v

Parameters

• -C server_connections – specifies the number of server connections for the Backup Server, which requires:

  • Two connections for each dump session

  • One connection for each load session

  • One connection for volume change messages

  Allow a maximum of three times the number of expected concurrent dump and load sessions. The default value is 30 server connections.

• -S b_servername – specifies the name of the Backup Server to start. The default is SYB_BACKUP. This entry must specify the name of a Backup Server in the interfaces file.
• -I interfaces_file – specifies the name and location of the interfaces file to search when connecting to Backup Server. If -I is omitted, backupserver looks for a file named interfaces in the directory pointed to by your SYBASE environment variable.
• -v – prints the version number and copyright message of the backupserver software and then exits.
• -e error_log_file – specifies the name and location of the Backup Server error log file used to report SAP^® Open Server™ internal errors, sybmultbuf errors, errors that halt the Backup Server, and errors for disconnected sessions. All other errors are sent to the notify destination specified in the dump database, dump transaction, load database, and load transaction commands.
• -M sybmultbuf_binary – specifies the full path name of the sybmultbuf executable. Use this parameter only when starting Backup Server from a directory other than the bin directory of the Sybase installation directory, or when using a diagnostic version of sybmultbuf.
• -N network_connections – specifies the number of total network connections (DBPROCESSes) that the master Backup Server can originate. The default value is 25.
• -T trace_value – interprets trace_value as a bitmask (base-2 number). The 1 bits in trace_value correspond to Open Server Trace flags to turn on. If you specify more than one -T parameter on the command line, the final -T value overrides the values from earlier -T parameters. The trace_value must be a positive integer.
• -L Sybase_language_name – specifies the default language for Backup Server. If not specified, Backup Server uses the locale specified by the LC_ALL or LANG environment variables. If these variables are not set, Backup Server searches for the “default” entry in locales.dat.
  Note: The -L parameter does not override the value set in the LANG environment variable.
• -J Sybase_character_set_name – specifies the default character set for Backup Server.
• -c tape_config_file – specifies the name and location of the tape configuration file to search for tape device configuration information before doing a dump database or a dump transaction. If you do not specify -c, the default path name for the tape configuration file is $SYBASE/backup_tape.cfg.
• -D n – specifies the bitmap (base 10 number) of the diagnostic flags used within Backup Server.
• -A pathname – specifies the pathname to the directory of the Archive API dynamically loadable library.
• -P active_service_threads – allows you to increase the number of stripes during multiple dump/load operations (with a maximum of 12,286 stripes per single operation).
• -V level_number – limits the messages that are printed to the Backup Server error log. The level_number variable determines the degree of error verbosity (-V) for Backup Server:

  • -V4 – displays all -V0 messages except “Connection from Server” messages printed for each connection event.

  • -V3 – displays only completion messages from a normal dump or load command and these types of messages:

    • Error messages from Backup Server and sybmultbuf

    • Other sybmultbuf messages

    • Volume change messages

    • Open Server™ messages

    • Trace print messages

    • Informational messages from the System & Tape Auto Config modules

  • -V2 – displays:

    • All -V3 messages plus

    • File creation and file mount messages

  • -V1 – displays:

    • All -V2 messages plus

    • Phase messages

  • -V0 (default) – displays all messages, including backup progress

  This limitation does not involve the messages that are sent to the client or console as determined by the NOTIFY= parameter in a dump or load command.

  This option also does not affect logging for these message types:

  • Open Server messages

  • Trace printing messages from bs_traceprint

  • sybmultbuf messages

• -p n – specifies the TDS packet size in bytes that the local Backup Server requests from the remote Backup Server during network dumps. The actual packet size used is limited to the -p parameter value of the remote Backup Server. If you do not specify -p, the default is 2048 bytes. The packet size should be an integer greater than, or equal to 256.
• -m max_shared_memory – specifies the maximum amount of shared memory in megabytes that Backup Server can use for all of its dump or load sessions.

Usage

See also Open Server Server-Library/C Reference Manual for more details on trace flags.

Permissions

Anyone with execute permission on the binary, and who has read/write access to all the files.