2.5.2 Backing up

(1) Backing up data other than the embedded database

Backup data created by using the backup enhancement function can be recovered only in the same environment as the one in which the backup was created. Therefore, you must create necessary backups (for example, back up the entire system) so that you can configure the same embedded database environment as the backup environment. We recommend that you create a backup when any change is made to the system configuration or to the environment settings information. For details about how to back up data, see 5.2 Backups and recovery in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide and 2.2 Backing up the setup information for a system that uses JP1/AJS3.

To Page Top

(2) Backing up the embedded database

Backing up data of the embedded database allows you to recover information that is updated daily, such as jobnet definitions and registration statuses. If you perform backup on a regular basis, such as at the end of work each day, you can recover data in a condition close to the condition of data when the error occurred.

To back up the embedded database:

1. Create a backup data storage directory on the local disk.

   The backup data storage directory requires sufficient free space to accommodate the embedded database to be backed up. The following table provides estimates on the required amount of free space.

   Table 2‒21: Embedded database models and the required free space

   Database model	Required free space
   Large scale	About 7,200 MB
   Medium scale	About 1,900 MB
   Small scale	About 700 MB

   If the database area has been expanded by using the ajsembdbaddarea command, additional free space equivalent to the area added by the expansion is required. Similarly, if the database auto-increment function is enabled, additional free space equivalent to the area added by the function is required.

   For details about the database auto-increment function, see 23.2 Estimating the database area in the JP1/Automatic Job Management System 3 Configuration Guide.

2. Confirm that the embedded database is running.

   Execute the ajsembdbstatus command to confirm that the embedded database to be backed up is running (that is, ONLINE is indicated for UNIT-STAT).

   The following are examples of using the ajsembdbstatus command:

   ajsembdbstatus -s ust -id embedded-database-setup-ID

   If the embedded database is not running, execute the ajsembdbstart command with the -id embedded-database-setup-ID option specified.

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

3. Execute the jajs_dbbackup command.

   Execute the command with the following specified: the setup identifier of the embedded database to be backed up and the backup data storage directory. The following shows an execution example:

   jajs_dbbackup -id embedded-database-setup-ID -o Backup-date-storage-directory

   Backup data of the embedded database is stored under the specified backup data storage directory.

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

Cautionary notes

• Do not create the backup data storage directory on a network drive. If you specify a network drive for the backup data storage directory, subsequent operation cannot be guaranteed.

• The execution of jobs is suspended while the jajs_dbbackup command is creating a backup. Use the jajs_dbbackup command when no jobs are to be executed.

• For details about how to cancel the execution of the jajs_dbbackup command, see (4) Canceling the processing to back up the embedded database.

To Page Top

(3) Obtaining information about the backup environment

To recover data from a backup, you need the following information to confirm the prerequisites for recovery. We recommend that you obtain the information when you execute the jajs_dbbackup command.

ajsembdbidlist -v

ajsembdbstatus -c

ajsembdbidlist

To Page Top

(4) Canceling the processing to back up the embedded database

In general, do not cancel backup processing of the embedded DB performed by using the jajs_dbbackup command. If you want to stop processing at a given time, execute the jajs_dbbackup command with the timeout period specified for the -t option. Note that if you want to cancel backup processing without waiting for the timeout period to expire, during an emergency etc., perform the following cancellation procedure:

1. Set the environment variables required to execute commands for the embedded database.

   The following table describes the environment variables you need to set.

   Table 2‒22: Environment variable that need to be set

   Environment variable	Value to be specified
   PATH	This is the directory in which commands for the embedded database are stored. In Windows: Specify embedded-database-practical-directory\bin In UNIX: Specify embedded-database-practical-directory/bin
   PDCONFPATH	This is the directory in which definition files for the embedded database are stored. In Windows: Specify embedded-database-practical-directory\conf In UNIX: Specify embedded-database-practical-directory/conf
   PDDIR	Specify the name of the embedded database practical directory.
   PDLANG	Specify ANY.
   PDUSER	Specify the user name and password of the embedded database administrator (the owner of the tables of the scheduler database) in user-name/password format. Example: PDUSER="root"/"root"
   PDUXPLDIR	In Windows only, specify the name of the work directory for the embedded database.
   SHLIB_PATH#	In UNIX only, specify embedded-database-practical-directory/lib.

   #

   This is LD_LIBRARY_PATH in Solaris or Linux, and LIBPATH in AIX.

   Example of environment variable settings in Windows:

   x:\> set PDDIR=c:\Program Files\HITACHI\JP1AJS2\embdb\_JF0
   x:\> set PDCONFPATH=%PDDIR%\conf
   x:\> set PDUXPLDIR=%PDDIR%\uxpldir
    
   x:\> set PDUSER="root"/"root"
   x:\> set PDLANG=ANY
   x:\> set PATH=%PATH%;%PDDIR%\bin

   Example of environment variable settings in UNIX (HP-UX):

   # PDDIR=/opt/jp1ajs2/embdb/_JF0
   # PDCONFPATH=$PDDIR/conf
   # PDUSER='"root"/"root"'
   # PDLANG=ANY
   # SHLIB_PATH=$PDDIR/lib
   # PATH=$PATH:$PDDIR/bin
    
   # export PDDIR PDCONFPATH PDUSER PDLANG SHLIB_PATH PATH

2. Obtain the server name and process ID of the backup processing.

   Execute the following command to confirm the server name (SVID) and the process ID (PID). The server name is in the form of 0bcpyx, where x is a numeric value such as 0, 1, or 2.

   pdls -d prc -a

3. Cancel the backup processing.

   Cancel the backup processing by executing the ajsembdbcancel command with the following specified: the server name and process ID you confirmed in step 2.

   The following are examples of using the command:

   ajsembdbcancel -u server-name -p process-ID -id embedded-database-setup-identifier

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

Cautionary note:

If you cancel backup processing, wait for several minutes (approximately 2 minutes) from the start of backup processing.

If you cancel backup processing without waiting, backup processing will be re-executed because backup processing is retried as a result of the jajs_dbbackup command for several minutes after the start of backup processing.

To Page Top