Drive Command Line Interface

CloudBerry Lab presents enhanced CloudBerry Drive – application for Windows which allows mounting cloud storage as a local drive. Now CloudBerry Drive can be installed and configured via the Windows Command Line interface.

How to Install CloudBerry Drive Using Windows Command Line

To perform actions listed in this paragraph properly you need to start the command line interface with "Run as administrator" option.

1. Click on the Windows "Start" button.

2. Type cmd.exe in the search line to run the Windows console, press "Enter".

3. Change your current folder to the folder with CloudBerry Drive installation file.

4. Run installation by typing the following command:

CloudBerryDriveSetup_v[build_version].exe /S

Note: file name depends on your version of CloudBerry Drive.

How to Activate CloudBerry Drive using Command Line

1. Click on the Windows "Start" button.

2. Type cmd.exe in the search line to run the Windows console, press "Enter".

3. Change your current folder to the folder with CloudBerry Drive installation file.

cd "C:\Program Files\CloudBerryLab\CloudBerry Drive"

Online Activation or Request Trial

1. Activate license. (Email & key are required):

cbd.exe /activatelicense -k "license_key" -e "email"

(where "email" is your personal email and "license_key" is your license key that you received when buying the product).

2. Request trial license. (Email & key are required):

cbd.exe /activatelicense -e "email" -t

Offline Activation

If you don't have an ability to activate CloudBerry Backup online you can use offline activation.

1. Generate offline license request using your email and license key:

cbd.exe /activatelicense -k "license_key" -e "email" -or

(where "email" is your personal email and "license_key" is your license key that you received when buying the product).

As an output you will get a service key.

2. Send the service key to support@cloudberrylab.com. You will receive the activation key by email.

3. Activate license key

cbd.exe /activatelicense -k "license_key" -e "email" -oa "activationkey_received"

For time limited license you need to specify -expire parameter with the date you received by email:

cbd.exe /activatelicense -k "license_key" -e "email" -oa "activationkey_received" -expire "YYYY-MM-DD"

4. The product is activated.

Release license (releaseLicense):

cbd.exe /releaseLicense

To release license in a silent mode, run the following command:

cbd.exe /silent /releaselicense

How to Register a Storage Account with CloudBerry Drive

To perform actions listed in this paragraph properly you need to start the command line interface under local user account.

1. Click on the Windows "Start" button.

2. Type cmd.exe in the search line to run the Windows console, press "Enter".

3. Change your current folder to the CloudBerry Drive installation folder. Type:

cd "C:\Program Files\CloudBerryLab\CloudBerry Drive"

4. To register an Amazon S3 account, type:

cbd.exe addAccount -d account_display_name -st S3 -ac accesskey -sk secretkey -ssl yes/no

To register an S3-like cloud storage account, type:

cbd.exe addAccount -d account_display_name -st storageType -ac accesskey -sk secretkey -sp servicePoint -ssl yes/no

To register an OpenStack-based cloud storage account, type:

cbd.exe addAccount -d account_display_name -st storageType -ac username -sk apikey -as servicePoint -ssl yes/no

To register a Windows Azure account, type:

cbd.exe addAccount -d account_display_name -st Azure -ac account -sk sharedkey -ssl yes/no

To register a Google Cloud Storage account, type:

cbd.exe addAccount -d account_display_name -st Google -ac accesskey -sk secretkey -ssl yes/no

IMPORTANT:

Parameter "-d" can be any of your choice.

Parameter "-st" can be one of the following: S3, Azure, Google, Scality, Dunkel, Tiscali, HostEurope, DreamObjects, Seeweb, Connectria, Walrus, Mezeo, OpenStack, RackSpace, Clodo, HPCloud, Haylix, GreenQloud.

Parameter "-ac" is for accessKey, account, queryID or userName depending on a storage you are registering. "Access Key" for Amazon S3 storage; "Account" for Azure storage; "Query ID" for Walrus storage; "User Name" for OpenStack, Rackspace, Clodo and HPCloud storage.

Parameter "-sk" is for secretKey, sharedKey or apiKey depending on a storage you are registering. "Secret Key" for Amazon S3 storage; "Shared key" for Azure storage; or "Api Key" for OpenStack, Rackspace, Clodo or HPCloud storage.

Parameter "-sp" is for service point for AmazonS3-like storage accounts.

Parameter "-as" is for authentication service for OpenStack-based cloud storage accounts.

Parameter "-ssl" enables or disables SSL. By default SSL is set to "no".

Note: You can learn more about parameters for "addAccount" by entering the following command: cbd.exe addAccount -?

How to Edit or Delete a Storage Account with CloudBerry Drive

To perform actions listed in this paragraph properly you need to start the command line interface under local user account.

1. Click on the Windows "Start" button.

2. Type cmd.exe in the search line to run the Windows console, press "Enter".

3. Change your current folder to the CloudBerry Drive installation folder. Type:

cd "C:\Program Files\CloudBerryLab\CloudBerry Drive"

4.To delete an account, type:

cbd.exe deleteAccount accountName

Note: you can delete multiple accounts with one command. To do this type names of accounts you want to delete separated with commas.

4. To edit an Amazon S3 account, type:

cbd.exe editAccount -d account_display_name -n new_display_name -st S3 -ac accesskey -sk secretkey -ssl yes/no

To edit an S3-like cloud storage account, type:

cbd.exe editAccount -d account_display_name -n new_display_name -st storageType -ac accesskey -sk secretkey -sp servicePoint -ssl yes/no

To edit an OpenStack-based cloud storage account, type:

cbd.exe editAccount -d account_display_name -n new_display_name -st storageType -ac username -sk apikey -as servicePoint -ssl yes/no

To edit a Windows Azure account, type:

cbd.exe editAccount -d account_display_name -n new_display_name -st Azure -ac account -sk sharedkey -ssl yes/no

To edit a Google Cloud Storage account, type:

cbd.exe editAccount -d account_display_name -n new_display_name -st Google -ac accesskey -sk secretkey -ssl yes/no

Examples:

To change a display name of your account, type:

cbd.exe editAccount -d CurrentName -n NewName

To turn on SSL, type:

cbd.exe editAccount -d CurrentName -ssl yes

IMPORTANT:

Parameter "-d" can be any of your choice.

Parameter "-st" can be one of the following: S3, Azure, Google, Scality, Dunkel, Tiscali, HostEurope, DreamObjects, Seeweb, Connectria, Walrus, Mezeo, OpenStack, RackSpace, Clodo, HPCloud, Haylix, GreenQloud.

Parameter "-ac" is for accessKey, account, queryID or userName depending on a storage you are registering. "Access Key" for Amazon S3 storage; "Account" for Azure storage; "Query ID" for Walrus storage; "User Name" for OpenStack, Rackspace, Clodo and HPCloud storage.

Parameter "-sk" is for secretKey, sharedKey or apiKey depending on a storage you are registering. "Secret Key" for Amazon S3 storage; "Shared key" for Azure storage; or "Api Key" for OpenStack, Rackspace, Clodo or HPCloud storage.

Parameter "-sp" is for service point for AmazonS3-like storage accounts.

Parameter "-as" is for authentication service for OpenStack-based cloud storage accounts.

Parameter "-ssl" enables or disables SSL. By default SSL is set to "no".

Parameter "-n" is for new display name.

Note: You can learn more about parameters for "deleteAccount" or "editAccount" by entering: cbd.exe deleteAccount -? or cbd.exe editAccount -?.

How to Create a Mapped Drive with CloudBerry Drive

To perform actions listed in this paragraph properly you need to start the command line interface under local user account.

1. Click on the Windows "Start" button.

2. Type cmd.exe in the search line to run the Windows console, press "Enter".

3. Change your current folder to the CloudBerry Drive installation folder. Type:

cd "C:\Program Files\CloudBerryLab\CloudBerry Drive"

4. Type:

cbd.exe addDrive -d DriveLetter -an AccountName -path container/folder -label VolumeLabel

5.To mount a mapped drive, type:

cbd.exe mountDrive DriveLetter

IMPORTANT:

Parameter "-d" is for any drive letter you prefer.

Parameter "-an" is for the name of your registered cloud storage account.

Parameter "-path" is for path to your data container - bucket/folder/subfolder. You can specify the path using slash.

Parameter "-label" is for a mapped drive label. Specify any of your choice.

Parameter "-as" specifies whether to mount drive as a removable disk or as a network mapped drive. By default drive is mounted as a network mapped drive. Possible values: removable, network.

Parameter "-ss" specifies if to mount drive at system startup. By default drive is mounted on a startup. Possible values: yes, no.

Parameter "-ro" specifies if to mount drive for read-only access. Possible values: yes, no. Default setting is no.

Parameter "-rrs" specifies if to use Reduced Redundancy Storage for Amazon S3 accounts. Possible values: yes, no. Default setting is no.

Parameter "-sse" specifies if to use Server Side Encryption. Possible values: yes, no. Default setting is no.

Note: You can learn more about parameters for "addDrive" by entering the following command: cbd.exe addDrive -?

Example:

cbd.exe addAccount -d mys3 -st S3 -ac XXXXXXXXXXXXXXXXXXXX -sk XXXxxXXXXXXXxxXXXXXXxXXXXXXxxxXXXXXXXX

cbd.exe proxysettings -type auto

cbd.exe editAccount -d mys3 -ssl yes

cbd.exe addDrive -d Z -an mys3 -path mybucket/reports -label myreports -rrs yes

cbd.exe mountDrive Z

How to Start CloudBerry Drive Service Using Windows Command Line

To perform actions listed in this paragraph properly you need to start the command line interface with "Run as administrator" option.

1. Click on the Windows "Start" button.

2. Type cmd.exe in the search line to run the Windows console, press "Enter".

3. Change your current folder to the CloudBerry Drive installation folder. Type:

cbd.exe /startservice

Now if you have done everything correctly you shall be able to use your cloud storage account as a mapped drive.

Additional Commands

CloudBerry Drive has additional CLI commands that allow controlling CloudBerry Drive service via the Windows Command Line. Using these commands you can stop activity of CloudBerry Drive, restart the service, mount and unmount mapped drive.

To stop CloudBerry Drive service, type:

cbd.exe /stopservice

To restart CloudBerry Drive service, type:

cbd.exe /restartservice

To unmount drive, type:

cbd.exe unmountDrive DriveLetter

Note: Replace "DriveLetter" with the letter of your mounted drive (e.g. Z or G)