NovaStor DataCenter v8.2.x and newer
WARNING: For some editions of CentOS and Ubuntu Linux (and other Linux distributions that are based on those): You will have to Manually add the user novastor to the usergroup "tape". When the Client or CmdSrv was installed it created a novastor user, and in order for that user that DataCenter is running as currently to communicate to the tape library or single tape device that is connected physically to that Linux machine, it will need to have the novastor user in the usergroup "tape", otherwise the the user will have no permission to talk to the device.
From version 8.2.x more and more functions are transferred to the DC Web Console, from version 9.x there will only be the DC Web Console available. Only the setup of a tape library is not yet done via DC Web Console but via the optional DC Tape Manager. In principle the setup is done in the DC Management Console as in version 8.2.x, the procedure is almost identical. The setup of a tape library is described in the online manual and is also valid for the new versions that use the DC Tape Manager:
WARNING: In order to add a tape library in NovaStor DataCenter it is REQUIRED to have a barcode label affixed to all tapes that will be utilized in the library. The label must contain a barcode, otherwise you will receive an error like this when attempting to use the 'Attach library' function to add the library, as it will attempt to read the barcode on the tape that it will load when it runs that function:
https://dcmanual.novastor.com/help-html/dc/en/SetupaTapeLibrary.html
Below you will find a customized description for DC Tape Manager version 9.x.
Checklist before configuration
Check whether the following prerequisites are met:
Steps | Task | Check |
1 |
Is the tape library connected to a controller certified for tape drives? If the library is connected directly to the server via a controller, it must be a controller certified for tape drives. Many controllers, especially RAID controllers, are for disk-only. Using such a controller may cause undesirable effects during operation. |
|
2 |
Is the tape library configured in "Random Mode"? Some tape libraries are delivered from the factory in the so-called "Sequential Mode". In this mode, the library performs an automatic tape change without additional software, but does not allow the backup software to perform media management itself. |
|
3 |
Are all tapes in the tape library labeled with unique barcodes? NovaStor DataCenter uses the barcodes to uniquely identify the tapes regardless of their position in the library. This avoids errors caused by accidentally swapping positions, for example. NovaStor DataCenter requires at least one tape to verify and complete the installation of the tape library. WARNING: In order to add a tape library in NovaStor DataCenter it is REQUIRED to have a barcode label affixed to all tapes that will be utilized in the library. The label must contain a barcode, otherwise you will receive an error like this when attempting to use the 'Attach library' function to add the library, as it will attempt to read the barcode on the tape that it will load when it runs that function:
|
|
4 |
Is the tape library device online? The library must be online to be recognized correctly by the server. In this step, we recommend that you use the management program supplied with the library (usually a web interface) and check points 2-4 with this program. |
|
5 |
Are all tapes removed from the tape drives in the tape library? During the installation NovaStor DataCenter will try to test the tape drive(s). To do this, there must not be any tapes in the drives at the beginning. The tapes can be in the library slots, just not loaded in the tape drive(s) themselves. Use the Tape Library Web Interface or the library panel to unload any tapes that may be loaded. Note: If there is a tape currently in the tape drive at the time of adding the library device it will show an error like this, so at that point go ahead and remove the tape from the drive and place it in one of the slots in the library: |
|
6 |
Are the correct drivers for the tape library under the 'Medium Changer device' category in the Device Manager installed? NovaStor DataCenter requires the standard Microsoft branded 'Unknown Medium Changer' driver to be in place for the Medium Changer device. Device drivers here from the tape library manufacturer or drivers from third-party backup software must be deactivated. If installed correctly, the Medium Changer device (tape library device) appears as "Unknown Medium Changer" in the device manager. DataCenter will not be able to add or see your tape library device if this is not done. The instructions for how to do this are in the KB article 'How to change your tape library device driver to utilize the Unknown Medium Changer driver for DataCenter' here. |
|
7 |
Are the correct drivers for the tape drives installed? NovaStor DataCenter normally requires the tape drive drivers from the tape drive manufacturer (such as IBM or Quantum). If this causes problems, the standard Microsoft driver can also be used as an alternative. Drivers from third-party backup software must always be deactivated (removed). |
|
8 |
Is the tape library blocked by running services? All services that could access the library or tape drives must be stopped so that NovaStor DataCenter can access the library unhindered. These include in particular: The Windows removable media service Services of third-party backup software (sometimes still active even after uninstalling the backup software). |
|
9 |
If backups to the tape library fail when using a tape autoloader connected to a node other than the Command Server node, you will likely need to define a port or port range available as back channel ports. In this case NovaStor DataCenter will require back ports to be defined and available on a client in order for the Command Server node to talk to the client node that has the tape autoloader device attached to it. This is regardless if a multiplexer is assigned to a tape media pool or not. If a back channel port or port range is not configured and in place it will cause problems, the Client firewall settings are configured in the Java GUI in the 'Configure usable client ports' / 'Server - Client firewall settings' function in the toolbar in Nodes Management. You can also configure it via a flat config file on both the backup server that the tape autoloader is connected to, and the Command Server. You will define one port for each multiplexer port already in place, so if your 4 x Multiplexer ports are 41001 - 41004, then your back channel ports could then be 41005 to 41008. Note: If all of your firewalls are open as to allow all ports, then this is not an issue as the software will utilize a random port starting from 1025 and ending with 65535. If you end up having to define the back channel port or port range, make sure those same ports are open on all of your firewalls that connect these two nodes. The instructions for how to do this are in the KB article 'Firewall configuration for backup server control connection' here. |
Table 1: Requirements to be verified
Check drivers for the tape library
NovaStor DataCenter (DC) requires the Microsoft drivers for a tape library (see table above). The tape library must be listed in the Device Manager as follows:
Image 1: Drivers for Medium Changer and Tape Drives in Device Manager
The library changer must be listed as "Unknown media changer". Manufacturer drivers are NOT supported by DC! Manufacturer drivers can be used for the drives. If malfunctions occur during backup, switch them to Microsoft generic drivers.
1. Definition of a Media Management Server
The Media Management Server takes over the administration of the media for different Backup Servers and Tape Libraries. For the use of a Tape Library at least one Media Management Server must be defined. This can be any server, but it usually makes sense to assign this role to the backup server.
1. Select the Storage Management module, select Media Management Servers
and right-click to select "New".
2. Select the desired server from the drop-down list and confirm the selection with "OK".
Image 2: Tape Manager: Create a new Media Management Server
2. Setting up a library server
NovaStor DataCenter supports dynamic library sharing, which means that a tape library can be used by multiple backup servers simultaneously. In such a scenario, one server (the Library Server) takes over the management and control of the library. The configuration of access to the library is also done in this step. Therefore, this step is necessary even if there is only one Backup Server. In this case, the Backup Server will also be the Library Server.
1. Select the Media Management Server defined in the previous step.
2. Select the New Library function.
3. Select the Library Server from the drop-down list.
4. Select the desired Library under "Library Control", and the software will show you the detected Library in the field below.
5. Give the library a name.
6. Confirm the definition with OK.
At this point, the software will check the configuration of the library and load a tape into the drives to verify the drive mapping. This process may take a few minutes.
If there is an error in this step, please go through the checklist again step by step, delete the library and repeat the step.
Image 3: Connect Library
Image 4: Library Configuration
3. Assigning the library to a backup server
The final step in configuring a tape library is to assign the tape library to a backup server. Since NovaStor DataCenter supports dynamic library sharing, you can also assign a library to multiple backup servers. Conversely, by defining and selecting a partition, it is possible to assign only certain tape drives of the library to the backup server.
1. Select the Backup Server to which you want to assign the library in the Storage Management area.
2. Select the "Attach Library" function.
3. Select the library you want to assign and the correct media type.
4. Confirm the definition with "OK".
Image 5: Attach Library to Backupserver
Image 6: Select correct media type
In Tape Library Management, the library can be configured.
Navigate to Media Management > Tape Library Management.
⇨ The Media Management dialog box opens.
Click on tab "Library":
Image 7: "Library" tab: assign media type
Select all media and right click => select "Edit media type"
Then select the correct media type.
Next click tab "Scratch pools".
Create a new scratch pool, e.g. Scratch01, save.
Click tab "Library" and add all media to that scratch pool.
Go to tab "Media pools".
Create a new media pool, e.g. Tap.001.
Select a scratch pool, in this example "Scratch01".
This is a short description and explains not all steps in detail. For more details about how to create/configure media/scratch pools etc. please consult the manual.
Explanations
Area | Explanations |
Media Management | Media Management Server and Library Selection Area |
Tab: | |
Media pools |
List of defined media pools, depending on the selected server and library. The following functions are available in this window via the context menu (right mouse button): |
Refresh |
Refresh screen |
Create media pool | Create media pool |
Remove media pool |
Remove selected media pool |
Edit Retention | Modify retention |
Attach Multiplexer | Adds a multiplexer to media pool |
Detach Multiplexer | Removes multiplexer from selected media pool |
Multiplexer |
Lists all multiplexer, depending on selected server and library. In this window following context menues are available: |
Refresh |
Refreshes screen |
Start multiplexer |
Starts multiplexer |
Stop multiplexer |
Stops multiplexer |
Restart multiplexer |
Stop/Start multplexers |
Start multiplexer Service |
Starts multiplexer service |
Stop multiplexer service |
Stops multiplexer service |
Restart multiplexer service |
Stops/Starts multiplexer service |
Edit Multiplexer |
Available if multiplexer is stopped Multiplexer can be modified |
Scratch pools |
|
Refresh |
Refreshes screen |
Create scratch pool |
Creates new scratch pool |
Remove scratch pool |
Removes selected scratch pool |
Edit low watermark |
Modify watermark |
Library |
List of all connected libraries |
Following context menues are available: |
|
Refresh |
Refreshes screen |
Offline Export |
Selected medium will be marked as "Offsite". |
Mail slot Export |
Selected medium will be moved to mail slot of library exportiert and can be removed from library |
Import export tapes |
Importierts "Offline" (exported) media |
Move to empty drive |
Moves the selected medium into drive |
Add to scratch pool |
Assigns a scratch pool to selected library |
Remove from scratch pool |
Removes scratch pool from tape pool |
Enable write access |
Removes write protection from medium |
Edit media type |
Modify media type of selected medium |
Off-site locations |
List of Off-site locations. Following context menues are available: |
Refresh |
Refreshes screen |
Add |
Adds an new Off-site location |
Edit |
Modify selected Off-site location |
Remove |
Removes selected Off-site location |
Tabelle 2: Available options
5. Function check via command line
If a tape library is not displayed in the DC Tape Manager, first check that you have selected the correct server and tape library in the GUI.
Then go through the above checklist.
Via command line you can check if a tape library can generally be accessed by DC. To do this, open an administrative command prompt and jump to the directory
C:\Program Files\NovaStor\DataCenter\Hiback\tape:
cd C:\Program Files\NovaStor\DataCenter\Hiback\tape
Execute
hiscsi.exe -scan
If a tape library is correctly configured on Windows level (drivers etc.), the command lists the components of a tape library, e.g. (extract of an output):
Name C Device Vendor Product
------------ - -------- ---------- ------------
A04B00S00L00 Y Disk FreeNAS iSCSI Disk
A04B00S01L00 Y Tape0 IBM ULT3580-TD2
A04B00S02L00 N Changer? IBM ULT3583-TL
A04B00S03L00 Y Tape1 IBM ULT3580-TD1
A04B00S04L00 Y Tape2 IBM ULT3580-TD1
A04B00S05L00 Y Tape3 IBM ULT3580-TD1
\\.\SCSI4: with (6) devices
In this example, an iSCSI drive is also listed.
The components of the library are accessible here and are listed.
If address errors are displayed, check the drivers and the SCSI addresses of the tape library.
For further troubleshooting procedures, do a keyword search for "tape" or "hiscsi"(without ") on the NovaStor Support website, e.g.:
https://support.novastor.com/hc/en-us/search?category=360000518773&query=hiscsi&utf8=%E2%9C%93
AMo