Synopsis
[Windows]
mpbko drive name:directory name [/Ca|/Cs] [/d] [/SN]
[UNIX]
mpbko -b Directory [-d] [-SN]Description
This command backs up operation management information such as environment definition information and job scheduling information stored on the Systemwalker Operation Manager server to the specified directory.
Options
drive name:directory name [Windows]
Specify the backup directory. Specify this option with up to 32 alphanumeric characters. Blanks cannot be used.
Specify the drive name of the backup destination hard disk (which should be write-enabled).
Specify the backup directory.
-b Directory [UNIX]
Specify the full path of the backup directory in alphanumeric characters. If the specified directory does not exist, it will be created automatically. Blanks cannot be contained in the directory name of the backup destination.
/Ca|/Cs [Windows]
Use this option for backup on a cluster system. Omit this option if you wish to back up information in a normal system for non-cluster operations. You must specify this option after "drive name: directory name."
Use this option for backup on a running node. Information stored on a running node and shared disk will be backed up.
Use this option for backup on a standby node. Information stored on a standby node will be backed up.
/d [Windows]
-d [UNIX]
Use this option for backup of resources in silent mode without outputting any confirmation message at backup. When specifying this option, the backup directory must be empty and if not, this command will terminate with an error.
/SN [Windows]
-SN [UNIX]
Use this option for backup without stopping Systemwalker Operation Manager services/daemons.
Return Values
Return value | Meaning |
|---|---|
0 | Normal termination |
1 | Abnormal termination |
Command Location
Windows | <Systemwalker Operation Manager installation directory>\MpWalker.JM\MpCmtool\backup\bin |
Solaris | /opt/systemwalker/bin |
Privilege Required
System administrator (user belonging to the Administrators group or superuser) privileges are required.
Cautions
When specifying a backup directory with this command, it must be specified with a full path name.
If you execute this command without the /SN or -SN option, any active service/daemon temporarily stops. In an environment where Systemwalker Centric Manager and Systemwalker Operation Manager coexist, the services/daemons of the two systems stop simultaneously.
It is recommended that the Operation Environment Maintenance Wizard be used to back up the operation environment, in order to avoid operating errors, errors entering the command, or similar errors. Refer to "Backing Up or Restoring Operation Environment" in the Systemwalker Operation Manager Installation Guide for details on the procedure. When executing the command, take care to avoid operating errors and errors entering the command. [Windows]
Before executing this command, be sure to check the following:
Access privileges to the backup directory are granted.
There is plenty of free space in the backup directory. See "Backup Capacity" for required space.
If the backup was not successful, check the following. And then execute the mpbko command again after taking an appropriate action.
Access privileges to the backup directory are granted
There is plenty of free space in the backup directory. See "Backup Capacity" for required space.
If a backup is made and the information is restored while a job, job net or group is running, the job, job net or group will be terminated abnormally with completion code 239. We therefore recommend to make a backup during the time when a job, job net or group is not running.
Directory name located on the network drive cannot be specified.
Backup Capacity
[Windows]
The capacity required on the backup directory varies depending on the environment or on the amount of registered data. Estimate the required capacity on the basis of the following values: Calculate the capacity of the variable part and add it to the capacity of the fixed part.
The fixed part has a capacity of 586 Kilobytes.
The capacity of the variable part is as follows:
When the calendar function is used:
Number of calendars x 6 Kilobytes
When the event monitoring function is used:
Number of event lines defined x 2 Kilobytes
This number is equal to the number of lines in a list, which is displayed as the line count in the [Monitored Event Table] window.
When Jobscheduler is used:
Number of projects registered x 1.5 Kilobytes
Number of job nets x 8 Kilobytes
Number of jobs x 2 Kilobytes
Number of groups x 2.4 Kilobytes
Number of job nets in each group x 12 Kilobytes
Total capacity of various exits
Total capacity for output (stdout/stderr) from all jobs
Specified log size x 3 bytes
When Job Execution Control is used:
Number of job folders x 1 Kilobyte
Number of job owners x 0.5 Kilobyte
Number of queues x 4 Kilobytes
Maximum number of jobs acceptable by the system x 40 Kilobytes
debug.log file size (not fixed)
[UNIX]
See the following calculation formula for required space on the backup
Total size of directories under "/etc/opt/FJSV*" + Total space of the directories under "/var/opt/FJSV*" |
FJSV*: Package name of component that is contained in the product.
FJSV* needs to be replaced depending on the OS as follows. Calculate the capacity after replacing it with the corresponding value.
Solaris version--> FJSV*
Linux version--> FJSV*
HP-UX version--> FHP*
AIX version--> FAIX*
Examples
[Windows]
The following is a setting example for backing up the operation management information and log information such as the environment definition information for the Systemwalker Operation Manager server and job scheduling information in the "d:\tmp\OMGRBack" directory if Systemwalker Operation Manager is installed under "c:\win32app."
cd c:\win32app\MpWalker.JM\MpCmtool\backup\bin mpbko d:\tmp\OMGRBack
[UNIX]
The following is an example for backing up the resources to the "/backup" directory.
/opt/systemwalker/bin/mpbko -b /backup
Information
Registering mpbko command as a job
The mpbko command can be registered as a job. If it is actually registered as a job, ensure you do the following:
Specify the /SN or -SN option so as not to stop the services or daemons during the backup.
Specify the /d or -d option to the command so as not to output any confirmation messages during the backup.
Check that the backup destination directory is empty before performing the backup.