2.5.2 Backing up
This subsection describes how to back up JP1/AJS3 - Manager during operation by using the backup enhancement function.
- Organization of this subsection
(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.
(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:
-
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.
-
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.
-
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.
-
(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.
(a) JP1/AJS3 - Manager version information
- In Windows:
-
Check the information in the following file:
JP1/AJS3-Manager-installation-folder\Version.txt
- In UNIX:
-
Execute /etc/hitachi_setup, and then check the information displayed for List Installed Software.
(b) Embedded database version information
Execute the following command, and then collect the displayed information:
ajsembdbidlist -v
(c) Embedded database configuration information
Execute the following command, and then collect the displayed information:
ajsembdbstatus -c
(d) Scheduler service configuration information
Execute the following command, and then collect the displayed information:
ajsembdbidlist
(e) Database area extension information
If you have extended the database area of the embedded DB by using the ajsembdbaddarea command, obtain the following folder or directory file.
- In Windows:
-
embedded-database-practical-folder\CONF\embrm
- In UNIX:
-
embedded-database-practical-directory/conf/embrm
(f) System definition of embedded database
If you have changed the operand of the system definition of the embedded DB, obtain the setting value. For an overview of the system definition, see 23.1.1 Examining the embedded-database operating environment and operating method in the JP1/Automatic Job Management System 3 Configuration Guide.
(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:
-
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
-
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
-
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.