CREATE_REPLICATION_SERVER

This procedure defines a configuration for a downstream Recovery Appliance that forms part of a Recovery Appliance replication scheme.

This procedure creates metadata for the downstream Recovery Appliance, but does not replicate any backups. Use the ADD_REPLICATION_SERVER procedure to link the downstream Recovery Appliance to one or more protection policies, so that the Recovery Appliance sends backups for protected databases assigned to these policies to the downstream Recovery Appliance.

Syntax

PROCEDURE create_replication_server (
   replication_server_name IN VARCHAR2,
   sbt_so_name IN VARCHAR2,
   sbt_parms IN VARCHAR2 DEFAULT NULL,
   max_streams IN NUMBER DEFAULT NULL,
   catalog_user_name IN VARCHAR2,
   wallet_alias IN VARCHAR2,
   wallet_path IN VARCHAR2,
   proxy_url IN VARCHAR2 DEFAULT NULL,
   proxy_port IN NUMBER DEFAULT NULL,
   http_timeout IN NUMBER DEFAULT NULL,
   comments IN VARCHAR2 DEFAULT NULL);

Parameters

Table 21-12 CREATE_REPLICATION_SERVER Parameters

Parameter Description

replication_server_name

The user-assigned name of the downstream Recovery Appliance. This value is converted to upper-case before storing.

sbt_so_name

The name and path to the Recovery Appliance Backup Module. The module is an Oracle-supplied media library that simulates an SBT device. The Recovery Appliance uses this library to communicate with the downstream Recovery Appliance.

sbt_parms

The name and path of a client configuration file in the form (RA_CLIENT_CONFIG_FILE=file_system_location). The parentheses are mandatory. The client configuration file is a text file.

The following shows the sample contents of a client configuration file:

ra_host=oam2.example.com:6498 ra_wallet='location=file:/u01/oracle/wallets credential_alias=repcred1'

Note:

The system parameters SBT_LIBRARY, RA_WALLET, CREDENTIAL_ALIAS, PROXY_ULR, and PROXY_PORT must be specified through the create_replication_server parameters and not through sbt_parms.

max_streams

The maximum number of simultaneous replication tasks. If null, which is the recommended setting, then the upstream Recovery Appliance determines the number of streams to use for replication based on the number of its nodes.

catalog_user_name

Ignored. Automatically populated with the Recovery Appliance Catalog Owner.

wallet_alias

The alias that identifies the credential within the wallet that the upstream Recovery Appliances uses to authenticate with the downstream Recovery Appliance.

wallet_path

The path to the local Oracle wallet (excluding the wallet file name). Path must start with file: .

proxy_url

The URL of any required proxy server, in the format host.

proxy_port

The port number of the proxy server.

http_timeout

The HTTP timeout interval, in seconds. Usually you leave this parameter set to null, to accept the system default HTTP timeout, unless directed to set it to a different value by Oracle Support.

comments

Optional user supplied comment describing reason for executing this command.