MediaAgents - How To

Topics | How To | Troubleshoot | Support | Related Topics


Set the Maximum Number of Parallel Data Transfer Operations for a MediaAgent

Configure NDMP Properties

Enable (or Disable) a MediaAgent

View the MediaAgent Offline Reason

Optimize the MediaAgent for Concurrent LAN Backups

Mark MediaAgent/Library/Drive Offline for Maintenance

Enable Automatic Detection of WORM Media

Create a Network Share Profile

Configure a MediaAgent for Index Cache Sharing

Unshare a Shared Index Cache

Move an Index Cache

Move a Shared Index Cache

Set the Index Retention Criteria

View the Software Version

Release License for MediaAgent

Move a Library to Another MediaAgent Without Data Loss

Move a MediaAgent Without Data Loss

Separate the CommServe from a CommServe - MediaAgent Computer

Enable/Disable Robust Network Layer

Change Robust Network Layer Configuration

Scan a MediaAgent for Hardware Changes


Set the Maximum Number of Parallel Data Transfer Operations for a MediaAgent

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To set the maximum number of parallel data transfer operations for a MediaAgent:

  1. From the CommCell Browser, right-click the MediaAgent for which you wish to set the number of parallel data transfer operations, and then click Properties.
  2. Click the General tab.
  3. In the Maximum number of parallel data transfer operations area, set the number of streams in the Restrict To box.
  4. Click OK to save the configuration.

Configure NDMP Properties

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To configure the NDMP Remote Server properties:

  1. In the CommCell Browser, expand the MediaAgents icon, right-click a MediaAgent and select Properties.
  2. Click the NDMP Properties button from the General tab.
  3. In the NDMP Server Hostname field, enter the Hostname of the MediaAgent (this should already be populated by default.)
  4. Check Change Password, and in the NDMP Login and NDMP Password fields, enter the Administrator Account Name and Password for the MediaAgent computer.
  5. In the Listen Port field, enter the Port number specified during the install of the EMC CBRM software (we suggest 10002).
  6. Click the Detect button. A successful detection will populate the Vendor and Firmware Revision fields.
  7. Click OK to save the configuration.

Enable (or Disable) a MediaAgent

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To enable or disable a MediaAgent:

  1. From the CommCell Browser, click the MediaAgents icon. All the MediaAgents available in the CommCell are displayed on the right-pane of the CommCell Browser.
  2. Right-click the MediaAgent that you wish to enable or disable, and then click Properties.
  3. From the Control tab of MediaAgent Properties, select the Enable MediaAgent option to bring the MediaAgent online. Clear this option to take the MediaAgent offline.
  4. Click OK to save the configuration.

View the MediaAgent Offline Reason

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To view the status of a MediaAgent:

  1. From the CommCell Browser, click the MediaAgents icon. All the MediaAgents available in the CommCell are displayed on the right-pane of the CommCell Browser.
  2. Right-click the MediaAgent for which you wish to view the status, and then click Properties.
  3. The MediaAgent's online or offline status can be viewed from the In the Control tab of MediaAgent Properties dialog box.
  4. Note that if the Media is Offline the offline reason is also displayed.

Optimize the MediaAgent for Concurrent LAN Backups

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To optimize a MediaAgent for concurrent LAN backups:

  1. From the CommCell Browser, click the MediaAgents icon. All the MediaAgents available in the CommCell are displayed on the right-pane of the CommCell Browser.
  2. Right-click the MediaAgent that you wish to optimize for concurrent LAN backups and then click Properties.
  3. Click the Control tab.
  4. Click and choose the Optimize for concurrent LAN backups to enable the option. (Clear this option to disable.)
  5. Click OK to save the configuration.

    Subsequent data protection operations using the MediaAgent use the selected mechanism.


Enable (or Disable) Automatic Detection of WORM Media

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To enable or disable automatic detection of WORM media:

  1. From the CommCell Browser, click the MediaAgents icon. All the MediaAgents available in the CommCell are displayed on the right-pane of the CommCell Browser.
  2. Right-click the MediaAgent that you wish to enable (or disable) automatic detection of WORM media and then click Properties.
  3. Click the Control tab.
  4. Click and choose the Automatically detect WORM Tape Media option to enable automatic detection. (Clear the option to disable it.)
  5. Click OK to save the configuration.

Mark MediaAgent/Library/Drive Offline for Maintenance

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To mark MediaAgent/Library/Drive Offline for Maintenance:

  1. From the CommCell Browser, right-click the MediaAgent/Library/ Drive that you wish to mark offline for maintenance, and then click Properties.
  2. Select one or more of the following options as appropriate:
  3. Click OK to save the configuration.

    Subsequent data protection, data recovery and auxiliary copy operations will not use the associated MediaAgent/Library/Drive.


Create a Network Share Profile

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To create a network share profile for index cache sharing:

  1. From the CommCell Browser, right-click the CommServe, click Control Panel, and select Shared Catalog Configuration.

    Alternatively, from the CommCell Browser, right-click the MediaAgent, and click Configure.

  2. From the Shared catalog Configuration dialog box, click Add to create a Network Share Profile.
  3. Enter the name of the Profile to be created in Profile Name box.
  4. Select the type of index share:
  5. In the Profile Properties area, specify the following retention criteria for the shared index cache.
  6. Click OK to create the profile. You can use this profile on a MediaAgent to share the index cache.

Configure a MediaAgent for Index Cache Sharing

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To configure a MediaAgent for index cache sharing:

  1. From the CommCell Browser, right-click the MediaAgent you wish to share the index cache and click Properties.
  2. From the MediaAgent Properties window click the Catalog tab.
  3. Select Catalog Profile option to enable index cache sharing.
  4. To use a Network Share, click Network Share and select a Network Share profile from the list. All Network Share profiles created from the Shared Catalog Configuration window will be available for selection.

    Point your index cache to the network share location. 

    For Windows MediaAgents:

    For Unix MediaAgents:

  5. The index cache is shared.
  6. Now this index is available to be shared from other MediaAgents.

  7. Right-click another MediaAgent that will share the index and then click Properties.
  8. Click the the Catalog tab.
  9. Select Catalog Profile option to enable index cache sharing.
  1. To use a Network Share, click Network Share and select a Network Share profile from the list. All Network Share profiles created from the Shared Catalog Configuration window will be available for selection.

    Point your index cache to the network share location. 

    For Windows MediaAgents:

    For Unix MediaAgents:

  2. Repeat steps 8 -10 on all the MediaAgents that share the index cache.

Unshare a Shared Index Cache

Before You Begin

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To unshared a shared index cache:

  1. From the CommCell Browser, right-click the MediaAgent for which you wish to unshare the shared index cache and then click Properties.
  2. From the Catalog tab, uncheck the Catalog Profile option. The index cache is no longer shared.
  3. If you were using a Network Share, then you will have to provide a local path for the index cache. Perform one of the following:

    For Windows MediaAgents:

    For Unix MediaAgents:

  4. Click OK to save the configuration.

Move an Index Cache

Before You Begin

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To move an index cache:

  1. From the CommCell Browser, right-click the MediaAgent for which you wish to move the index cache and then click Properties.
  2. Click the Catalog tab.
  3. Provide details in the Index Cache area.

    For Windows MediaAgents:

    For Unix MediaAgents:

  4. Click OK to save the configuration.
  5. If the index is moved from a local drive to a network share, a Confirm prompt is displayed, asking you whether you wish to copy the index cache. Click one of the following:
  6. The index cache is moved to the new folder.

NOTES


Move a Shared Index Cache

Before You Begin

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To move a shared index cache:

  1. From the CommCell Browser, right-click any one of the MediaAgents that share the shared index cache and then click Properties.
  2. Click the Catalog tab.

    For Windows MediaAgents:

    For Unix MediaAgents:

  3. Click OK to save the configuration.
  4. Repeat the above steps on all the MediaAgents that share the index cache.  If this is not done, the index cache will be turned offline after 30 minutes, and all the jobs accessing the MediaAgents that share this index cache may fail as a result.

NOTES


Set the Index Retention Criteria for Network Share Profiles

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To establish the index retention criteria for network share profiles:

  1. From the CommCell Browser, click the MediaAgents icon. All the MediaAgents available in the CommCell are displayed on the right-pane of the CommCell Browser.
  2. Right-click the MediaAgent whose index cache parameters you wish to modify, and then click Properties.
  3. Click the Catalog tab of MediaAgent Properties dialog box.
  4. You can change the following retention parameters:
  5. Click OK to save the configuration.

View the Software Version

To view the Software Version:

  1. From the CommCell Browser, click the CommServe, Client, Agent, MediaAgent, or Enabler for which you wish to view the version, and then click Properties.
  2. Click the Version tab.

    The component version and post release service pack, additional updates and missing updates are displayed.


Release License for MediaAgent

Required Capabilities: Capabilities and Permitted Actions

Administrative Management capability cannot be used to release the license from the MediaAgent level.

Before you Begin:

To release license for client, MediaAgent, agent, or enabler:

  1. In the CommCell Browser, right-click the name of the MediaAgent you want to release license, and select Release license for Media Agent.
  2. A popup warning message appears.

    Click OK to continue.

  3. Another popup message then appears.

    Click Yes to continue with the deconfiguration or No to abort.

  4. If releasing a license is unsuccessful, a number of popup messages appears. In some cases, the message requests that you take some corrective action.

    For example, the message might advise you to ensure that there are no jobs running on the agent.

    In such case, click OK and take the appropriate action. Then repeat the process.

If releasing a license is successful, the tree element is dimmed and available for deletion.


Move a Library to Another MediaAgent Without Data Loss

In some situations you may have the need to move a library from one MediaAgent to another due to re-configuration or other requirements.

The following procedure provides step-by-step instructions on how to perform this operation.

  1. Detach the library and attach it to the new MediaAgent and make sure that the hardware is visible to the operating system. See Driver Configurations for more information.
  2. Open the CommCell Console and change the name of the MediaAgent associated with the library. See Change the MediaAgent (Host) Associated with a Library for more information.
  3. If necessary run a quick backup to verify that the devices are functioning correctly.

Move a MediaAgent Without Data Loss

In some situations you may have the need to move a MediaAgent from one computer to another. For example:

The following procedure provides step-by-step instructions on how to perform this operation.

  1. Detach the library and attach it to the new computer and make sure that the hardware is visible to the operating system. See Driver Configurations for more information.
  2. Install the MediaAgent software in the new computer. See MediaAgent Deployment for more information.
  3. Open the CommCell Console and change the name of the MediaAgent associated with the library that was configured in the old MediaAgent. See Changing the MediaAgent (Host) Associated with a Library for more information.
  4. If the index cache is configured in the old MediaAgent, move the index cache to the new MediaAgent. (See Move an Index Cache for step-by-step instructions.)
  5. If necessary run a quick backup to verify that the devices are functioning correctly.
  6. Uninstall the MediaAgent software from the original computer. See Uninstall Components for more information.
    WARNING

    Do not deconfigure the library at any point.

    Also do not uninstall the old MediaAgent until the devices start functioning in the new MediaAgent.


Separate the CommServe from a CommServe-MediaAgent Computer

In some situations you may want to separate the CommServe from a MediaAgent computer, (with or without a File system iDataAgent) if they were installed together. For example, you may want to move the CommServe to a more powerful computer or such similar re-configuration needs.

The following procedure provides step-by-step instructions on how to perform this operation.

You can also use this procedure to relocate a CommServe and MediaAgent which are installed together, to two separate computers.

You will require an additional MediaAgent license to perform this operation.

Source Computer

1. Copy the index cache folder (and the job results folder if the (File system iDataAgent is installed) to another location.  
2. Perform a Disaster Recover Backup.

Verify and ensure that the Disaster Recovery Backup completes successfully. Also note down the location of the disaster recovery backup file. (For a more detailed discussion, see Phases of Disaster Recovery Backups.)

See  Starting a Disaster Recovery Backup for step-by-step instructions.
3. Uninstall the software from the original computer. See Uninstalling Components for more information.
WARNING

Do not deconfigure the libraries (tape/optical/disk libraries, etc.) when you uninstall the MediaAgent software.

Establishing the New CommServe Computer

4. Install only the CommServe software in the new computer. See CommServe Deployment for information on installing the CommServe software.
5. Restore the CommServe database using the CommServe Disaster Recovery Tool. See Restore a Disaster Recovery Backup for step-by-step instructions.
6. Change the name of the CommServe computer using the CommServe Disaster Recovery Tool. See Change the Name of the CommServe Computer for step-by-step instructions.
7. Inform the Client and MediaAgent computers of the new CommServe name. This can be done from the CommCell Console. See Informing Clients of CommServe Name Change for step-by-step instructions.

Establishing the New MediaAgent Computer

8. Install only the MediaAgent software in the old computer.

(You can also relocate the MediaAgent to another computer, if necessary.)

See MediaAgent Deployment for more information.
9. During MediaAgent installation make sure to specify the index cache to the location in which it was copied in step 1. If you are unable to do so, perform the steps described in Manually Relocate the Index Cache.
10. Open the CommCell Console and change the MediaAgent name associated with the library. See Changing the MediaAgent (Host) Associated with a Library for step-by-step instructions.
  If you have a disk library, make sure that the mount path is pointing to the appropriate location. If necessary move the mount path to the appropriate location and then change the location of the mount path. See Move a Mount Path for step-by-step instructions.
11. Deconfigure the original MediaAgent from the CommCell Console. See Deconfigure a Client, MediaAgent, Agent, or Enabler for step-by-step instructions.

Establishing the File System iDataAgent in the MediaAgent Computer (if it was originally installed)

12. Export the metadata records associated only with this client on the CommServe. See Export Data from the Source CommCell for step-by-step instructions.
13. Deconfigure the Client from the CommCell Console. See Deconfigure a Client, MediaAgent, Agent, or Enabler for step-by-step instructions.
14. Delete the Client in the CommCell Console. See Delete a Client Computer for step-by-step instructions.
15. Import the metadata records (that was exported in step 12) associated with the client computer in the CommServe. See Import Data on the Destination CommCell for step-by-step instructions.
16. Reinstall the file system iDataAgent on the computer. See Deployment - Windows File System iDataAgent for more information.

Enable/Disable Robust Network Layer

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To enable or disable the Robust Network Layer feature:

  1. From the CommCell Console, right click on a client, and select Properties from the pop-up menu. Select the Client Computer Properties (Advanced) tab.

    Alternatively, right click on a MediaAgent and select Properties from the pop-up menu. Select the MediaAgent Properties (Control) tab.

  2. Select the Enable retry on network errors option to enable the feature. Deselect it to disable the feature.
  3. Click OK.

Change Robust Network Layer Configuration

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To change the Robust Network Layer configuration:

  1. From the CommCell Console, right click on a client, and select Properties from the pop-up menu. Select the Client Computer Properties (Advanced) tab.

    Alternatively, right click on a MediaAgent and select Properties from the pop-up menu. Select the MediaAgent Properties (Control) tab.

  2. Select the Enable retry on network errors option to enable the feature. Deselect it to disable the feature. If enabled, you may configure the following:
  3. Click OK.

Scan a MediaAgent for Hardware Changes

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To scan the MediaAgent for hardware changes:

  1. From the CommCell Console, right click on a MediaAgent and select the Scan Hardware option.
  2. A device detection operation is performed on the CommCell computers registered to the MediaAgent, and the MediaAgent is updated with the latest hardware setup.

 

Back to Top