Adding a New MediaAgent to a Cloud Storage Device

You can use the XML to add a new MediaAgent to a cloud storage device.

Download the add_cloud_device_controller.xml file and save it on the computer where the command is run.
Open the XML file.
Change the XML parameters.

Attribute	Description
mediaAgentName	The name of the new MediaAgent.
deviceName	The name of the cloud storage device.
baseFolder	This is an optional attribute. You can specify the name of the base folder or else standard naming convention will be used to name the base folder.
deviceAccessType	Access type Value Read 4 Read and Write 6 Read and Write, Preferred Access 14

For more information on the specific parameters required by each vendor, see Vendor Specific XML Parameters.

Example: Use this example XML file to add a new MediaAgent with name "MA1" to a Google device with name "Device1", bucket "examplebucket", device type "19", device access type "Read and Write, Preferred Access", Access Key ID "AKIAIOSFODNN7EXAMPLE" and Secret Access Key "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY".

Run the following command from the <software installation directory>\Base folder to execute the xml.
```
qoperation execute –af add_cloud_device_controller.xml
```

Adding a Mount Path to the Cloud Library

You can use the following methods to add a mount path to the cloud device.

By Using Cloud Storage Account Credentials

You can use the credentials of cloud storage account to add a mount path to a cloud storage library.

Complete the following steps:

Download the add_cloud_mp_account.xml file and save it on the computer where the command is run.
Open the XML file.

Change the XML parameters.

Attribute	Description
mediaAgentName	The name of the MediaAgent.
libraryName	The name of the new cloud library.
credentialName	The name of the credential that you created using the Credential Manager. If you enter the credential name, then: Update the loginName parameter in the format of "<vendorURL>//__CVCRED__". For example, "s3.amazonaws.com//__CVCRED__". Update a dummy value for the password parameter.

Attribute

Description

mediaAgentName

The name of the MediaAgent.

libraryName

The name of the new cloud library.

credentialName

The name of the credential that you created using the Credential Manager. If you enter the credential name, then:

Update the loginName parameter in the format of "<vendorURL>//__CVCRED__". For example, "s3.amazonaws.com//__CVCRED__".
Update a dummy value for the password parameter.

For more information on the specific parameters required by each vendor, see Vendor Specific XML Parameters.

Example:

Use this example XML file to add a mount path to an Amazon S3 cloud library with name "Library1", MediaAgent name "MA1", bucket "examplebucket", server type "2", Access Key ID "AKIAIOSFODNN7EXAMPLE" and Secret Access Key "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY".
Use this example XML file to add a mount path to an Amazon S3 cloud library with name "Library1", MediaAgent name "MA1", bucket "examplebucket", server type "2", and credential name "AmazonS3".

Run the following command from the <software installation directory>\Base folder to execute the xml.
```
qoperation execute –af add_cloud_mp_account.xml
```

By Using Device ID

You can use the device ID to share a mount path with one or more MediaAgents.

Complete the following steps:

Create the cloud library using Config-CloudLib.xml file.

Note the libraryId in the response.
To get the mount path ID of the mount path that you want to share, complete following steps:
1. Download the GetLibraryDetails.xml file and save it on the computer where the command is run.
2. Run the following command from the <software installation directory>\Base folder.
```
qoperation execute -af d:\Xmls\GetLibraryDetails.xml -libraryId 2
```
  where libraryId is the library ID that you noted in the previous step and 2 is an example library ID.
3. Note the mountPathId in the response.
To get the device ID, complete following steps:
1. Download the GetMountpathInfo.xml file and save it on the computer where the command is run.
2. Run the following command from the <software installation directory>\Base folder.
```
qoperation execute -af d:\Xmls\GetMountpathInfo.xml -mountPathId 59
```
  where mountPathId is the mount path ID that you noted in earlier step and 59 is an example mount path ID.
3. Note the deviceId in the response.
Share the mount path with one or more MediaAgents.
1. Download the ShareMountpath.xml file and save it on the computer where the command is run.
2. To share the mount path with one MediaAgent, do the following:
  1. Run the following command from the <software installation directory>\Base folder.
```
qoperation execute -af d:\Xmls\ShareMountpath.xml -mountpathId 59 -deviceId 64 -mediaAgent/id 4
```
    where
  2. mountPathId is the mount path ID that you noted in an earlier step and 59 is an example mount path ID.
  3. deviceID is the device ID that you noted in earlier step and 64 is an example device ID.
  4. mediaAgent/id is the ID of the MediaAgent you want to share the mount path with.
3. To share the mount path with multiple MediaAgents, do the following:
  1. In the downloaded file, copy the infoList tag and use it to add the IDs of the MediaAgents.
  2. Run the following command from the <software installation directory>\Base folder.
```
qoperation execute -af d:\Xmls\ShareMountpath.xml -mountpathId 59 -deviceId 64
```