backupserver

The executable form of the Backup Server program.

The utility is located in:
  • (UNIX) $SYBASE/$SYBASE_ASE/bin.

  • (Windows) %SYBASE%\%SYBASE_ASE%\bin, as bcksrvr.exe.

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]
or:
backupserver -v

Parameters

Usage

  • In SAP ASE version 15.5 and later, both the SAP ASE server and Backup Server can bypass the operating system buffer cache when you enable the directio parameter for the device using disk init, disk reinit, or sp_deviceattr. the SAP ASE server passes the device options to Backup Server, which enables Backup Server to access the database device with the appropriate directio option.

  • Backup Server versions 15.0.3 and earlier do not work with SAP ASE 15.5 and later.

  • Start Backup Server with the startserver command rather than by directly executing the backupserver program.

    • To change default values in UNIX, edit the RUN_servername file in your Sybase installation directory. See the startserver reference page for details.

    • To change default values in Windows, use Server Config to change the command line parameters of the Backup Server. See the SAP ASE configuration guide for details.

  • Make sure that the device driver options you include with the dump command are accurate. Backupserver does not verify any device driver options you include during a dump command. For example, if you include a option that forces Backupserver to rewind a tape before use, it will always rewind the tape to the beginning instead of reading the tape from the point of the dump.

  • If you do not specify a Backup Server name with the -S parameter, and you have not set the environment variable DSLISTEN, backupserver uses the default Backup Server name SYB_BACKUP in UNIX.

    (Windows) bcksrvr uses the default Backup Server name server_name_BS. The value of the DSLISTEN environment variable overrides this default value, and the -S parameter overrides both the default and the value specified in DSLISTEN.

  • Whenever possible, the Backup Server and any SAP ASE servers that dump or load directly through the Backup Server should share the same interfaces file (sql.ini in UNIX). The interfaces file that Backup Server uses must contain entries for:
    • Backup Server

    • Any other Backup Servers with which this Backup Server communicates

  • Trace flags cause the Backup Server to print information regarding its operation while it is running, for debugging problems in the Backup Server.

  • Backup Server provides multithread support needed for Tivoli Storage Manager (TSM) options such as LAN-FREE.

    To enabled multithread support for TSM options, use the –D8192 option during Backup Server startup. For example:

    ${BACKUPSERVER} -SSYB_BACKUP -I$SYBASE/interfaces -M${SYBMULTBUF} -D8192& 

    This feature is not enabled by default.

  • If Backup Server cannot find the locales and charsets directories specified by the -L and -J parameters, or if these parameters specify an incorrect language and character set combination, Backup Server issues an error message and uses the default language and character set. Backup Server does not support use of the Open Server-defined SRV_TR symbols for -T.

  • Backup Server cannot perform loads or dumps between servers that use different logical page sizes. For example, load a 4K logical page sized database dump into another server using a 4K logical page size. But Backup Server does not support dumping a 4K logical page sized database and loading it into a database that uses 16K logical page size.

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.

Related concepts
Utility Commands Reference
Utilities to Start Servers
Related information
startserver