Job Management Partner 1/Base User's Guide

[Contents][Glossary][Index][Back][Next]

2.5.2 Backup and recovery (in Windows)

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:

For each environment in a cluster system, back up the physical hosts, and then the logical hosts.

(a) Definition files

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.conf		 JP1/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:

#2: Back up these files if you have enabled settings for delaying or monitoring service startup.

#3: Replace event-folder with the following folder:

#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-file

When you run JP1/Base in a cluster system, execute the following command:

jbsgetcnf -h logical-host-name > backup-file

(2) Event database

There are two modes of backing up event database files:

(a) Backup for data recovery

To back up the event database files:

  1. Stop all services that use JP1/Base.
  2. Stop JP1/Base.
  3. 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.
  4. Start JP1/Base.
  5. 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:

(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:

To recover the event database files:

  1. Stop all services that use JP1/Base.
  2. Stop JP1/Base.
  3. 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.
  4. Start JP1/Base.
  5. Restart the services that use JP1/Base.

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.