2.2.3 Backing up the JP1/AJS3 - Manager setup information
If you back up JP1/AJS3 - Manager, you must also back up JP1/Base at the same time.
The following lists the tasks required to back up the JP1/AJS3 - Manager setup information.
-
Backing up the files used in JP1/AJS3
-
Backing up the execution agent information
-
Backing up the execution environment definition for QUEUE jobs and submit jobs (only if QUEUE jobs and submit jobs are used)
-
Backing up the unit definition
The following describes how to perform these tasks.
- Organization of this subsection
(1) Backing up the files used in JP1/AJS3
Use any method to back up the files used in JP1/AJS3 - Manager either by physical host or by logical host.
The files you need to back up in Windows and UNIX are different. The following subsections describe the files that need to be backed up in each system.
(a) In Windows
The following table lists the JP1/AJS3 - Manager files you need to back up in Windows.
- #1
-
Substitute the following folder for JP1/AJS3-folder:
-
For a physical host: JP1/AJS3-Manager-installation-folder\conf
-
For a logical host: shared-folder\jp1ajs2\conf
-
- #2
-
This file exists only if the function is used.
- #3
-
If you use a definition file to execute the jpqimport command, back up the execution environment definition for QUEUE jobs and submit jobs described later, and then back up the file.
- #4
-
Substitute the following folder for JP1/AJS3-data-folder:
-
For a physical host
If the installation folder is the default installation folder or is in a folder protected by the system
%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2
If the installation folder is other than the above
JP1/AJS3-Manager-installation-folder
The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.
A folder protected by the system is a folder under any of the following:
- system-drive\Windows
- system-drive\Program Files
- system-drive\Program Files (x86)
For a logical host: shared-folder\jp1ajs2\conf
-
- #5
-
If you use the following files, back up the folder containing these files:
-
Common user profiles
-
Customize files (jajsDisableMenu) that disable menus in windows for JP1/AJS3 - View
-
Executable command settings files (jajsExecutableCommand)
-
- #6
-
For profile-storage-folder, substitute the value set for the WaitInfFileOutDir environment setting parameter of the [{JP1_DEFAULT|logical-host-name}\JP1AOMAGENT] definition key. For details about the WaitInfFileOutDir environment setting parameter, see 20.6.2(16) WaitInfFileOutDir (for agent processes) in the JP1/Automatic Job Management System 3 Configuration Guide.
The folder and files exist only if JP1/AJS3 - Manager has been set up for sending emails without using Outlook.
(b) In UNIX
The following table lists the JP1/AJS3 - Manager files you need to back up in UNIX.
- #1
-
Substitute the following directory for JP1/AJS3-folder:
-
For a physical host: /etc/opt/jp1ajs2/conf
-
For a logical host: shared-directory/jp1ajs2/conf
-
- #2
-
This file exists only if the function is used.
- #3
-
This is an environment settings file used for compatibility with the JP1/AJS2 - Manager instance that you backed up. This file is not used when the JP1/AJS3 - Manager to be recovered is in the standard configuration.
- #4
-
If you use the following files, back up the directory containing these files:
-
Common user profiles
-
Customize files (jajsDisableMenu) that disable menus in windows for JP1/AJS3 - View
-
Executable command settings files (jajsExecutableCommand)
-
- #5
-
If you use a definition file to execute the jpqimport command, back up the execution environment definition for QUEUE jobs and submit jobs described later, and then back up the file.
- #6
-
Back up the script as required.
(2) Backing up the execution agent information
The following describes how to back up the execution agent information.
Execute the following command to back up the definition information for an execution agent or an execution agent group to any execution agent definition file. Specify the -l option to back up the definition information of all execution agents or execution agent groups.
Definition information includes the execution agent name, execution host name, and the maximum number of concurrently executable jobs.
ajsagtprint [-h logical-host-name] {-a execution-agent-name | -g execution-agent-group-name | -l} > execution-agent-definition-file
- Cautionary note
-
Before starting the backup of execution agent information, make sure that the JP1/AJS3 service is running.
(3) Backing up the execution environment definition for QUEUE jobs and submit jobs
If a definition file has been used for the jpqimport command that creates the execution environment for QUEUE jobs and submit jobs, the definition in the file might be inconsistent with the actual environment. If the file and the environment are inconsistent, output the actual execution environment for QUEUE jobs and submit jobs, copy the definition to the jpqsetup.conf file, and then back up the file.
To back up the execution environment definition:
-
Execute the following command to output the definition of the execution environment for QUEUE jobs and submit jobs.
jpqexport -dt isam -co file-name -mh logical-host-name#
- #
-
For a physical host, do not specify -mh logical-host-name.
- Cautionary note
-
For centralized management, we recommend that you use jpqsetup.conf as the file to be set by the jpqimport command.
To back up the definition of a logical host, specify the logical host name in the -mh option.
-
Copy the contents of the output file to jpqsetup.conf.
The definition of the execution environment for QUEUE jobs and submit jobs is output to the file specified by file-name in step 1. Copy the contents of the output file to jpqsetup.conf.
(4) Backing up the unit definition
The following describes the tasks required to back up the definition information for a jobnet and calendar. Back up the information for each scheduler service.
- Cautionary note
-
For this backup procedure only, the unit for backup is by scheduler service rather than by logical host. Accordingly, back up the information for each scheduler service separately.
Before starting backup, make sure that the JP1/AJS3 service is running.
For details about how to back up the jobnet definition information, see 3. Backing Up and Restoring Jobnets.
(a) Backing up the definition information for units other than the root job group
Execute the following command to back up 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 back up the root job group information, use the procedures in (b) and (c) below.
-
In Windows:
C:\> ajsprint -F scheduler-service-name -a /* > unitbackup.txt
-
In UNIX:
# ajsprint -F scheduler-service-name -a '/*' > unitbackup.txt
To back up the definition of many units, consider splitting the unit definition by job group or jobnet. Execute the following command for each unit you want to back up.
ajsprint -F scheduler-service-name -a /unit-name > unit-name_backup.txt
- Cautionary note
-
When you use the ajsprint command to back up the definition information, specify no for the AJSPRINTNETSCHPRF environment setting parameter. For details about this parameter, see 20.4.2(79) AJSPRINTNETSCHPRF in the JP1/Automatic Job Management System 3 Configuration Guide.
(b) Backing up the information about the root job group
Record the following information about the root job group:
-
Comments
-
Owners
-
JP1 resource groups
-
Base time
-
Base day
-
Base month
(c) Backing up the calendar information for the root job group
Execute the following command to back up the calendar information (open days and close days) for the root job group.
ajsprint -F scheduler service-name -d / > rootcal.txt
- Cautionary note
-
If no calendar information is output to rootcal.txt, recovery is not needed.