Documentation Home
MySQL Enterprise Backup 4.0 User's Guide
Related Documentation Download this Manual
PDF (US Ltr) - 1.1Mb
PDF (A4) - 1.1Mb
EPUB - 225.6Kb
HTML Download (TGZ) - 175.1Kb
HTML Download (Zip) - 203.3Kb


13.14 Cloud Storage Options

These options are for using cloud storage for single-file operations. See Section 4.3.1.3, “Backing Up to Cloud Storage”, and Section 5.1.5, “Restoring a Backup from Cloud Storage to a MySQL Server”, for more information and instructions on using cloud storage with MySQL Enterprise Backup.

  • --cloud-service=SERVICE

    Cloud service for data backup or restoration. Currently, there are two types of cloud storage services supported by mysqlbackup, represented by the following values for the options:

    • s3: Amazon Simple Storage Service (S3)

    • openstack: OpenStack Object Storage (Swift). MySQL Enterprise Backup 4.0 supports the Swift v1.0 API, and also the OpenStack Identity (Keystone) API v2.0 for authentication. Also supports authentication using Swift's TempAuth system.

  • --cloud-trace

    Print trace information for cloud operations. It works independently of --trace, which specifies the trace level for the non-cloud operations of mysqlbackup. Any non-zero value for the option enables the trace function.

    Default value is 0.

  • --cloud-proxy=proxy-url:port

    Proxy address and port number for overriding the environment's default proxy settings for accessing a cloud storage service.

    Note

    The list-image operation can be performed on a cloud backup only if the cloud proxy supports HTTP range headers.

  • --cloud-ca-info=PATH

    (For release 4.0.1 and later) Absolute path to the CA bundle file for host authentication for SSL connections. When the option is specified, the usage of the CA bundle file is preferred over the usage of individual .pem files for host authentication. .

  • --cloud-ca-path=PATH

    (For release 4.0.1 and later) CA certificate directory, in addition to the system's default folder.

  • Options used only for Amazon S3 (using them when the argument for --cloud-service is anything other than s3 will cause mysqlbackup to throw an error):

    • --cloud-bucket=S3_BUCKET

      The storage bucket on Amazon S3 for the backup image.

      In order to perform cloud backups and restores with the bucket, the user identified by the --cloud-access-key-id option must have at least the following permissions on the bucket:

      • s3:ListBucket: For listing information on items in the bucket.

      • s3:ListBucketMultipartUploads: For listing multipart uploads in progress to the bucket.

      • s3:GetObject: For retrieving objects from the bucket.

      • s3:PutObject: For adding objects to the bucket.

    • --cloud-object-key=S3_OBJECT_KEY

      The Amazon S3 object key for the backup image.

    • --cloud-access-key-id=S3_KEY-ID

      AWS access key ID for logging onto Amazon S3.

    • --cloud-secret-access-key=S3_ACCESS-KEY

      AWS secret access key for the AWS access key id specified with --cloud-access-key-id.

    • --cloud-aws-region=S3_REGION

      Region for Amazon Web Services that mysqlbackup accesses for S3.

  • Options used only for OpenStack Swift (using them when the argument for --cloud-service is anything other than openstack will cause mysqlbackup to throw an error):

    • --cloud-container=SWIFT_CONTAINER

      The Swift container for the backup image.

    • --cloud-object=SWIFT_OBJECT

      The Swift object for the backup image. Note that names of objects in a container have to be unique.

    • --cloud-user-id=SWIFT_OR_KEYSTONE_USER

      User ID for accessing Swift. The user credentials are authenticated using the Swift TempAuth identity system when the --cloud-tempauth-url option is used and by the OpenStack Keystone identity service when the --cloud-identity-url option is used.

    • --cloud-password=SWIFT_OR_KEYSTONE_PASSWORD

      Password for the user specified by --cloud-user-id. The user credentials are authenticated using the Swift TempAuth identity system when the --cloud-tempauth-url option is used and by the OpenStack Keystone identity service when the --cloud-identity-url option is used.

    • --cloud-tempauth-url=SWIFT_TEMPAUTH-URL

      The TempAuth URL for authenticating user credentials. Either this option or --cloud-identity-url (but not both) should be used when accessing a Swift service.

    • --cloud-identity-url=SWIFT_KEYSTONE-URL

      The URL of the Keystone identity service, when it is used for authenticating user credentials. Either this option or --cloud-tempauth-url (but not both) should be used when accessing a Swift service.

    • --cloud-tenant=SWIFT_KEYSTONE-TENANT

      The Keystone tenant for the user specified by --cloud-user-id, when the Keystone identity service is used for authenticating user credentials.

    • --cloud-region=SWIFT_KEYSTONE-REGION

      The Keystone region for the user specified by --cloud-user-id, when the Keystone identity service is used for authenticating user credentials.


User Comments
Sign Up Login You must be logged in to post a comment.