Library and Drive Configuration - How To

Topics | How To | Troubleshoot | Related Topics


Display the Library and Drive Configuration window

Detect Devices

Perform an Exhaustive Detection on all Devices Controlled by the MediaAgent(s)

Perform an Exhaustive Detection on a Specific Library/Drive/Library Controller

Configure Devices

Validate the Drives in a Library

Change the Library Name

Change the Door Check Seconds for a Library

Enable Automatic Media Discovery During Library Configuration

Configuring Library for Solaris Zones


Display the Library and Drive Configuration window

The following procedure describes the steps involved in displaying the Library and Drive Configuration window.

Required Capability: See Capabilities and Permitted Actions

To display the Library and Drive Configuration window

1. From the Tools menu in the CommCell Console, click Control Panel.
  Double click Library & Drive Configuration.
2. Alternatively, from the CommCell Browser, right-click Libraries under Storage Resources node, and then click Library & Drive Configuration...
3. Select the MediaAgent(s) whose devices you want to detect or display, and then click OK.

To configure any shared library, make sure you select all the MediaAgents that share the library.

NOTES

  • If a device has already been configured for the MediaAgent, the system displays the device in the Library & Drive Configuration window.
  • For cluster, select the cluster server as the MediaAgent.
4. Click OK to continue.

NOTES

  • The system displays this prompt only if a library is not configured. Subsequently the Library and Drive Configuration window displays a blank screen.
  • If a library is already configured, this prompt is not displayed. Subsequently the detected devices are displayed with detection status detect success in the Library and Drive Configuration window.
You can now detect the devices controlled by the selected MediaAgent(s) as described in Detect Devices.

Detect Devices

Related Topic

The following procedure describes the steps involved in detecting the devices attached to a MediaAgent.

Before You Begin

To detect devices controlled by MediaAgent(s)

1. Display the Library and Drive Configuration window.
2. From the Library and Drive Configuration window, click the Start menu and choose Detect/Config Devices.
3. In the Detect Library dialog box, choose the appropriate options:
  • SCSI Devices - If your library is attached to the SCSI or Fiber Channel (FC) Adapter.
  • Detect on Selected MediaAgents in Parallel - If you are performing the detection for multiple MediaAgents.
  • Automatically create DDS Drivepools - If your library is attached to multiple MediaAgents in a SAN environment.
  • NDMP Devices - If your library is attached to a NAS filer.
  • Exhaustive Detection - Only for libraries without Drive IDs support.

Click OK.

4. Optionally, from the Processing dialog box you can perform the following operations:
  • Click the Abort button to abort the exhaustive detection operation and unmount any mounted media from the drives.
  • Click the View Log button to display the Log dialog box which reports the status of each task that is performed during the exhaustive detection operation.
5. An Information prompt appears, informing you to right-click the device to continue the configuration. Click OK to proceed.
6. When the detection process is completed, the log file is displayed. Note the log file contents and click Close to proceed.
7. If the library supports SCSI 3 drive identification, the system detects the devices and displays them with detection status detect success, in the Library and Drive Configuration window. Configure the library as described in Configure Devices.
  If the library does not support SCSI 3 drive identification, the system detects the Library with Empty Drive Slots and the drives as StndAln Library.

Perform an Exhaustive Detection before configuring the library. (See Detect Devices Using Exhaustive Detection for step-by-step instructions.)

Detect Devices Using Exhaustive Detection on all Devices Controlled by the MediaAgent(s)

Required Capability: See Capabilities and Permitted Actions

Before You Begin

  • Review Exhaustive Detection.
  • Verify that the necessary SCSI adapters and drivers for the library attached to the MediaAgent computer are installed.

    If you have two libraries with different drive types (e.g. AIT and DLT 4000 drive types) and even if you do not plan to use some of the drives, ensure that all the drivers associated with all the drives types are installed. In some cases, if you do not install all the appropriate drivers, the device configuration may fail.

    Consider the following:

    • In a SAN environment you may have libraries with two different drive types connected to your bridge or switch (e.g., AIT and DLT 4000 drive types) If you planned on using only the DLT 4000 drives and hence only installed the drivers for the DLT 4000 drives, you would not be able to configure these drives in the Library and Drive Configuration window, until you install the drivers associated with all the other drive types (AIT) in the libraries.
    • If you have an existing library (e.g. a library with DLT 4000 drives) which is already configured, and if you add another library with another drive type into your environment (e.g. a library with AIT drives) the SCSI ID of the configured library may change and you may need to edit the address in the properties of the devices in the Library and Drive Configuration window.
  • Check and verify that the hardware is visible to the operating system. For a more detailed explanation on verifying the driver configurations, see the following sections:
  • Ensure that the CommServe computer and library are accessible.
  • As this operation may involve the mounting of a media in a drive, ensure that media is available in the library. Also ensure that the media is not a cleaning media.
  • Exhaustive detection should not be performed when other jobs are using the drives in the library. Stop all jobs before performing an exhaustive detection.
  • Verify and ensure that no media is mounted in the drives available in the libraries connected to the selected MediaAgent(s).
    CAUTION

    Before configuring the libraries and drives in SAN, we strongly recommend you to verify and ensure that proper hardware zoning of tape drives be implemented, especially when you have HBA fail over implemented in your environment. For more information on zoning of HBA fail over, contact your HBA software vendor.

To detect devices controlled by MediaAgent(s)

1. Display the Library and Drive Configuration window.
2. From the Library and Drive Configuration window, click the Start menu and choose Detect/Config Devices.
3. In the Detect Library dialog box, choose the appropriate options:
  • SCSI Devices - If your library is attached to the SCSI or Fiber Channel (FC) Adapter.
  • Detect on Selected MediaAgents in Parallel - If you are performing the detection for multiple MediaAgents.
  • Automatically create DDS Drivepools - If your library is attached to multiple MediaAgents in a SAN environment.
  • NDMP Devices - If your library is attached to a NAS filer.
  • Exhaustive Detection - Only for libraries without Drive IDs support.

Click OK.

4. Click Yes to continue.
5. From the Device Selection dialog box, select the libraries and drives you wish to detect and then click OK.

The detection process will attempt to detect the devices by mounting the media in each of the selected drives to determine the correct drive to library mapping.

You can track the progress of the operation in the Processing dialog box.

6. Optionally, from the Processing dialog box you can perform the following operations:
  • Click the Abort button to abort the exhaustive detection operation and unmount any mounted media from the drives.
  • Click the View Log button to display the Log dialog box which reports the status of each task that is performed during the exhaustive detection operation.
7. When the exhaustive detection process is completed, the log file is displayed. Note the log file contents and click Close to proceed.
8. An Information prompt appears, informing you to right-click the device to continue the configuration. Click OK to proceed
Exhaustive detection may not be able to unload a drive, if it is not detected. If this occurs manually remove the media from the drive.
  In the expanded tree in the sample image , the unconfigured devices controlled by MediaAgent are displayed.

Note that if the devices are not configured at this point, the detection information will not be saved if you exit from the Library and Drive Configuration window now.

9. Configure the library as described in Configure Devices.  

Detect Devices Using Exhaustive Detection on a Specific Library/Drive/Library Controller

Required Capability: See Capabilities and Permitted Actions

Before You Begin

  • Review Exhaustive Detection.
  • Verify that the necessary SCSI adapters and drivers for the library attached to the MediaAgent computer are installed.

    If you have two libraries with different drive types (e.g. AIT and DLT 4000 drive types) and even if you do not plan to use some of the drives, ensure that all the drivers associated with all the drives types are installed. In some cases, if you do not install all the appropriate drivers, the device configuration may fail.

    Consider the following:

    • In a SAN environment you may have libraries with two different drive types connected to your bridge or switch (e.g., AIT and DLT 4000 drive types) If you planned on using only the DLT 4000 drives and hence only installed the drivers for the DLT 4000 drives, you would not be able to configure these drives in the Library and Drive Configuration window, until you install the drivers associated with all the other drive types (AIT) in the libraries.
    • If you have an existing library (e.g. a library with DLT 4000 drives) which is already configured, and if you add another library with another drive type into your environment (e.g. a library with AIT drives) the SCSI ID of the configured library may change and you may need to edit the address in the properties of the devices in the Library and Drive Configuration window.
  • Check and verify that the hardware is visible to the operating system. For a more detailed explanation on verifying the driver configurations, see the following sections:
  • Ensure that the CommServe computer and library are accessible.
  • As this operation may involve the mounting of a media in a drive, ensure that media is available in the library. Also ensure that the media is not a cleaning media.
  • Exhaustive detection should not be performed when other jobs are using the drives in the library. Stop all jobs before performing an exhaustive detection.
  • Verify and ensure that no media is mounted in the drives available in the libraries connected to the selected MediaAgent(s).
    CAUTION

    Before configuring the libraries and drives in SAN, we strongly recommend you to verify and ensure that proper hardware zoning of tape drives be implemented, especially when you have HBA fail over implemented in your environment. For more information on zoning of HBA fail over, contact your HBA software vendor.

To perform an exhaustive detection for the Library/Drive/Library Controller

1. Display the Library and Drive Configuration window.
2. Right-click the Library, Drive or the Library Controller, select Advanced Options and click Exhaustive Detection.
3. Click Yes to continue.
4. From the Device Selection dialog box, select the libraries and drives you wish to detect and then click OK.

The detection process will attempt to detect the devices by mounting the media in each of the selected drives to determine the correct drive to library mapping.

You can track the progress of the operation in the Processing dialog box.

5. Optionally, from the Processing dialog box you can perform the following operations:
  • Click the Abort button to abort the exhaustive detection operation and unmount any mounted media from the drives.
  • Click the View Log button to display the Log dialog box which reports the status of each task that is performed during the exhaustive detection operation.
6. When the exhaustive detection process is completed, the log file is displayed. Note the log file contents and click Close to proceed.
7. An Information prompt appears, informing you to right-click the device to continue the configuration. Click OK to proceed
Exhaustive detection may not be able to unload a drive, if it is not detected. If this occurs manually remove the media from the drive.
  In the expanded tree in the sample image, the unconfigured devices controlled by MediaAgent are displayed.

Note that if the devices are not configured at this point, the detection information will not be saved if you exit from the Library and Drive Configuration window now.

8. Configure the library as described in Configure Devices.  

Configure Devices

Related Topics

The following procedure describes the steps involved in configuring devices attached to a MediaAgent or NAS File Server.

To configure a library

1. Display the Library and Drive Configuration window.
2. Detect the devices. Use Detection or Exhaustive Detection as required.

Note that the Library and Drive Configuration window displays a master drive pool (with a drive pool and the associated drives) for the library.

3. Optionally, perform the following steps if you do not want the system to automatically create a storage policy during configuration:
  Right-click the library and then click Properties.
  From the Library Properties window, if necessary, clear the Automatically create storage policy for new Datapaths option.

Click OK.

4. From the Library and Drive Configuration window, right-click the library that you want to configure, and then click Configure.
5. Choose one of the following options from the Configuration dialog box:
  • Library only option if you want to configure the drives individually. ( See Configuring a Drive for information on individually configuring the drives.)
  • Library and all drives option if you want to configure all the drives within the library (e.g., if you are doing a typical library installation)
6. If you have not already performed an exhaustive detection, or if your exhaustive detection did not detect one or more of the existing devices, the Device Configuration dialog box is displayed. Choose one of the following options:
  • Choose the Do Exhaustive Detection Now option if you wish to perform the exhaustive detection operation. If you choose this option, follow steps 5 to 8 in the procedure, Detect Devices Using Exhaustive Detection.
  • Choose the Configure Devices without Exhaustive Detection option if you do not wish to perform the exhaustive detection operation.
7. A Confirm prompt appears, asking you if your library has a barcode reader.
  • Click Yes, if the library has a barcode reader. (sighted library)
  • Click No, if the library does not have a barcode reader. (blind library)

On Windows MediaAgents, this prompt is displayed only in the following situations:

  • When the media changer is disabled in the operating system.
  • When the media changer is enabled, but the operating system detects an unknown media changer.

If Windows detects the correct media changer, this prompt will not be displayed.

8. If the library has a barcode reader, the Discover Media Options dialog box is displayed.

Perform one of the following:

  • To automatically discover the media in the library, select the default media type and then click Yes.
  • To manually discover the media, click No.

For more information on discovering media in a library, see Discover Media.

Ensure that media is discovered, before using the library for a data protection operations.

9. If the library does not have a barcode reader, the Discover Media Options dialog box is displayed.

Select the correct media type available in the library and then click OK.

10. If the library does not have a barcode reader the Confirm prompt is displayed.
  • Click Yes, if you want to automatically start the inventory process after 5 minutes.
  • Click No, if you want to manually start the inventory process. Ensure that a full inventory is performed on the library, before using the library for a data protection operations.

For libraries without a barcode reader, read the information  provided in Blind Library Configuration.

  The status of the library changes to configured. If you chose to configure all associated drives, the status of the drives (and of the drive pool that contains them) changes to configured as well.

If the library is an optical library, the system automatically identifies the optical library and uses the optical library icon to display the library information.

The Library tab provides  the physical view of the devices (library and drives).

 

  The Data Paths tab provides a logical view of the data path used to access the devices - library, master drive pool, drive pool, drive.

Validate the Drives in a Library

The following procedure describes the steps for validating drives in a library.

Before You Begin:

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To validate the SCSI mapping of drives within a library:

  1. Display the Library and Drive Configuration window.
  2. Right-click the configured library, master drive pool, drive pool or drive that you want to validate, and then click Validate. Note that the library must contain discovered media. (For information on discovering media, see Discover Media from the CommCell Console.)
  3. A prompt appears, informing you that validation may take several minutes per drive and asking if you want to continue. Click Yes to start the validation process.

    The system attempts to mount a media in each drive within the library, master drive pool, drive pool or drive. A progress bar reports the progress of the validation job.

    Click on the View Log button to display the Log dialog box which reports the status of each task that is performed during the drive validation operation.

    A status message reporting the success or failure of the operation appears in the Status Bar at the bottom of the Library and Drive Configuration window.


Change the Library Name

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To change the library name:

  1. Display the Library and Drive Configuration window.
  2. Right-click the library for which you wish to change the name, and then click Properties.
  3. In the Alias box, type the new name for the library.
  4. Click OK to save the changes.


Change the Door Check Seconds for a Library

Required Capability: See Capabilities and Permitted Actions

wedge.gif (136 bytes)To change the door check seconds for a library:

  1. Display the Library and Drive Configuration window.
  2. Right-click the library for which you wish to change the door check seconds, and then click Properties.
  3. In the Door Check (sec) box, type or select the frequency (in seconds) that the library door is checked to be open.
  4. Click OK to save the changes.

Enable Automatic Media Discovery During Library Configuration

Required Capability: Capabilities and Permitted Actions

To discover media within a library:

  1. Display the Library and Drive Configuration window.
  2. Detect the devices. Use Detection or Exhaustive Detection as required.
  3. Configure the library as described in Configure Devices.

    During the configuration process,  if the library has a barcode reader, the Discover Media Options dialog box is displayed.

    Perform one of the following:

    If the library does not have a barcode reader, another Discover Media Options dialog box is displayed.

    Select the correct media type available in the library and then click OK.


Configuring Library for Solaris Zones

You can configure a library or a device in a global zone and then access the same library from a local zone. Use the SCSiZone tool to configure the library in the global zone. Follow the steps given below to configure the library:

1. Install the MediaAgent on the computer hosting the global zone. For more information, refer to Install the MediaAgent - Solaris.  
2. Install the MediaAgent on the local zone. For more information, refer to Install the MediaAgent - Solaris.

 

 
3.
  • On the computer hosting the global zone, navigate to the following location:

    <Install Directory>/WA

  • Enter the following command to detect the devices:

    ./wa_sunqlc_add

The library and tape drive devices are detected. To confirm this, navigate to to /var/adm/ and view the messages file. It displays the list of detected devices.

 
4. On the local zone, enter the following command to stop the Calypso services:

simpana stop

 
5. On the global zone, navigate to <Install Directory>/Base and enter the following command:

./ScsiZoneTool -i <local zone name>

 
6. Restart the services on the local zone using the following commnad:

simpana start

 
 7. From the Tools menu in the CommCell Console, click Control Panel.
8. Double click Library & Drive Configuration.
9.
  • Select the MediaAgent(s) installed on the local Zone.
  • Click OK.
10. From the Library and Drive Configuration window, click the Start menu and choose Detect/Config Devices.

 

11. In the Detect Library dialog box, select SCSI Devices.

Click OK.

 

12. Click Yes to continue.
13. From the Device Selection dialog box, select the libraries and drives you wish to detect and then click OK.

This dialog box displays the same list of library and tape drives that appeared on global zone.

The detection process will attempt to detect the devices by mounting the media in each of the selected drives to determine the correct drive to library mapping.

You can track the progress of the operation in the Processing dialog box.

14. When the exhaustive detection process is completed, the log file is displayed. Note the log file contents and click Close to proceed.
15. An Information prompt appears, informing you to right-click the device to continue the configuration. Click OK to proceed.
16. Configure the library as described in Configure Devices.