Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


21.6.2 Setup on a logical host

The following describes how to change the setting of the backup enhancement function on a logical host.

Organization of this subsection

(1) When creating a new logical host

When you create a new logical host, you can enable the backup enhancement function by executing the jajs_setup_cluster command with the -B option specified.

For details about how to create a new logical host, see 8.2.2 Procedure for setting up a cluster system environment (in Windows version of JP1/AJS3 - Manager) (for Windows) or 17.2.2 Procedure for setting up a cluster system environment (in UNIX version of JP1/AJS3 - Manager) (for UNIX).

For details about the jajs_setup_cluster command, see jajs_setup_cluster in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.

(2) When setting up an embedded database and adding a scheduler service

When you create a new embedded database and add a scheduler service, you can enable the backup enhancement function by executing the jajs_setup command with the -B option specified.

For details about how to set up a scheduler service and an embedded database on a logical host, see 8.2.10(1) Adding scheduler services on a logical host (for Windows) or 17.2.10(1) Adding scheduler services on a logical host (for UNIX).

For details about the jajs_setup command, see jajs_setup in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.

(3) When changing the setting of the backup enhancement function for the embedded database

To change the setting of the backup enhancement function for the operating embedded database:

  1. Back up the data of the embedded database for which you want to change the setting of the backup enhancement function.

    Back up the following types of information that were used in the embedded database:

    • Execution agent information

    • Definitions of units other than root job groups#

    • Root job group information#

    • Calendar information for root job groups#

    • Registered execution-schedule information for jobnets#

    #:

    If multiple scheduler services are set up on the embedded database for which you want to change the setting of the backup enhancement function, repeat the backup procedure as many times as the number of scheduler services. To check the number of scheduler services that are set up on the embedded database, execute the ajsembdbidlist command.

    For details about how to back up, see 2.2.3 Backing up the JP1/AJS3 - Manager setup information in the JP1/Automatic Job Management System 3 Administration Guide, and 3.4 Backing up and recovering the execution registration status of jobnets by using the ajsrgexport and ajsrgimport commands in the JP1/Automatic Job Management System 3 Administration Guide.

  2. Stop the JP1/AJS3 services on logical hosts.

    Stop all JP1/AJS3 services, including the JP1/AJS3 - Manager services, on physical hosts.

  3. Use the ajsembdbstatus command to check the settings of the embedded database that you want to change.

    For example, execute the ajsembdbstatus command as follows.

    (Example) If the setup identifier of the embedded database is _JFA

    ajsembdbstatus -c -id _JFA
  4. Use the ajsembdbunset -e command to delete the embedded database environment.

    For example, execute the ajsembdbunset command as follows.

    (Example) If the setup identifier of the embedded database is _JFA

    ajsembdbunset -e -id _JFA

    Information about all the scheduler databases set up in the embedded database having the specified setup identifier is deleted. For details about the ajsembdbunset command, see ajsembdbunset in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.

  5. Execute the ajsembdbbuild command to configure the embedded database.

    If you want to enable the backup enhancement function, execute the command with the -b option specified. If you want to disable this function, execute the command without specifying the -b option.

    For example, execute the command as follows if you want to enable the backup enhancement function.

    (Example) Configuring the embedded database in the following environment on logical host LHOST that operates on physical host HOST01

    • Database model: Small-scale

    • Data area directory: D:\ShareDisk\JP1AJS2\embdb\_JFA\dbarea

    • Embedded database practical directory: C:\Program Files (x86)\Hitachi\JP1AJS2\embdb\_JFA

    • Work area directory: C:\Program Files (x86)\Hitachi\JP1AJS2\embdb\_JFA\dbarea

    • setup identifier: _JFA

    • port number: 22230

    • backup enhancement function: Enabled

    ajsembdbbuild -s -r -d "D:\ShareDisk\JP1AJS2\embdb\_JFA\dbarea" -ld "C:\Program Files (x86)\Hitachi\JP1AJS2\embdb\_JFA\dbarea" -mh LHOST -eh HOST01 -i "C:\Program Files (x86)\Hitachi\JP1AJS2\embdb\_JFA" -id _JFA -p 22230 -b

    For details about the ajsembdbbuild command, see ajsembdbbuild in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.

  6. Execute the ajsembdbsetup command to set up the embedded database.

    If you want to enable the backup enhancement function, execute the command with the -b option specified. If you want to disable this function, execute the command without specifying the -b option.

    For example, execute the command as follows if you want to enable the backup enhancement function.

    (Example) Setting up scheduler service AJSROOTA with the backup enhancement function enabled in the following embedded database on logical host LHOST

    • Database model: Small-scale

    • setup identifier: _JFA

    • port number: 22230

    ajsembdbsetup -mh LHOST -F AJSROOTA -ru s -id _JFA -p 22230 -b

    If multiple scheduler services are set up in the embedded database for which you want to change the settings, execute the ajsembdbsetup command more than once so that the necessary scheduler database is set up. For details about the ajsembdbsetup command, see ajsembdbsetup in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.

  7. Use the ajsembdbstop command to stop the embedded database.

    For example, execute the ajsembdbstop command as follows.

    (Example) Stopping the embedded database whose setup identifier is _JFA

    ajsembdbstop -id _JFA

    For details about the ajsembdbstop command, see ajsembdbstop in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

  8. Cold-start the JP1/AJS3 service.

    For details about how to cold-start the JP1/AJS3 service, see 6.2.1 Temporarily changing the start mode of JP1/AJS3 in the JP1/Automatic Job Management System 3 Administration Guide.

    If you changed the setting of the backup enhancement function only for some embedded databases on the logical host, cold-start only the scheduler services that have data stored in those embedded databases.

  9. Recover the information that you backed up in step 1.

    If there are multiple scheduler services, repeat the recovery procedure as many times as the number of scheduler services. For details about the recovery procedure, see 2.3.4 Recovering the JP1/AJS3 - Manager setup information in the JP1/Automatic Job Management System 3 Administration Guide.

Supplementary notes

To cold-start some scheduler services only:

  1. Suppress the startup of the target scheduler services.

    Execute the jajs_config command, and then set the AUTOSTART environment setting parameter to no.

    For details about the jajs_config command, see jajs_config in 2. Commands Used during Setup in the manual JP1/Automatic Job Management System 3 Command Reference.

    For details about the AUTOSTART environment setting parameter, see 20.4.2(36) AUTOSTART.

  2. Start the JP1/AJS3 service.

  3. Cold-start the target scheduler services.

    Execute the ajsstart command with the -c option specified to cold-start the target scheduler services.

    For details about the ajsstart command, see ajsstart in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

  4. Cancel the suppression of the startup of the target scheduler services.

    Execute the jajs_config command, and then set the AUTOSTART environment setting parameter to yes.