Disk Libraries - How To

Topics | Configure | How To | Troubleshoot | Related Topics


Shared Disk Libraries

View or Modify the Device Properties for Disk Libraries with Static Mount Paths

View or Modify the Properties of Disk Devices in a Shared Mount Path

Modify the Access Information for a Shared Disk

Deconfigure a Shared Disk Device

Configure Multiple MediaAgents for a Static Shared Disk Device

Deconfigure Multiple MediaAgents for a Shared Disk Device

Disk Libraries on Replicated Disks

View the Device Paths associated with the Mount Path - See View or Modify the Properties of Disk Devices in a Shared Mount Path

Change the Access Type (Read / Write) for a Mount Path - See View or Modify the Properties of Disk Devices in a Shared Mount Path

Common - Administering Disk Libraries

Establish the Low Watermark for a Disk Library

Configuring a Low Disk Space Alert

Configure the Size of Disk Volumes

Modify the Mount and Unmount Timeouts for Disk Libraries

Create Read-Only Archive Files on filers

Enable Single Instancing of Data on a Disk Library

Enable or Disable the Disk Library

View the Disk Library Offline Reason

Establish the Mount Path Allocation Policy for a Disk Library

Establish the Mount Path Usage for a Disk Library

Enable Managed Disk Space for Disk Data

View a List of Storage Policies Accessing the Disk Library

Migrate a Disk Library

Deconfigure a Disk Library

Common - Administering Mount Paths

Add or Modify a Mount Path

Add Automated Mount Path Detection

Enable Unbuffered I/O on a Mount Path

Enable or Disable a Mount Path

View the Mount Path Offline Reason

Establish Maximum Space Allocation on a Mount Path

Reduce Data Fragmentation on a Mount Path

Perform Fragmentation Analysis

View the Contents of a Mount Path

Delete the Contents of a Mount Path

Prevent Accidentally Deleting Mount Path Contents

Move a Mount Path

Retire a Mount Path

Delete a Mount Path


View or Modify the Device Properties for Disk Libraries with Static Mount Paths

To modify the device properties for disk libraries with static mount paths:

  1. From the CommCell Browser, right-click a mount path for which you wish to view the modify the properties, and then click Properties.
  2. If necessary you can:
  3. Click OK to save the changes.

View or Modify the Device Properties for Disk Libraries with Static Mount Paths

To modify the device properties for disk libraries with static mount paths:

  1. From the CommCell Browser, right-click a mount path for which you wish to view the modify the properties, and then click Properties.
  2. If necessary you can:
  3. Click OK to save the changes.

View or Modify the Properties of Disk Devices in a Shared Mount Path

To view or modify the properties of Disk Devices in a shared mount path:

  1. From the CommCell Browser, right-click a mount path for which you wish to view the MediaAgents, and then click Properties.
  2. Click the Device Paths tab of the Mount Path Properties dialog box.

    You can change the Maximum number of writers by clicking the Edit button.

    You can enable or disable the MediaAgent's access to the device by selecting or clearing the enabled button.

    On mount paths associated with replicated disks, you can modify the read-write access to the mount path. This should not be done for Disk Libraries on Replicated Disks used for the Disk Library Replication solution.


Modify the Access Information for a Shared Disk

Modify the Access Path for all MediaAgents Sharing the Device (Supported for Windows MediaAgents)

  1. Display the Library and Drive Configuration window.
  2. Click the Shared Disk Device tab.
  3. Right-click the Device that you want to modify and then click Set Network Access Info for all Windows MediaAgents.
  4. Make the necessary changes in the Sharing Folder Properties dialog box and click OK to save the changes.

Modify the Access Path for the Individual MediaAgents

  1. Display the Library and Drive Configuration window.
  2. Click the Shared Disk Device tab.
  3. Locate the device and then navigate to the individual folder.
  4. Right-click the Folder and then click Properties.
  5. Make the necessary changes in the Sharing Folder Properties dialog box and click OK to save the changes.
  6. Repeat steps 4 and 5 for all the folders (MediaAgents) sharing the device.

Modify the Access Type for Shared Disk Device

On mount paths associated with replicated disks, you can modify the read-write access to the mount path. This should not be done for Disk Libraries on Replicated Disks used for the Disk Library Replication solution.

Use the following steps to modify the access type for a Shared Disk Device:

  1. From the CommCell Console, click the Tools menu and then click Control Panel.
  2. From the Control Panel, double-click the Library & Drive Configuration.
  3. From the Select MediaAgents dialog box, perform the following:
  4. Click OK.
  5. From the Library and Drive Configuration window, click the Shared Disk Device tab.
  6. Locate the Device and then navigate to the individual folder.
  7. Right-click the <Mount Path> and then click Properties.
  8. Click OK to save the changes.

Deconfigure a Shared Disk Device

Before you Begin

To deconfigure a shared disk device::

  1. Display the Library and Drive Configuration window.
  2. Click the Shared Disk Device tab.
  3. Right-click the disk device that you wish to deconfigure, and then click Deconfigure.
  4. Click Yes in the Confirm Deconfigure prompt.

The device is deconfigured.

NOTES


Configure Multiple MediaAgents for a Static Shared Disk Device

Use the following steps to configure multiple MediaAgents for a Shared Disk Device:

  1. From the CommCell Console, click the Tools menu and then click Control Panel.
  2. From the Control Panel, double-click the Library & Drive Configuration.
  3. From the Select MediaAgents dialog box, perform the following:
  4. Click OK.
  5. From the Library and Drive Configuration window, click the Shared Disk Device tab.
  6. Expand the Device to which you want to configure multiple MediaAgents.
  7. Right-click the <Mount Path> and then click Configure for All Selected MediaAgents.
     
    • For Windows, configure all MediaAgents when the mount path is configured as UNC path and all selected MediaAgents have access to this UNC path.
    • For Unix, ensure that the directory path to be mounted in the unconfigured MediaAgents has the same directory path as that of the configured MediaAgent.
  8. Click Yes.

The device is configured with the list of selected MediaAgents.


Deconfigure Multiple MediaAgents for a Shared Disk Device

Use the following steps to deconfigure multiple MediaAgents for a Shared Disk Device:

  1. From the CommCell Console, click the Tools menu and then click Control Panel.
  2. From the Control Panel, double-click the Library & Drive Configuration.
  3. From the Select MediaAgents dialog box, perform the following:
  4. Click OK.
  5. From the Library and Drive Configuration window, click the Shared Disk Device tab.
  6. Right-click the Device and then click Deconfigure for All Selected MediaAgents.
  7. Click Yes.

The device is deconfigured with the list of selected MediaAgents.


Establish the Low Watermark for a Disk Library

Related Topic

Modify the low watermark

Required Capability: Capabilities and Permitted Actions

To establish the low watermark for a disk library:

  1. From the CommCell Browser, right-click the disk library for which you wish to establish the low watermark, and then click Properties.
  2. In the Low Watermark box, type or select the minimum percentage of free space at which the low watermark warning should be generated.

    If the amount of free space, for all the combined mount paths, reaches or falls below the low watermark, the MediaAgent displays a message in the Event Viewer and sends an Alert, if configured.


Configuring a Low Disk Space Alert

Related Topics

Configure a Low Disk Space Alert

Alerts and Monitoring - How To

Required Capability: Capabilities and Permitted Actions

To configure a Low Disk Space Alert:

  1. From the Tools menu in the CommCell Console, click Control Panel.
  2. Double-click Media Management.

    The Media Management Configuration dialog box appears.

  3. On the Service Configuration tab, set the Number of days in advance to trigger alert for low disk space for disk library option to a value greater than 0.

    This value is the number of days that you want to be notified before the library runs out of disk space. For example, if you want to be notified five days before the library runs out of disk space, set the value to 5.

      If the value is set to 0, then the alert is generated when the low watermark is reached.
  4. Click OK.
  5. In the Control Panel, double-click Alerts.

    The Alerts dialog box appears.

  6. Click Add.

    The Add Alerts Wizard appears.

  7. Configure the alert according to your needs. As you configure the alert, make sure that the following options are set:
  8. Once you configure the alert completely, click Finish.
  9. Click OK.

Configure the Size of Disk Volumes

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To configure the size of disk volumes:

  1. From the Tools menu in the CommCell Console, click Control Panel.
  2. Double-click Media Management Configuration.
  3. Select Service Configuration tab.
  4. Modify the Disk volume physical size high watermark in GB parameter as required.
  5. Click OK to save the changes.

Modify the Mount and Unmount Timeouts for Disk Libraries

Related Topic

Required Capability: See Capabilities and Permitted Actions

To modify the mount and unmount timeouts for disk libraries:

  1. From the CommCell Browser, right-click the disk library for which you wish to change mount and unmount timeout periods, and then click Properties.
  2. In the Mount and Unmount box, type or select the timeout periods.
  3. Click OK to save the changes.

Create Read-Only Archive Files on Filers

Related Topic

Required Capability: Capabilities and Permitted Actions

To create read-only archive files in a disk library on filers:

  1. From the CommCell Browser, right-click the disk library for which you wish to create read-only archive files, and then click Properties.
  2. From the General tab of Library Properties, click the Mark Archive Files as Read-Only option.
  3. Click OK to save the changes.

NOTES


Enable Single Instancing of Data on a Disk Library

Related Topic

Required Capability: Capabilities and Permitted Actions

To enable single instancing of data on a disk library:

  1. From the CommCell Browser, right-click the disk library for which you wish to establish the single instancing of data, and then click Properties.
  2. Click the Mount Paths tab. Note that mount paths enabled with hardware single instancing must be less than 100 characters long. Otherwise hardware single instancing might not be employed successfully.
  3. Click the Disks within this library support hardware single instancing option.
  4. Click OK to save the information.

Enable or Disable the Disk Library

Required Capability: Capabilities and Permitted Actions

To enable or disable a disk library:

  1. From the CommCell Browser, right-click the disk library that you wish to enable or disable, and then click Properties.
  2. From the General tab of Library Properties, click the Enable Library option.
  3. Click OK to save the changes.

View the Disk Library Offline Reason

To view the offline reason for a disk library:

  1. From the CommCell Browser, right-click the disk library for which you wish to view the offline reason, and then click Properties.

    Information on the disk library offline reason is displayed in the Offline Reason box.


Establish the Mount Path Allocation Policy for a Disk Library

Related Topic

Required Capability: Capabilities and Permitted Actions

To establish the Mount Path Allocation Policy for a disk library:

  1. From the CommCell Browser, right-click the disk library for which you wish to establish the mount path allocation policy, and then click Properties.
  2. Click the Mount Paths tab.
  3. Click either the Maximum Allowed Writers option or the Allocate No. of Writers option and then select the maximum number of writers.
  4. Click OK to save the information.
  5. From the CommCell Browser, right-click the mount path within the disk library and then click Properties.
  6. Click the Allocation Policy tab.
  7. Click either the Maximum Allowed Writers option or the Allocate No. of Writers option and then select the maximum number of writers.
  8. Click OK to save the changes
  9. Repeat steps 5, 6, 7 and 8 in all the mount paths associated with the disk library. Keep in mind that the sum of the writers allocated in the mount paths should be equal to the total mount paths allocated in the disk library.

Establish the Mount Path Usage for a Disk Library

Related Topic

Required Capability: Capabilities and Permitted Actions

To establish the Mount Path Usage for a disk library:

  1. From the CommCell Browser, right-click the disk library for which you wish to establish the mount path allocation policy, and then click Properties.
  2. Click the Mount Paths tab.
  3. Click either the Fill and spill mount paths or the Spill and fill mount paths options.
  4. Click OK to save the information.

Enable Managed Disk Space for Disk Data

Related Topics

Required Capability: See Capabilities and Permitted Actions

To enable managed disk space for disk data:

  1. Right-click the storage policy copy for which you wish to enable or disable Data Aging, and then click Properties.
  2. From the Retention tab of the Copy Properties dialog box, select the Enable Managed Disk Space for disk data option and click OK.
  3. From the Mount Paths tab of the Library Properties dialog box, set the start and stop data aging disk capacity thresholds in the Start aging when data occupied on disk is n % and the Stop aging when data occupied on disk is n % boxes, and click OK to save changes.

View a List of Storage Policies Accessing the Disk Library

To view the list of Storage Policy accessing the disk library:

  1. From the CommCell Browser, right-click the disk library for which you wish to view the storage policies, and then click Properties.
  2. Click the Associations tab.

    All the Storage Policies and the Storage Policy Copies accessing the disk library are displayed.


Migrate a Disk Library

Required Capability: See Capabilities and Permitted Actions

Before you Begin:

Make sure that your disk library meets the appropriate criteria. For more information, see Migrate Magnetic Libraries.

To perform a disk library migration from one MediaAgent to another MediaAgent:

  1. Right-click the disk library that you want to migrate to another MediaAgent and click Migrate Disk Library.
  2. A message is displayed indicating that this operation migrates the disk library to another MediaAgent. Click OK.
  3. The Select MediaAgent dialog box is displayed. This dialog box displays the current MediaAgent that the disk library is associated with and allows you to select a MediaAgent to migrate to. From the drop-down list, select the MediaAgent you want to migrate to and click OK.
  4. The disk library will now be associated with the selected MediaAgent. To view the disk library properties to verify successful migration, right click on the disk library where you want to view the properties, and click Properties.

    The MediaAgent is displayed on the General tab.

  5. Make sure that the mount path associated with the disk library, points to valid path. (See Add or Modify Mount Paths for step-by-step instructions.)

Deconfigure a Disk Library

Data associated with a library will be lost, when it is deconfigured.

Before you Begin

To deconfigure a disk library:

  1. Display the Library and Drive Configuration window.
  2. Right-click the library that you want to deconfigure, and then click Deconfigure.
  3. A prompt appears, reminding you that the library's storage policy copies must be deleted in order for the library to be deconfigured. If no storage policy copies are associated with the library and you want to deconfigure, click Yes.

    The disk library is removed from the Library and Drive Configuration window.


Add or Modify a Mount Path

Required Capability: Capabilities and Permitted Actions

To add or modify a mount path to an existing disk library:

  1. Display the Library and Drive Configuration window.
  2. Select the library to which you want to add a mount path, right-click, and then select Add Mount Path.
  3. In the Add Mount Path dialog box, select either Local Path or Network Path.
  4. If you select Local Path, click Browse to select a mount path, or enter a mount path.
  5. If you select Network Path, type the user name and password to access the network share. Click Browse to select a mount path, or enter a mount path.
  6. Click OK. The mount path is added to the specified location.

Add Automated Mount Path Detection

To add automated mount path detection to an existing disk library:

  1. Display the Library and Drive Configuration window.
  2. Select and right-click the library, and then select Add Automated Mount Path Detection.
  3. From the MediaAgent list, select the MediaAgent.
  4. In the Folder box, type the mount path or click Browse [...] to select a mount path.
    If you need to share the volumes across MediaAgents, share the mount folder. This will automatically share the newly added volumes.
  5. If you wish to configure mount path for all selected MediaAgent(s), perform the following:

    The libraries will be shared between all MediaAgents as per the mount folder specified at the time of configuration.

  6. Click OK.

Enable Unbuffered I/O on a Mount Path

Related Topic

Required Capability: Capabilities and Permitted Actions

To enable unbuffered I/O on a mount path:

  1. From the CommCell Browser, right-click the mount path that you wish to enable unbuffered I/O, and then click Properties.
  2. From the General tab of Library Properties, click the Use unbuffered I/O option.
  3. Click OK to save the changes.

Enable or Disable a Mount Path

Required Capability: Capabilities and Permitted Actions

To enable or disable a mount path:

  1. From the CommCell Browser, right-click the mount path that you wish to enable or disable, and then click Properties.
  2. From the General tab of Library Properties, click the Enable MountPath option.
  3. Click OK to save the changes.

View the Mount Path Offline Reason

To view the offline reason for a mount path:

  1. From the CommCell Browser, right-click the mount path for which you wish to view the offline reason, and then click Properties.

    Information on the mount path offline reason is displayed in the Offline Reason box.


Establish Maximum Space Allocation on a Mount Path

Related Topic

Required Capability: Capabilities and Permitted Actions

To establish maximum space allocation on a mount path:

  1. From the CommCell Browser, right-click the mount path that you wish to establish the space allocation, and then click Properties.
  2. Click the Allocation Policy tab.
  3. In the Space Allocation section, establish one or more of the following options:
  4. Click OK to save the changes.

NOTES


Reduce Data Fragmentation on a Mount Path

Related Topic

Required Capability: Capabilities and Permitted Actions

To reduce data fragmentation a mount path:

  1. From the CommCell Browser, right-click the mount path that you wish to establish the space allocation, and then click Properties.
  2. Click the Allocation Policy tab.
  3. In the Fragmentation section, click and select the Minimize fragmentation by allocating write blocks of n MB option and specify the size that must be pre-allocated for each write operation in the box.
  4. Click OK to save the changes.

 Perform Fragmentation Analysis

Related Topic

Required Capability: Capabilities and Permitted Actions

To execute disk library maintenance on selected mount paths:

  1. Right-click the disk library containing the mount paths you wish to execute disk library maintenance and click Fragmentation Analysis.
  2. From the Disk Library Maintenance window, select the desired mount paths in the Analysis check box.

View the Contents of a Mount Path

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To view the contents of a mount path

  1. From the CommCell Browser, right-click the mount path for which you wish to view the content, and then click View Contents.

    or

    From the Media Used By Job ID dialog box right-click the media for which you wish to view the content, and then click View Contents.

  2. The Contents of Media dialog box displays the details of jobs available in the media.

Delete the Contents of a Mount Path

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To delete the contents of a mount path:

  1. From the CommCell Browser, right-click the mount path for which you wish to delete the contents, and then click Delete Contents.
  2. Click Yes in the Warning prompt to continue.

    Click No to abort the operation.

  3. In the Enter Confirmation text dialog box, type erase and reuse media and then click OK.

    Click Cancel to abort the operation.

NOTES

This operation deletes the data from the CommServe database. Note that this operation does not free-up the disk space in the mount path. A Data Aging operation must be run subsequently to free-up the disk space.


Prevent Accidentally Deleting Mount Path Contents

This feature is not supported on some libraries and may need to be turned off.

Required Capability: Capabilities and Permitted Actions

wedge.gif (136 bytes)To prevent accidentally deleting the contents of mount paths:

  1. From the CommCell Browser, right-click the library you wish to protect and then click Properties.
  2. In the Mount Path tab, select Prevent accidental deletion of data from mountpaths to enable the feature. Clear this option to disable the feature.
  3. Click OK. Contents of mount paths created when this option is enabled are protected from accidental deletion.

Move a Mount Path

The following procedure describes the step involved in moving a mount path currently associated with a disk library.

To move a mount path:

  1. Copy the CV_MAGNETIC folder (including its contents) from the current mount path location, to the new mount path location.
  2. From the CommCell Console: Display the Library and Drive Configuration window.
  3. Locate the disk library for which you wish to move the mount path.
  4. Right-click the mount path  that you wish to move and then select Properties.
  5. From the Mount Path Properties dialog box, enter the new path.
  6. Click OK to save the information.

    The mount path is moved to the specified location. Verify that the mount path is online and accessible after the move.


Retire a Mount Path

The following procedure describes the step involved in retiring or phasing out a mount path from a disk library.

To retire a mount path:

  1. From the CommCell Browser, right-click the mount path that you no longer want to use, and then click Properties.
  2. Click the Allocation Policy tab.
  3. Choose the Disable mount path for write option.
  4. Click OK to save the changes.
  5. If necessary, create a new mount path for subsequent operations by following the procedure for Add Mount Paths.

NOTES


Delete a Mount Path

A mount path can only be deleted if it does not contain backup data and is not the last remaining mount path. You can remove backup data either by deleting all storage policy copies that point to the disk library, or by taking the mount path offline, allowing its data to age and then running the Data Aging operation. Before you can delete a storage policy copy, all subclients associated with the copy must either be associated with a different storage policy copy or deleted.

To delete a mount path:

  1. Delete the contents of the mount path as described in Delete the Contents of a Mount Path. Note that once data is deleted on disk mount paths, it will not be restorable.
  2. Display the Library and Drive Configuration window.
  3. Select the mount path that you want to delete, right-click, and then select Delete Mount Path.
  4. Click OK in the prompt that appears, confirming the deletion of the mount path.

    The mount path is removed from the Library and Drive Configuration window display.