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