Admin Devices

Version as of 23:38, 19 Apr 2024

to this version.

Return to Version archive.

View current version

Device Management

The Admin Devices page lets you select and configure target devices for backup. Once configured, a device is then bound to the current backup set.

 

When you select a device type (Disk, Tape Changer, Amazon S3 or Cloud,  NDMP Changer Device) and click Add, the options for that device are displayed in the top pane as shown above. Devices already configured are listed in the bottom pane along with buttons that allow you to Edit, Delete, and Use the device as shown below. When there are more items that can be listed one page, page navigation links at the bottom of the table allow you to move between pages.

NDMP Changer Device can be used only with NDMP application. For more information, please see NDMP appliance application agent configuration.

All devices must have a Name; a descriptive Comment is optional. Device-specific options are described in the subsections that follow.

AdminDevices-List-3.1.png

 

Disk Device

AdminDevices-Vtape-3.1.png

Root Path  The directory to store backup images, specified as an absolute path.

By default, ZMC fills in the field with /var/lib/amanda/vtapes/. The amandabackup user must have permission to write to this directory, which should also be large enough to hold images for all intended backups. When you bind a disk device profile to a backup set on the Backup Where page, it will display this value as the storage location, creating a subdirectory of the root path that matches the backup set name to store images.

Tip: The amount of free space available to hold backup images is an important consideration for fast retrieval of data.
To ensure effective restore capabilities, set aside sufficient disk space to hold more than one full Backup Set worth of Data. Just how many full Backup Sets you should keep on disk depends on the data and your sites requirements for quick restores of accidentally deleted data. The more full backup images stored, the longer the retention of accidentally deleted files. Start with enough space to hold three full Backup Set images and adjust this number as experience dictates. 

When using vtapes, you must first decide whether to oversubscribe before you can determine how much disk space to allocate.  If oversubscribing, you should still determine by how much you plan to oversubscribe and set up processes on the host system to alert you when oversubscription threatens to prevent backups from occuring.

If you set the number of vtapes in rotation to match the number of vtape slots on the Backup Where page (i.e. normal, recommended configuration), then to avoid oversubscription issues you must allocate disk space equal to the number of vtapes times the size of each vtape.  Changes to either of these two parameters require adjusting the amount of disk space allocated for use by ZMC's backup set outside of Amanda, since currently the Amanda does not reserve space before usage.


Tip: Because there is no value in creating a backup of a backup on the same media, Zmanda recommends that the drive that holds the vtapes be excluded from the backup set that points to the vtapes.

Reserved Percent  Percentage of the file system that should be free. This value depends on the file system in use. All file systems have reserve space. This value is used for ZMC disk space warning messages.


Amazon S3 Device

Setting up an Amazon S3 storage device requires that you sign up for an Amazon S3 account and obtain the Access Key ID and Secret Key as described in Setting up an Amazon S3 Account for Use with Amanda. If the S3 account is already set up, you can obtain the Key ID and Secret Key by logging in here (Amazon username and password required), from where you can cut and paste the Key ID/Secret Key.

AdminDevices-S3-3.1.png

 

Access Key 
The Access Key ID you obtained when signing up for S3 storage.
Secret Key 
The Secret Key you obtained when signing up for S3 storage.
User Token
This is included for compatibility with the Amanda Enterprise 2.6.4 payment model, which required an "Amazon S3 Certificate." If you have such an account, this field will be automatically filled with User Token for the account, which will be required if you need to access the data without using Amanda.

Amanda Enterprise 2.6.4 customers please note: Amanda will always support the old payment model, but if you wish to change to the new payment model, please contact the Zmanda Support team. Account migration does not happen automatically, and the best migration method will depend on how Amanda/S3 was used at your particular site.

Location Standard
The default is US Standard (Closest Amazon US data center). European customers should use European Union (Amazon Ireland data centers) to reduce latency and backup Windows. Other S3 locations can be US-West (Northern California data center), Asia Pacific (Singapore data center) and other S3 locations. The Storage and Data transfer pricing for each S3 location is different.  For details on the storage and data transfer charges associated with different locations, see the Amazon S3 web site at http://aws.amazon.com/s3/.

Storage Option

It can be either standard (Amazon S3 will complete redundancy and more availability) or Reduced Redundancy (Amazon S3 with reduced redundancy and less expensive storage).

Tape Changer Device

The output of lsscsi and mtx command are provided so that you can fill in the values for device. The mtx command is required on the Amanda server for managing the tape changer. The lscsi command is optional.

AdminDevices-TapeChanger-3.1.png

 

Tape Changer
  • Please select: Click this option to display a list of tape changers sensed by the operating system and the ZMC. Choose one. Number of drives on the changer are also displayed.
  • Other Click this option to enter a path to a Tape Changer device that may be currently inaccessible or not detected by the ZMC. When the Backup Where configuration is saved, the Tape Changer name and its location are not validated.

ZMC attempts to discover tape changer and tape drive device names automatically. The devices must be readable and writeable by amandabackup user.


Tape Size 

Specify the size of the tape in MB (megabytes), GB (gigabytes) or TB (terabytes). This should be the uncompressed size of tapes used by the changer. It is important not to use the number quoted by marketing material. You can use the amtapetype command to allow Amanda to estimate the size of tape. The execution of amtapetype will probably take hours because it must perform I/O operations on the entire tape length.

Note on Block Size: Although you cannot change the block size of the device using the ZMC, you can manually edit the amanda.conf file to specify a different block size if necessary. See the description of device_property in the link for details.

Bar Code Reader 

Check this box if a barcode reader is attached to the changer so that the ZMC can use it to identify tapes.

All other advanced options should be used when advised by Zmanda Support Team.