Micro Focus Expert
Micro Focus Expert
197 views

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

Jump to solution

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://softwaresupport.hpe.com/km/KM01024648/hpe_man_DP9.07_CLIReference_pdf.pdf

Labels (1)
0 Likes
1 Solution

Accepted Solutions
Micro Focus Expert
Micro Focus Expert

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

Jump to solution

Thanks Luc for sharing

Yes - I agree... using CLI, you can easily do things, most especially if you have a very huge environment and need to make a lot of changes.

But still, using DP GUI is the one recommended for most DP SysAdmin - more safer.

It is still a choice - CLI or DP GUI when doing administration work as it depends on the tehnical skills level of the SysAdmin.

Rgds,

Sherman

0 Likes
2 Replies
Highlighted
Luc Minnaert Outstanding Contributor.
Outstanding Contributor.

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

Jump to solution

Hello,

Even more powerfull:

with the sanconf executable scan and define your library

with omnidownload in a loop create an ascii file of each drive definition

with sed change parameters (like blocksize and default pool)

with omniupload update the IDB

Like this you can define in a huge environment "easily" f.i. an ESL lib with 8 drives in a non-multipath way !!!! 🙂

keep in mind: sanconf adds and updates drive definition.

to delete yu must specify special options.

I never understood why this  way of defining logica ldevices is not wide spread.

My colleague Stan Merckx even assisted me in porting my shell script to a DOS version !!!! including automated updating of the omnidownloaded files

Luc Minnaert

0 Likes
Micro Focus Expert
Micro Focus Expert

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

Jump to solution

Thanks Luc for sharing

Yes - I agree... using CLI, you can easily do things, most especially if you have a very huge environment and need to make a lot of changes.

But still, using DP GUI is the one recommended for most DP SysAdmin - more safer.

It is still a choice - CLI or DP GUI when doing administration work as it depends on the tehnical skills level of the SysAdmin.

Rgds,

Sherman

0 Likes
The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.