Job Management Partner 1/Automatic Job Management System 3 Administration Guide

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


2.3.3 Recovering the JP1/AJS3 - Manager setup information

The following table lists the tasks required to recover the JP1/AJS3 - Manager setup information from the backup.

Table 2-16 Tasks for recovering the JP1/AJS3 - Manager setup information

Task Windows UNIX
Recovering the physical host environment and logical host environment Y Y
Recovering the definition files Y Y
Clearing the information in the shared memory N/A Y
Creating a scheduler service database Y Y
Creating an execution environment for QUEUE jobs and submitted jobs
(only if QUEUE jobs and submitted jobs are used)
Y Y
Recovering the execution agent information Y Y
Recovering the unit definition Y Y
Starting JP1/AJS3 (cold start) Y Y
Recovering the JP1/AJS3 Console setup information
(only if the JP1/AJS3 Console functionality is used)
Y Y

Legend:
Y: Required
N/A: Not applicable

The following describes the tasks required to recover the JP1/AJS3 - Manager setup information from the backup.

Organization of this subsection
(1) Recovering the physical host environment and logical host environment
(2) Recovering the definition files
(3) Clearing the information in the shared memory (only in UNIX)
(4) Creating the scheduler service database
(5) Creating an execution environment for QUEUE jobs and submitted jobs
(6) Starting JP1/AJS3
(7) Recovering the execution agent information
(8) Recovering the unit definition
(9) Recovering and setting up the JP1/AJS3 Console setup information

(1) Recovering the physical host environment and logical host environment

After setting up JP1/AJS3 - Manager, recover the physical host environment and logical host environment. For details about the settings required for recovery, see 3.1.2 Setting up JP1/AJS3 - Manager in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (in Windows) or 12.1.2 Setting up JP1/AJS3 - Manager in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (in UNIX).

(2) Recovering the definition files

Restore the definition files that were backed up to their original locations.

Cautionary note
Before you recover the definition files, make sure that the following conditions exist:
  1. JP1/Base is installed, and the physical host environment has been set up.
  2. JP1/AJS3 is installed, and the physical host environment has been set up.
  3. JP1 in the logical host environment has been set up (for recovery of a logical host environment).
  4. JP1/Base and JP1/AJS3 are not running.
  5. The shared disk is mounted (to recover the settings file of a logical host).

(3) Clearing the information in the shared memory (only in UNIX)

Clear the information about the scheduler services saved in the shared memory when JP1/AJS3 was running. If information remains in the shared memory, the scheduler services restored by the recovery processing might be affected.

To clear the information in the shared memory:

  1. Execute the following command to make sure that all JP1/AJS3 services have stopped.
    • To check a physical host:

      # /opt/jp1ajs2/bin/jajs_spmd_status

    • To check a logical host:

      # /opt/jp1ajs2/bin/jajs_spmd_status -h logical-host-name

    • To check the JP1/AJS3 monitor functions:

      # ps -ef | grep ajsinetd

    Cautionary note
    Stop all the JP1/AJS3 services.
  2. Execute the following command to clear the information about the scheduler services saved in the shared memory.
     
    # /opt/jp1ajs2/bin/ajsshmdel
     

(4) Creating the scheduler service database

If the scheduler service database is corrupted, you need to re-create it as described below.

Note that you need to stop all the JP1/AJS3 services when creating a scheduler service database. In UNIX, use the procedure in (3) Clearing the information in the shared memory (only in UNIX).

To create the scheduler service database :

  1. Execute the ajsembdbunset command to delete the embedded database environment.
     
    ajsembdbunset -e -id embedded-database-setup-identifier
     
  2. Execute the ajsembdbbuild command to create the embedded database environment.
    For details about how to use the ajsembdbbuild command to create an embedded database environment, see C.2(3) Setting up the embedded database environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1.
    For details about how to create an embedded database environment on the primary node in a logical host environment, see D.2(3) Setting up the embedded database environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1. For details about how to create an embedded database environment on the secondary node, see D.3(3) Setting up the embedded database environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1.
  3. Execute the ajsembdbsetup command to set up the JP1/AJS3 environment in the embedded database environment.
    For details about how to use the ajsembdbsetup command to set up the JP1/AJS3 environment, see C.2(5) Setting up the scheduler database in an embedded database environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1.
    For details about how to set up the JP1/AJS3 environment on the primary node in a logical host environment, see D.2(5) Setting up the scheduler database in an embedded database environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1. For details about how to set up the JP1/AJS3 environment on the secondary node, see D.3(5) Setting up the scheduler database in an embedded database environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1.

(5) Creating an execution environment for QUEUE jobs and submitted jobs

Use the recovered configuration definition file (jpqsetup.conf) for the execution environment for QUEUE jobs and submitted jobs to create the execution environment for QUEUE jobs and submitted jobs.

Before creating the execution environment for QUEUE jobs and submitted jobs, make sure that the JP1/AJS3 service on the target logical host is not running.

To create an execution environment:

  1. Delete the files in the folder containing the queue information database.

    (a) For a physical host
    • In Windows Server 2008:
      del system-drive\ProgramData\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\database\queue\*

    • In Windows Server 2003:
      del JP1/AJS3-Manager-installation-folder\jp1ajs2\database\queue\*

    • In UNIX:
      rm /var/opt/jp1ajs2/database/queue/*

    (b) For a logical host
    • In Windows:

      del shared-folder\jp1ajs2\database\queue\*

    • In UNIX:

      rm shared-directory/jp1ajs2/database/queue/*

  2. Execute the following command to create an execution environment for QUEUE jobs and submitted jobs.
     
    jpqimport -dt isam -ci jpqsetup.conf  [-mh logical-host-name]

    Cautionary note
    For the configuration definition file (jpqsetup.conf) for the execution environment of QUEUE jobs and submitted jobs, use the recovered file.
    To recover a logical host definition, specify the logical host name in the -mh option.

(6) Starting JP1/AJS3

Restart the JP1/AJS3 services with a cold start.

(7) Recovering the execution agent information

The following describes the tasks required to recover the execution agent information.

Execute the following command to recover the execution agent information from the backup of the execution agent definition file.

 
ajsagtadd [-h manager-host-name] -f execution-agent-definition-file [-i]
 

Cautionary note
If an error occurs during the processing to add information, the processing stops immediately. However, you can specify the -i option to continue the processing even if an error has occurred.

(8) Recovering the unit definition

The following describes the tasks required to recover the setup information of jobnets and calendars. Recover the setup information for each scheduler service.

Cautionary note
For this recovery procedure only, the unit for recovery is by scheduler service rather than by logical host. Accordingly, recover the setup information for each scheduler service separately.

(a) Recovering the definition information for units other than the root job group

Execute the following command to recover the definition information for the units in the scheduler service. The definition information includes the base time, comments, and all other definitions for each unit, but does not include information about the root job group (/), such as the base time, base day, and base month. To recover the root job group information, use the procedures in (b) Recovering the information of the root job group and (c) Backing up the calendar information of the root job group below.

 
ajsdefine -F scheduler-service-name unitbackup.txt
 

If the information has been split by job group or jobnet during backup, execute the following command for each backup unit to be recovered.

 
ajsdefine -F scheduler-service-name -d definition-destination-unit-name unit-name_backup.txt

(b) Recovering the information about the root job group

Set the following information about the root job group that you have recorded.

(c) Recovering the calendar information for the root job group

Execute the following command to recover the calendar information (open days and close days) for the root job group.

 
ajscalendar -F scheduler-service-name -df rootcal.txt /
 

Cautionary note
This command recovers the calendar of the scheduler service itself.
If no calendar information has been output to rootcal.txt, recovery is not needed. For details, see the backup procedure.

(9) Recovering and setting up the JP1/AJS3 Console setup information

When the JP1/AJS3 Console functionality is used, perform the operations below.

Cautionary note
Before you start recovery and setup, make sure that the following conditions exist:
  • JP1/AJS3 Console Manager, JP1/AJS3 Console Agent, and other JP1 series programs that require JP1/Base are not running.
  • The shared disk is mounted (to recover the setup information for a logical host).

(a) Recovering the JP1/AJS3 Console setup information

Restore the JP1/AJS3 Console backup files to their original locations.

(b) Setting up JP1/AJS3 Console

Set up JP1/AJS3 Console Manager and JP1/AJS3 Console Agent.

[Contents][Back][Next]


[Trademarks]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.