Job Management Partner 1/Base User's Guide
The following describes the backup and recovery of setup information and event databases in the Windows version of JP1/Base.
- Organization of this subsection
- (1) Backing up JP1/Base setup information
- (2) Event database
- (3) Recovering JP1/Base setup information
- (4) Recovering the event database
(1) Backing up JP1/Base setup information
JP1/Base setup information includes:
- Definition files
- Common definition information
For each environment in a cluster system, back up the physical hosts, and then the logical hosts.
The following table lists the definition files that users set in JP1/Base. Back up these files by copying them or by some other means.
Table 2-5 JP1/Base files to back up in Windows
File name Contents JP1/Base-folder#1\boot\JP1SVPRM.DAT Start sequence definition file JP1/Base-folder#1\boot\jp1svprm_wait.dat Service starting delay time / timer monitoring period definition file#2 JP1/Base-folder#1\jp1bs_env.conf JP1/Base environment settings file JP1/Base-folder#1\jp1bs_param.conf
JP1/Base-folder#1\jp1bs_param_V7.confJP1/Base parameter definition file JP1/Base-folder#1\jp1bs_spmd.conf JP1/Base process management definition file JP1/Base-folder#1\jp1bs_service_0700.conf Extended startup process definition file Files in JP1/Base-folder#1\route\ Configuration definition file
(used by JP1/IM)JP1/Base-folder#1\user_acl\JP1_Passwd JP1 user definition file JP1/Base-folder#1\user_acl\JP1_Group JP1 group definition file JP1/Base-folder#1\user_acl\JP1_UserLevel JP1 permission levels definition file JP1/Base-folder#1\user_acl\JP1_AccessLevel JP1 resource group definition file JP1/Base-folder#1\user_acl\JP1_Accountaccess JP1 account access information file JP1/Base-folder#1\user_acl\jp1BsUmap.conf User mapping definition file JP1/Base-folder#1\ds\jp1bs_ds_setup.conf Directory server linkage definition file JP1/Base-folder#1\evtgw\imevtgw.conf Action definition file for converting SNMP traps JP1/Base-folder#1\evtgw\snmpfilter.conf Filter file for converting SNMP traps JP1/Base-folder#1\event\index Event server index file event-folder#3\conf Event server settings file event-folder#3\forward Forwarding settings file JP1/Base-folder#1\event\api API settings file JP1/Base-folder#1\event\ntevent.conf Action definition file for event log traps Any-file#3 or JP1/Base-folder#1\jevlog.conf#4 Action definition file for log file trapping event-folder#3\[jev_forward.conf | any-file]#5 Distribution definition file (for forward setting file) JP1/Base-folder#1\[jev_logtrap.conf | any-file]#5 Distribution definition file (for action definition file for log file trapping) JP1/Base-folder#1\event\[jev_ntevent.conf | any-file]#5 Distribution definition file (for action definition file for event log traps) any-file Password definition file (Windows only) JP1/Base-folder#1\user_acl\JP1_UserLevel User permission level file any-file Directory server modification file (Windows only) installation-folder\plugin\conf\*.conf Adapter command settings file JP1/Base-folder#1\jbshc\jbshc.conf Health check definition file any-file Common definition settings file (health check function) JP1/Base-folder#1\jp1hosts jp1hosts definition file JP1/Base-folder#1\jbsdfts\*.conf Service management control definition file any-file Local action environment variable file JP1/Base-folder#1\lcact\jbslcact.conf Local action execution definition file any-file Common definition settings file (local action function) JP1/Base-folder#1\physical_ipany.conf Communication protocol settings file JP1/Base-folder#1\logical_ipany.conf JP1/Base-folder#1\physical_recovery_0651.conf JP1/Base-folder#1\logical_recovery_0651.conf JP1/Base-folder#1\physical_anyany.conf JP1/Base-folder#1\physical_ipip.conf JP1/Base-folder#1\logical_ipip.conf JP1/Base-folder#1\jp1bs_baselog_setup.conf Operation log definition file #1: Replace JP1/Base-folder with the following folder:
- Physical host: installation-folder\conf
- Logical host: shared-folder\jp1base\conf
#2: Back up these files if you have enabled settings for delaying or monitoring service startup.
#3: Replace event-folder with the following folder:
- Physical host: installation-folder\conf\event\servers\default
- Logical host: shared-folder\jp1base\event
#4: You can assign any name to the action definition file for log file trapping. Remember to back up all the log files you are using. If you are not using the log file trapping, no action definition file for log file trapping will exist.
#5: You can create a distribution definition file using either the default file name or any other name. Remember to back up all the log files you are using. If you are not using the function for collecting and distributing definitions, no distribution definition file will exist.
- Note
- Backup and recovery do not apply to integrated trace log settings. If you have modified integrated trace log settings, you must reconfigure them when setting up JP1/Base.
(b) Common definition information
In JP1/Base, you must back up common definition information as well as the definition files. This information includes common definition information for JP1/Base, JP1/IM, and JP1/AJS. It is not possible to collect definition information separately for each of these program products.
To back up the common definition file, execute the following command:
jbsgetcnf > backup-fileWhen you run JP1/Base in a cluster system, execute the following command:
jbsgetcnf -h logical-host-name > backup-file
There are two modes of backing up event database files:
- Backup for data recovery
- Backup for error reporting
(a) Backup for data recovery
To back up the event database files:
- Stop all services that use JP1/Base.
- Stop JP1/Base.
- Copy or otherwise back up the event database files.
Back up the following files:
installation-folder\sys\event\servers\default\IMEvent*.*#
or
shared-folder\jp1base\event\IMEvent*.*#
#: If a different path is specified in the event server index file (index) as the folder to be used by the event server, back up the files in that path.
- Start JP1/Base.
- Restart the services that use JP1/Base.
(b) Backup for error reporting
To back up an event database for error reporting purposes, use the jevexport command to output the database contents to a CSV-format file.
Each event server has two event databases. When one database is full (maximum 10 MB by default), the other event database is swapped in. The existing contents of the swapped-in database are erased. You should regularly check how large the event database has become, and execute the jevexport command before the event databases are swapped over.
(3) Recovering JP1/Base setup information
The following describes recovery for JP1/Base. In a cluster system, recover the physical hosts, and then the logical hosts for each environment.
(a) Recovering definition files
To recover the definition files, restore the backup files in the original locations. Make sure that the following conditions are satisfied before you start:
- JP1/Base is successfully installed.
- JP1/Base is stopped.
- JP1/Base in the logical host environment is set up (for a logical host).
- The shared disk is online (for a logical host).
(b) Recovering the common definition information
To recover common definition information, you also need to restore the backup of common definition information in addition to the definition files described above.
Execute the following command:
jbssetcnf name-of-backup-file-backed-up-in-(1)(b)
(4) Recovering the event database
The following conditions apply for successful recovery of backed-up event database files:
- Only a brief time elapsed between backup and recovery. It is also possible very few JP1 events were registered in the interval between backup and recovery.
- You switched to a different machine but did not change the host name.
To recover the event database files:
- Stop all services that use JP1/Base.
- Stop JP1/Base.
- Move the backed-up files.
Place the files in this folder:
installation-folder\sys\event\servers\default\#
or
shared-folder\jp1base\event\#
#: If a different path is specified in the event server index file (index) as the folder to be used by the event server, place the files in that path.
- Start JP1/Base.
- Restart the services that use JP1/Base.
All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.