SUMMARY
How to use bputil to change a client's master.ini
ISSUE
How can I view or edit a Protected Asset's (Client's) master.ini settings remotely?
RESOLUTION
You can use the bputil command from a Unitrends appliance to view or edit settings in a client's master.ini. Below are some examples and usage.
Execution Syntax and Legend
For more information, see the Cause section below.
/usr/bp/bin/bputil -g -c clientA Section Field String master_ini
clientA: Replace clientA with the name of the Protected Asset as listed in the Unitrends Protected Asset page.
Section: Replace Section with the name of the section in the master.ini file. A section is enclosed in square brackets [ ] .
Field: Replace Field with the name of the field that you need to replace. The Field is to the left of the = sign.
String: Replace String with the value that you wish to change. The String is to the right of the = sign.
Examples
The example below assumes the Protected Asset is named filesrv01.
Reading Data (get)
To read the value for the data= field (related to the data transport port)
- The -g tells the bputil to "get" the data for us
- The -c designates to Protected Asset which is named filesrv01
-
Section is BProfessional and is encapsulated in single quotes
- Field is data
-
String 0 is used as a spacer so that it will send us the actual value
-
The output (in this case, 1744) is returned on the next line.
[root@UBme ~]# /usr/bp/bin/bputil -g -c filesrv01 'BProfessional' data 0 master_ini
1744
Other Reading Data (get) examples:
Field wbps
/usr/bp/bin/bputil -g -c filesrv01 debugging wbps -1 master_ini
Returns “0” when log level is set to 0.
Fields USnapEnable
/usr/bp/bin/bputil -g -c filesrv01 usnap USnapEnable -1 master_ini
Returns “True” when client is set to use snapshots.
Editing Data (put)
- The -p tells the bputil to "put" data into the file. This will either modify the current field or add it.
- In the example below, are are changing the data port to 1745
[root@UB107 ~]# /usr/bp/bin/bputil -p -c filesrv01 'Configuration Options' data 1745 master_ini
NOTE: No output will be displayed. You will need to use the 'get' option to verify the change is accurate.
Other Editing Data (put) examples:
# Increase the log level for wbps
/usr/bp/bin/bputil -p -c filesrv01 debugging wbps 3 master_ini
# Disable the client’s usage of snapshots.
/usr/bp/bin/bputil -p -c filesrv01 usnap USnapEnable False master_ini
CAUSE
Usage: bputil <-gporfnticsXi> <args...>
Usage: bputil <-bldjsePVFDATOCLamkquHGEHRKzSPACE> <args...>
args for:
-b (Change Backup record)
<#no><TYPE,STATUS,START_DIR_NO,NODE_NO,TAPE_NO,START_TIME,JOB_NO,FILESET_NO,COMMENT><DEL><UNDEL><value>
-g (getstring):
[-b] [-c <ClientName>] <Section|"NULL"> <Label|"NULL"> <Default> <ini_file>
-p (putstring):
[-b] [-c <ClientName>] <Section> <Label> <String> <ini_file>
-o (copy section):
<From Section> <To Section> <ini_file>
-r (remove section):
<Section> <ini_file>
-f (copy section file -> file):
<Section> <From ini_file> <To ini_file>
-n (get proper hostname):
[-l] [hostname]
-t (get node info):
[nodename|nodeno]
-s (file checksum):
<file...>
-d (device update):
<dev_name> SLOT_INFO <slot #>
RESERVE pid comment
FREE pid
REPORT_TAPE_LABELS
MUX_MAXCNT <number>
PURGE < space required (Megabytes) >
-j (job comment update), -p is optional & follows comment:
<job_no> <comment>
<job_no> <comment> -p <percent_done>
-js (Update job status) <job_no><STATUS ....>
-zSPACE <device name> Calculate Space Reserve Index for the device
-e (print Env. space [-c] Conditional format)
-O Open raw check only
-T Remove last backup on tape <tape no>
-C Check DbHostname <name>
-L Get local host name as in DB
-a Re-label all tapes in DB only | <specific_tape_no> <Tape label text>
-m Move Client last_restore field
-R [nodeno] Reset Clients last backups
-HB How many backups are there to be purged w/ reorgdb PurgeLogicallyDeletedBackups
-HF How many Filesets are there to be purged w/ reorgdb PurgeFilesetsUnref
-q <#device number to hold/unhold>
-G <-i ignore case> string filenames[]
-J <nick-name> Print environment for juke device nick-name
-E <nick-name> Print environment for device nick-name
-N <client number> to delete from Database
-yL Convert the lcs_client record to the new key format.
-W <backup_no> Resets the sync_needed flag for the backup.
-w <hostname:remotefile> <localfile> Copy file from client to server