Description

How to use the Backup Exec S3 Private Cloud Connector
 
The Backup Exec S3 Private Cloud Connector:

• Allows customers to target backups to S3 Compatible private cloud storage servers
• Prior versions only supported backups to public cloud providers such as Amazon and Google
• Allows Backup Exec to add support for Amazon S3 Compatible storage system vendors

 
Backup Exec utilizes two encrypted files:

• CloudProvider.xml – contains configuration information about supported cloud providers
• CloudInstance.xml - contains cloud instance list and connection information, updated using BEMCLI

To connect Backup Exec storage to a private cloud:

1. Private Cloud Storage server device environment must be configured.

1. Private Cloud Storage server account configured for BE use:

2. Storage bucket configured on storage server that meets BE naming requirements:

• Bucket names can contain lowercase letters, numbers, and dashes
• Bucket names cannot begin with a dash

2. Run the New-BECloudInstance BEMCLI command to update CloudInstance.xml with connection information.
3. Configure a Storage Device in BE Console.

For more information on supported private cloud storage providers, refer to the Backup Exec Hardware Compatibility List.
Backup Exec Compatibility List Home Page

Backup Exec Server Connection Requirements

• Certificate Authority (CA) signed certificates on media server if SSL‑mode is used for backups
• Backup Exec server must be able to ping and resolve the Private Cloud storage server
• Backup Exec server time must be synchronized with Private Cloud storage server time
• Sharing Private Cloud Storage devices in CAS/MBES environment is not supported

 
BEMCLI Commands for updating CloudInstance.xml:
 

 
Command:  New-BECloudInstance
 
Creates and configures a new cloud instance in Backup Exec.
 
Syntax:
New-BECloudInstance [-Name] [] [-Provider] [] [‑ServiceHost] [] [-SslMode] {Disabled | AuthenticationOnly | Full} [-HttpsPort []] [-Endpoint []] [-HttpPort []] [‑UrlStyle {Unknown | Virtual | Path}] [-Confirm []] [‑WhatIf []] []
 
Example:
New-BECloudInstance -Name "cloudinstance001" -Provider "cloudian" -ServiceHost "s3.cloudian.com" -HttpPort "80" -HttpsPort "443" -SslMode "Disabled" –UrlStyle "Path"
 
Mandatory Parameters:

• Name: Name of the new cloud instance. Cloud instance name should match BE naming requirement.
  • Instance names can contain letters, numbers, and dashes (or hyphens).
  • Instance names cannot begin with a dash (or a hypen).

• Provider: Specifies the provider of the cloud instance. Only private cloud provider name can be specified.
• ServiceHost: Specifies the service host of the cloud instance. ServiceHost should be unique for each cloud instance that is created on the server.
• SslMode:  Specifies the SSL mode that Backup Exec will use for communication with the cloud storage server. The valid values are:

• Disabled – Do not use ssl.
• AuthenticationOnly – use ssl for authentication only.
• Full – use ssl for authentication and data transfer also.

 
Optional Parameters:

• UrlStyle - Specifies the URL style of the cloud instance.

• Unknown – do not set any value. Will default to Path.
• Virtual - In a virtual-hosted–style URL, the bucket name is part of the domain name in the URL. For example: https://bucket.s3.amazonaws.com

• Path - In a path-style URL, the bucket name is not part of the domain (unless you use a region-specific endpoint). For example: US East (N. Virginia) region endpoint, https://s3.amazonaws.com/bucket.  

• HttpPort - Specifies the http port of the cloud instance. Default port is 80.
• HttpsPort - Specifies the https port of the cloud instance. Default port is 443.
• Endpoint – specifies the service endpoint.

 
Examples:
 
New-BECloudInstance -Name "cloudinstance001" -Provider "cloudian" -ServiceHost "s3.cloudian.com" -HttpPort "80" -HttpsPort "443" –SslMode “Disabled” –UrlStyle “Path”
 
Above example command creates a cloud instance with name CloudInstance001 of type cloudian pointing to service host s3.cloudian.com. To access the bucket, uses Path style url and ssl mode is set as disabled. Http and https port are configured as 80 and 443.
 
New-BECloudInstance -Name "cloudinstance002" -Provider "cloudian" -ServiceHost "s3.my-cloudian.com"–SslMode “AuthenticationOnly” –UrlStyle “Path”
 
Above example command creates a cloud instance with name CloudInstance002 of type cloudian pointing to service host s3.my-cloudian.com. To access the bucket, uses Path style URL and ssl mode is set as AuthenticationOnly. Http and https port are not configured hence use default port number that is 80 and 443 respectively.

In context with the earlier example, change the Provider based on your private cloud storage server.
For more information on supported private cloud storage providers, refer to the Backup Exec Hardware Compatibility List.
Backup Exec Compatibility List Home Page
 
Command:  Get-BECloudInstance
 
Gets all of the custom (private) cloud instances configured in Backup Exec. Without parameters, Get-BECloudInstance gets all of the private cloud instances configured in Backup Exec. You can also specify a private cloud instance by instance name or pass a private cloud instance object through the pipeline to Get-BECloudInstance.
 
Parameters (Optional):

• Name: Specifies one or more cloud instances by cloud instance name (wildcards accepted).
• Id: Specifies one or more cloud instances by cloud instance ID (Guid). To specify multiple IDs, use commas to separate the IDs.

 
Example 1
C:\PS> Get-BECloudInstance
This command gets all of the private cloud instances.
 
Example 2
C:\PS> Get-BECloudInstance -Name "cloudinstance0001"
This command gets the private cloud instance named "cloudinstance0001".
 
Example 3
C:\PS> Get-BECloudInstance -Name "*cloudInstance*"
 
Command:  Set-BECloudInstance
 
Sets the properties for a Backup Exec cloud instance. You can modify all the settings, except the name and provider of an existing cloud instance.
 
Syntax
Set-BECloudInstance -InputObject [<becloudinstance[]>] [-Endpoint []] [-HttpsPort []] [-SslMode {Disabled | AuthenticationOnly | Full}] [-ServiceHost []] [-HttpPort []] [-UrlStyle {Unknown | Virtual | Path}] [-Confirm []] [-WhatIf []] []
 
Example:
C:\PS> Get-BECloudInstance "cloudinstance001" | Set-BECloudInstance -ServiceHost "s3.cloudian1.com"
These commands change the service host property of cloud instance named "CloudInstance001" to "s3.cloudian1.com".
 
Note:  You cannot update cloud instance to point to service host which is actually being attached to other cloud instance on the same Backup Exec Server.
 
For more information on supported private cloud storage providers, refer to the Backup Exec Hardware Compatibility List.
Backup Exec Compatibility List Home Page

Command:  Remove-BECloudInstance
 
Removes a cloud instance configured in Backup Exec. The cloud instance would be deleted only if there is no private cloud storage attached to the cloud instance.  If a user wants to delete the cloud instance, they must delete the private cloud storage devices associated with the cloud instance first and then delete the cloud instance.
 
Syntax
Remove-BECloudInstance -InputObject [<becloudinstance[]>] [-PassThru []] [-Confirm []] [-WhatIf []] []
 
Example
 
C:\PS> Get-BECloudInstance "cloudinstance001" | Remove-BECloudInstance
 
Note:  When you use the PassThru parameter, Remove-BECloudInstance returns an object that represents the cloud instance that was removed. Otherwise, this cmdlet does not generate any output.

Error Messages when Configuring a Cloud Instance
 

</becloudinstance[]></becloudinstance[]>

How to use the Backup Exec S3 Private Cloud Connector