May the source be with you, but remember the KISS principle ;-)
Home Switchboard Unix Administration Red Hat TCP/IP Networks Neoliberalism Toxic Managers
(slightly skeptical) Educational society promoting "Back to basics" movement against IT overcomplexity and  bastardization of classic Unix

wbkupdb command

News Recommended Links Redbooks Support cycle Perl Scripts BAROC User Groups
TMF TEC ITM6.1 ITM 5.1 TCM TWC Netview
wlookup odadmin command wchkdb wlsinst      
wbkupdb wtrace winstlcf  Tivoli lcdf daemon Troubleshooting Endpoints    
wlsinst wep command wadminep Postemsg and wpostemsg   IBM humor Etc

wbkupdb command -- Backs up and restores Tivoli object databases.

The wbkupdb command backs up and restores Tivoli object databases. You can provide a list of managed node names as options to the wbkupdb command. If you do not specify any node options, the wbkupdb command backs up or restores the Tivoli object database for every managed node in the Tivoli region.


  1. If you are unable to capture a full backup because of the high activity level of your Tivoli region, you can use the wlocktmr command to place your Tivoli region in maintenance mode and then run the wbkupdb command again. For more information about placing a Tivoli region in maintenance mode, refer to Tivoli Management Framework Maintenance and Troubleshooting Guide.
  2. The backup is written to the $DBDIR directory.
  3. For a Tivoli server, recovered files are as follows:


When the -e option is used, this command estimates the total size of the backup archive. The wbkupdb -e command estimates the size of the backup of each managed node and the total size of the archive. This report is an estimate, but it is very close to the actual size of the backup image.

The third and fourth forms of this command (as shown in the syntax) back up the database and store it in the specified file or device on the specified system. If the backup file already exists and is a disk file, you must specify the -f option to overwrite the old backup file.

When the -r option is used, this command restores Tivoli object databases. This is primarily useful for reverting to a previously saved copy of the Tivoli object databases that you backed up. The Tivoli server or managed node that is to be restored must have Tivoli Management Framework operational. If a restore operation is being performed from a system other than the Tivoli server, you cannot restore both the Tivoli server and the local database unless you specify the -R option. If you restore the local database, you must use the explicit node_name syntax and specify the local node at the end or specify the -R option.

If the object dispatcher that is to be restored is not running (and presumably cannot be run because its database is corrupted or missing), you can extract the database manually and put the files in the correct location in the database directory.

The wbkupdb command also saves any old versions of files and the notification database. Typically, these are not restored, because you probably do not want to read notices that have already been read. If for some reason the file is destroyed, you can restore it manually. The \files_versions directory is not restored. If you want to see old revisions of system files, the files can be moved from the \files_versions.restore directory as necessary.

The following list details the files and databases backed up in the temporary directory on UNIX and Windows managed nodes and Tivoli servers:


Blocks the writing of data to the Tivoli object databases during the backup. When you specify this option, the object dispatcher does not write data to the Tivoli object database while the database is backed up. After the backup operation completes, any write operations that queued during the backup operation are written to the database. Use the -b option when you want to ensure that the Tivoli object databases are unchanged for the duration of the backup, for example, in a very busy Tivoli environment. If you use the -b option to back up a node that has not been upgraded to a version of Tivoli Management Framework that contains this feature, the standard backup method is used for that node.

The -b option causes the backup operation to check for needed disk space before performing the backup. A warning message is displayed if sufficient disk space is not available.


The needed disk space is estimated by calculating twice the sum of the sizes of odb.bdb and imdb.bdb. In some environments, this estimate might be too low. For these situations, you can set the TIVBACKUPSIZE environment variable to override the estimate produced by the -b option. Set the value for TIVBACKUPSIZE in KB. On Windows operating systems, TIVBACKUPSIZE must be a system environment variable.


When you specify this option, the object dispatcher writes error messages that result from the backup to the oservlog file.

-d device
Specifies the file or device to which the backup file should be saved or from which the backup file should be retrieved. If you specify a file name, you can insert a file date and time anywhere in the file name by adding the %t variable. This variable is replaced with a time stamp in the form Mondd-hhmm. For example, if you specify -d /usr/backups/TMR1%t.bk, the resulting file is named TMR1Dec21-0955.bk. The time is displayed in 24-hour mode.
Estimates the size of the backup.
Overwrites a previous backup file of the same name.
-h node_name
Specifies the system that contains the .tar file that is created by the wbkupdb command. The default is the Tivoli server.
Specifies that options on the command line are object and label pairs. This option is for internal use only.
Restores the databases for the specified nodes.
Does not restart object dispatchers after restoring the database files. A number of .restore files are placed in the database directory. To effect the changes, use the reexec option of the odadmin command or one of its derivatives to restart the object dispatchers so that they pick up the restored copies of the databases.
Suppresses display of an initial desktop message for each managed node being backed up.
Specifies the node to be backed up. You can specify multiple nodes.
Specifies a backup object identifier.


To create a backup, the backup role in the Tivoli region is required.

To restore from a backup, the restore role in the Tivoli region to perform a restore operation is required.

The default backup directory requires root write permission. Log in as the root administrator or change the location of the backup file. If you are performing a "rescue" operation, you must be root on the machine where the crashed database is located.


  1. The following example backs up the Tivoli object databases for all managed nodes in the Tivoli region, and writes the backups to the /usr/backups/TMR1.bkfile:
    wbkupdb -d /usr/backups/TMR1.bk
  2. The following example backs up the database of managed node sherman. Because no backup file is specified, the backup is written to the $DBDIR directory.
    wbkupdb sherman
  3. The following example restores the database to managed node sherman by using the /usr/backups/TMR1.bk backup file:
    wbkupdb -r -d /usr/backups/TMR1.bk sherman

See Also

wchkdb, wclient, winstall, wpatch, wserver



Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy


War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotesSomerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose BierceBernard Shaw : Mark Twain Quotes


Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law


Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOSProgramming Languages History : PL/1 : Simula 67 : C : History of GCC developmentScripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

Classic books:

The Peter Principle : Parkinson Law : 1984 : The Mythical Man-MonthHow to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Haterís Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

Most popular humor pages:

Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

Copyright © 1996-2021 by Softpanorama Society. was initially created as a service to the (now defunct) UN Sustainable Development Networking Programme (SDNP) without any remuneration. This document is an industrial compilation designed and created exclusively for educational use and is distributed under the Softpanorama Content License. Original materials copyright belong to respective owners. Quotes are made for educational purposes only in compliance with the fair use doctrine.

FAIR USE NOTICE This site contains copyrighted material the use of which has not always been specifically authorized by the copyright owner. We are making such material available to advance understanding of computer science, IT technology, economic, scientific, and social issues. We believe this constitutes a 'fair use' of any such copyrighted material as provided by section 107 of the US Copyright Law according to which such material can be distributed without profit exclusively for research and educational purposes.

This is a Spartan WHYFF (We Help You For Free) site written by people for whom English is not a native language. Grammar and spelling errors should be expected. The site contain some broken links as it develops like a living tree...

You can use PayPal to to buy a cup of coffee for authors of this site


The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Last modified: March 12, 2019