GENERAL ERROR: The message "No cleaning tape is defined in the device's robot or 0 cleanings remaining (315)" occurs when attempting to clean a tape drive via the command line or Administration Console.

Article:TECH22283  |  Created: 2002-01-01  |  Updated: 2013-10-24  |  Article URL http://www.symantec.com/docs/TECH22283
Article Type
Technical Solution

Product(s)

Environment

Issue



GENERAL ERROR: The message "No cleaning tape is defined in the device's robot or 0 cleanings remaining (315)" occurs when attempting to clean a tape drive via the command line or Administration Console.


Error



No cleaning tape is defined in the device's robot or 0 cleanings remaining (315).


Solution



Overview:
The message "No cleaning tape is defined in the device's robot or 0 cleanings remaining (315)" (Figure 1) occurs when attempting to clean a tape drive via the command line or Administration Console.

Figure 1.  A Cleaning Tape is not properly defined.
 



Troubleshooting:
This message can occur for one of the following reasons:
 
I.   The number of cleanings are used up for the cleaning media.
 
II.  The cleaning tape is not defined as a cleaning tape.
 
III. The media type of the cleaning media does not match the drive type.
 


Master Log Files:  N/A

Media Server Log Files:  N/A

Client Log Files:  N/A


Resolution:

I. The number of cleanings are used up
If cleaning was functional previously with the media in question, the number of cleanings may simply be used up on the media. Verify this by doing the following:

 
1.  In the NetBackup Administration Console, expand Media and Device Management in the left pane
 
2.  Click Media
 
3.  In the right-hand pane, note the Cleanings Remaining column displayed for the cleaning media. By default, this appears after the status column.
 

Observe if the amount of cleanings remaining are at "0." If so, configure a new cleaning media, or increase the cleanings remaining on the existing media by doing the following:
 

 
1.  Double-click on the media in question to bring up the Change Volumes window (Figure 2)
 
2.  Observe the Cleanings Remaining in this screen. The column may be partially obscured.
 
3.  If required, click New Count and enter a new number, such as "25," then click OK.
 

 
Figure 2.  In this example, the number of cleanings remaining must be adjusted.
 
 

 

Note:  If the Number of cleanings remaining section is greyed out, the media is not configured properly.  Proceed to the next section of this document.


II.   The Cleaning Tape isn't defined as a cleaning tape
Firstly, cleaning tapes must be defined as a special media type. For example, a DLT cleaning tape cannot be configured simply as "DLT" (DLT cartridge tape). It must be DLT_CLN (DLT cleaning cartridge).  Be careful, as it is easy to specify "cartridge tape" when "cleaning tape" is what must be selected to configure the media.

III.  The density doesn't match the drive type
Additionally, it is important to note the exact drive type configured in NetBackup and ensure the cleaning media matches it. To confirm this, do the following:
 

 
1.  In the NetBackup Administration Console, expand Media and Device Management in the left hand pane
 
2.  Click Devices
 
3.  In the lower right hand pane, note the Drive Type displayed for the drive(s) for which a cleaning tape is being configured
 

Pay special attention to whether or not a number follows the density type. For example, if the Drive Type is DLT2 (DLT cartridge tape) and the cleaning media is DLT_CLN (DLT cleaning tape), the above error message will occur. If the Drive Type is DLT2, the cleaning media must be DLT2_CLN (DLT cartridge tape 2).

Below is a list of common drive types and the required cleaning tape type (Figure 3).

Figure 3.  A list of common drive types and their correct cleaning tape type.
 


Next, check the media type for the cleaning media being used by doing the following:
 
1.  In the NetBackup Administration Console, expand Media and Device Management in the left hand pane.
 
2.  Click Media
 
3.  In the right-hand pane, note the Media Type displayed for the cleaning media
 

 
Changing the Media Type
If the Media Type is incorrect, it is an easier process to delete and re-add cleaning media, rather than change to them.  To delete these media, simply highlight them in the Administration Console and click Delete.  Since no data resides on the media and they are not assigned, NetBackup will allow the deletion.

To ensure that cleaning media are re-added correctly, perform the following procedure:

Adding new cleaning media with Robots that support Barcodes:
 
1.  In the NetBackup Administration Console, expand Media and Device Management in the left hand pane
 
2.  Right-click Devices and select Inventory Robot
 
3.  Select the appropriate robot in the Robot drop-down menu
 
4.  In the Robot Inventory screen, select Update volume configuration and then Advanced Options
 
5.  Select the Barcode Rules tab in the Advanced Robot Inventory Option window
 
6.  Click New to add a new barcode rule
 
7.  Under Barcode Tag, enter the unique string of characters present in the cleaning media barcode. Almost all cleaning media have the string "CLN" in their barcode. Therefore this will likely be "CLN" (Figure 4).
 

 
Figure 4.  A rule is added for cleaning media containing the common "CLN" tag, for a DLT2 Drive type in NetBackup.
 
 

 

 
8.  Select the media type in accordance with the chart above (Figure 3)
 
9.  Enter the amount of cleanings this tape will perform and click OK in the Advanced Robot Inventory Option window
 
10.  This brings up the Robot Inventory Window, where a new inventory with Update Volume Configuration can be performed to inventory the new cleaning media
 

 

 
Adding new media with Robots that do not support Barcodes, or if the cleaning media has no barcode:
 
1.  In the NetBackup Administration Console, expand Media and Device Management in the left hand pane
 
2.  Click Media
 
3.  In the right-hand pane, right-click anywhere and click New
 
4.  In the Add Volumes window, add media with the correct density type, robot/slot and preferred "maximum cleanings" value, as learned in this document. Click OK.
 

 
Cleaning should now be possible without the aforementioned errors.

 


Legacy ID



250900


Article URL http://www.symantec.com/docs/TECH22283


Terms of use for this information are found in Legal Notices