HOWTO - Using DP CLI to make device configuration changes - omnidownload/omniupload

  • KM02757498
  • 23-Mar-2017
  • 25-Mar-2021

Summary

Run DP CLI omnidownload and omniupload

Question

(DP) Support Tip: Using DP CLI to make device configuration changes - omnidownload/omniupload

DP GUI is still the preferred option to make configuration changes but in situation where you have problems with DP GUI, then you can use CLI.

(these commands are available on systems with the Data Protector User Interface component installed)

omnidownload — downloads information about a backup device and a library from the Data Protector Internal Database (IDB)

omniupload — uploads information about a backup device from an ASCII file to the Data Protector Internal Database (IDB)


1. Identify an existing device or tape library that you need to make changes

omnidownload -list_device

omnidownload -list_libraries

Example :

Library name Host Library type
===========================================================================
TEST-FL MA-SERVER1.hpe.com File Library
PROD-MSL6000 MA-SERVER1.hpe.com SCSI Library
jukebox_test MA-SERVER2.hpe.com Jukebox
DEV-MSL6000 MA-SERVER1.hpe.com SCSI Library <<<<<<<<<<
===========================================================================
Together : 4 configured library[ies].

 

2. Run the same omnidownload command specific to the tape library.

Example :

omnidownload.exe -library "DEV-MSL6000" -file INFO-DEV-MSL6000.TXT

Output file - INFO-DEV-MSL6000.TXT

NAME "DEV-MSL6000"
DESCRIPTION "HP StorageWorks MSL 6000 Series"
HOST MA-SERVER1.hpe.com
POLICY SCSI-II
TYPE LTO-Ultrium
BARCODEREADER
LIBVIRTUAL
VTLCAPACITY 2 <<<<<<<<<<
IOCTLSERIAL "01UbWE6y00"
CONTROL "scsi2:0:4:72"
REPOSITORY
"1"
"2"
"3"
"4"
"5"
"6"
"7"
"8"
"9"
"10"
MGMTCONSOLEURL ""

 

3. Make change to one of the parameters in this file - INFO-DEV-MSL6000.TXT.

Example :

Change this entry

VTLCAPACITY 2

to

VTLCAPACITY 3

VTLCAPACITY - virtual library capacity

 

4. Run the omniupload command to make changes

Example :

omniupload.exe -modify_library "DEV-MSL6000" -file INFO-DEV-MSL6000.TXT

 

5. Run omnidownload to check update device/library info

omnidownload -list_device -detail

omnidownload -list_libraries -detail

or

omnidownload.exe -library "DEV-MSL6000" -file UPDATED-INFO-DEV-MSL6000.TXT

You then compare (example) INFO-DEV-MSL6000.TXT and UPDATED-INFO-DEV-MSL6000.TXT.


SUPPORT NOTES :

The omnidownload CLI is one way to document things - if you need to maintain a copy of your device configurations.

omnidownload -dev_info
omnidownload -list_devices -detail
omnidownload -list_libraries -detail

For the above, redirect to an output file.

omnidownload -device BackupDevice -file [FileName]

omnidownload -library Library -file [FileName]

For the last 2, specify an output filename.


Reference :

https://support.microfocus.com/kb/kmdoc.php?id=KM01024648/hpe_man_DP9.07_CLIReference_pdf.pdf