racli add cloud_location

Adds a cloud storage object to the Recovery Appliance.

Syntax

racli add cloud_location --cloud_user=CLOUD_USER_NAME --host=HOST_URL --bucket=OCI_BUCKET_NAME [--enable_archive | --disable_archive] [--archive_after_backup=NUMBER:{DAYS|YEARS} --streams=NUMBER --proxy_host=HTTP_SERVER --proxy_port=HTTP_PORT --proxy_id=HTTP_USER --proxy_pass=HTTP_PASS --import_all_trustcert=X509_CERT_PATH --retain_after_restore=NUMBER:HOURS] [-guaranteed={yes|no}] [--immutable --temp_metadata_bucket=METADATA_BUCKET_NAME]

Options

--archive_after_backup

The number in days or years for period of time before backups are moved to archive state. It takes the form “–archive_after_backup=NUMBER:DAYS” or “–archive_after_backup=NUMBER:YEARS”, where NUMBER is a positive integer. If not specified, the default is 2 days.

--bucket

The name of the bucket where the backup will go. Note that the install tool will create the specified bucket if it does not exist.

--cloud_user

Previously configured cloud_user object with all authentication requirements.

--disable_archive

Disables archival of backup data.

--enable_archive

Enables archival of backup data after the time interval specified by the --archive_after_backup parameter. If not specified, by default the archival will be disabled.

--host

Host name for the Oracle Bare Metal Cloud account.

Note: The host name should not have any trailing slashes (/) at the end of its name.

--import_all_trustcert

Import all X509 certificates from Java truststore.

--streams

The number of streams to be associated with this specific cloud_location. Directly translates to the number of sbt_attrib sets created.

--proxy_host

HTTP proxy server. Used for OCI-C support.

--proxy_id

HTTP proxy server username. Used for OCI and stored as part of the alias_http_proxy in location wallet.

--proxy_pass

HTTP proxy server password. Stored as part of the alias_http_proxy in location wallet.

--proxy_port

HTTP proxy server port. Used for OCI-C support.

--retain_after_restore

Specifies the number of hours to retain information after a restore.

It takes the form “–retain_after_restore=NUMBER:HOURS”. It has a maximum value of “240:HOURS”.

--guaranteed

If –guaranteed=yes, this cloud location will require a copy of a backup piece before it can be deleted. For virtual backups, only one of the Level 0 or Level 1 copies of a backup piece are required.

--immutable

This makes the bucket being added immutable. Must be used with the –temp_metdata_bucket option.

--temp_metadata_bucket

Used for immutable buckets.

Specifies the metadata bucket name for immutable cloud location setup. The metadata bucket must be a mutable bucket (i.e. non immutable) and must exist. It can be created using the OCI console. Each metadata bucket must be unique. You cannot use the same metadata bucket for different immutable buckets.

Details

This is equivalent to the sbt_library used for copy-to-tape but is specific to copy-to-cloud. The user’s cloud credentials are required.

Examples

This example adds a new cloud storage object to the Recovery Appliance schema.

racli add cloud_location --cloud_user=samu ---host=https://cloud_uri/oci -bucket=sam_backup