Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Troubleshooting


2.7.8 Action to be taken if an embedded database operation command error is detected

This subsection describes the action to be taken if an embedded database operation command error is detected.

Organization of this subsection

(1) Action to be taken if an error occurs during embedded database maintenance

The following table describes the causes of errors that might occur during embedded database maintenance when the jajs_setup or jajs_setup_cluster command is executed, and the actions to be taken.

Table 2‒10: Causes of errors that might occur during embedded database maintenance and actions to be taken

Return value

Error cause

Action to be taken

1

An option was specified incorrectly.

Specify the correct option, and re-execute the command.

2

Creation of a temporary directory failed.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

3

The setup identifier specified in the -id option is invalid.

Specify the correct setup identifier, and re-execute the command.

4

The embedded database corresponding to the setup identifier specified in the -id option is already installed.

Specify the setup identifier of an embedded database that is not installed, and re-execute the command.

5

There is no available setup identifier that JP1/AJS3 can allocate.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

6

Acquisition of the embedded-database port number failed.

7

The port number specified in the -p option is invalid.

Specify the correct port number, and re-execute the command.

8

An unexpected error occurred.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

9

The port number specified in the -p option is already being used.

Specify a port number that is not being used, and re-execute the command.

10

There is no available port number that JP1/AJS3 can allocate.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

11

There is no available table prefix that JP1/AJS3 can allocate.

12

The specified embedded database configuration file was incorrectly edited by a user or is damaged.

Specify the correct embedded DB configuration file, and execute a command again.

24

The user who performed installation doesn't have administrator privileges.

A user who has administrator privileges must re-execute the command.

(2) Action to be taken if an error occurs during installation of the embedded database

The following table describes the causes of errors that might occur during installation of the embedded database and the actions to be taken.

Table 2‒11: Causes of errors that might occur during installation of the embedded database and actions to be taken

Return value

Error cause

Action to be taken

-66

Because the embedded DB file is being used by some process (such as Event Viewer, a virus scan program, or backup software), certain files cannot be updated.

Restart the OS, and then re-execute the command while the following processes are not running:

  • Event Viewer

  • Virus scan programs

  • Backup software

1

An option was specified incorrectly.

Specify the correct option, and re-execute the command.

2

Creation of a temporary directory failed.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

3

The host name specified in the -mh option is invalid.

Specify the correct host name, and re-execute the command.

4

The setup identifier specified in the -id option is invalid.

Specify the correct setup identifier, and re-execute the command.

5

The embedded database corresponding to the setup identifier specified in the -id option is already installed.

Specify the setup identifier of an embedded database that is not installed, and re-execute the command.

6

The installation execution log of the embedded database was not found.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

7

There is no installation image of the embedded database, or you do not have permission for the path specified in the -s option.

Either store an installation image of the embedded database in the directory pointed to by the path specified in the -s option, or change the permission for the specified path, and then re-execute the command. If you are performing the operation as an AJS administrator, make sure that the AJS administrators have the appropriate permission for the specified path.

8

Registration of the configuration definition failed.

Check the execution permissions for the command, and re-execute the command.

9

The combination of the setup identifier of the embedded database to be installed and the installation directory is invalid.

When you specify the setup identifier of an embedded database that is already installed, specify the installation directory that corresponds to the setup identifier, and then re-execute the command. When you specify the setup identifier of an embedded database that is not installed, specify the installation directory of an embedded database that is not installed, and then re-execute the command.

12

Some of the files to be copied during installation are missing.

The probable causes are as follows:

  • Because multiple ajsembdbinstl commands were executed simultaneously for the same setup identifier, the files to be copied during installation are in the invalid status.

    Re-execute the ajsembdbinstl command.

  • For any other case:

    Save the directories under the JP1/AJS3 installation directory, and then contact the system administrator.

24

The user who attempted installation doesn't have administrator privileges.

A user who has administrator privileges must re-execute the command.

61

Files required for installation are missing.

Store the installation image of the embedded database in the directory specified in the -s option, and then re-execute the command.

63

An error occurred during registration in the OS.

See the Release Notes, and make sure that all required OS patches and packages have been installed.

Also check whether the installation directory specified in the -i option meets the following conditions:

  • The installation directory name consists of the following characters:

    In Windows:

    - Alphanumeric characters

    - Space character

    - The path separator \

    - Period (.)

    - Underscore (_)

    - Left parenthesis (()

    - Right parenthesis ())

    In UNIX:

    - Alphanumeric characters

    - Underscore (_)

    - Slash (/)

  • The length of the path for the installation directory is 118 bytes or less.

Make sure that the above conditions are satisfied, and then re-execute the command. If this error reoccurs, back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

65

A disk access error occurred.

Make sure that the disk on which the embedded database is to be installed has sufficient free space, and then re-execute the command. If the error occurs again even when the disk has sufficient free space, back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

66

There is not enough free space on the installation disk for the embedded database.

Make sure that the installation disk for the embedded database has sufficient free space, and then re-execute the command.

68

A startup option (parameter) is invalid.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

72

The user who attempted installation does not have the superuser privilege.

A user who has the superuser privilege must re-execute the command.

78

The OS is not a supported OS for JP1/AJS3.

Check whether the OS is supported for JP1/AJS3. If the OS is supported, back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

80

In Windows:

The status of the embedded database service with the specified setup identifier is not the stopped status.

In UNIX:

The embedded database specified for the installation directory is currently running.

Stop the embedded database, and re-execute the command.

82

In Windows:

An embedded database that has the same setup identifier is already installed.

In UNIX:

A database other than the embedded database is already installed in the installation directory.

Check the specified installation directory, and if necessary, change it.

83

An error occurred during registration in the exception list of the Windows firewall.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

85

The contents of the patch information file are invalid.

86

Deletion of the patch information failed.

87

Deletion of the patch information failed. You need to restart the OS.

88

The pdservice.exe process is being executed.

89

The display name for the embedded database service duplicates an existing name.

90

The display name for the node switching service duplicates an existing name.

91

The source name for the Windows event log duplicates an existing name.

92

An abnormal condition occurred during registration of the display name for the embedded database service.

93

An abnormal condition occurred during registration of the display name for the node switching service.

94

An abnormal condition occurred during registration of the source name for the Windows event log.

95

The status of the embedded database is not the stopped status.

Stop the embedded database, and then re-execute the command.

96

The file to be used to install the version upgrade is being used.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

60

An error other than above occurred.

(3) Action to be taken if an error occurs during uninstallation of the embedded database

The following table describes the causes of errors that might occur during uninstallation of the embedded database and the actions to be taken.

Table 2‒12: Causes of errors that might occur during uninstallation of the embedded database and actions to be taken

Return value

Error cause

Action to be taken

1

An option was specified incorrectly.

Specify the correct option, and re-execute the command.

2

Creation of a temporary directory failed.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

3

JP1_DEFAULT cannot be specified in the -mh option.

Specify a correct host name, and re-execute the command.

4

The host name specified in the -mh option is invalid.

5

There is no installation information directory for the embedded database.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

6

There is no uninstallation information directory for the embedded database.

7

The name of the installation directory for the embedded database cannot be resolved.

8

An unexpected error occurred.

9

Output of the environment creation information file for the embedded database failed.

10

The unsetup operation for the embedded database failed.

Take action based on the error message output before this message, and then re-execute the command.

11

Deletion of the configuration definition failed.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

24

The user who attempted uninstallation doesn't have administrator privileges.

A user has administrator privileges must re-execute the command.

63

An error occurred during cancellation of registration in the OS.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

65

A disk access error occurred.

72

The user who attempted uninstallation does not have the superuser privilege.

A user who has the superuser privilege must re-execute the command.

81

In Windows:

The embedded database that has the specified setup identifier is not installed.

In UNIX:

The embedded database is not installed in the installation directory.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

88

Some files cannot be deleted because an executing embedded-database process remains.

Restart the OS, and then re-execute the command.

60

An error other than above occurred.

Back up the directories under the JP1/AJS3 installation directory, and contact the system administrator.

(4) Action to be taken if an error occurs during embedded database setup

The following table describes the causes of errors that might occur during embedded database setup and the actions to be taken. If an identifier other than "_JF0" is used as the embedded database identifier, replace the "_JF0" portion in command names or folder paths with the embedded database identifier that is used.

Table 2‒13: Causes of errors that might occur during embedded database setup and actions to be taken

Code

Message ID

Error cause

Action to be taken

7

KFPX29607

There are no files.

Back up the following information, and contact the system administrator:

In Windows:
  • Folders and files under JP1/AJS3-installation-folder\embdb\_JF0

  • Files under JP1/AJS3-installation-folder#\log\embdb

In UNIX:
  • Directories and files under /opt/jp1ajs2/embdb/_JF0

  • Files under /var/opt/jp1ajs2/log/embdb

8

KFPX29608

An attempt to open a file failed.

9

KFPX29609

An attempt to read a file failed.

10

KFPX29610

Generation of a file failed.

11

KFPX29611

Creation of a directory failed.

12

KFPX29612

The table and system areas are insufficient.

Make sure that the disk has sufficient free space.

13

KFPX29613

The table and system areas are insufficient.

14

KFPX29614

The table and system areas are insufficient.

15

KFPX29615

The table and system areas are insufficient.

16

KFPX29616

An error occurred during creation of the table and system areas.

If the maximum file size is set to 2 gigabytes or less in the OS file system settings, change it to a value greater than 2 gigabytes or to unlimited.

17

KFPX29617

An error occurred during initialization of the system area.

Back up the following information, and contact the system administrator:

In Windows:
  • Folders and files under JP1/AJS3-installation-folder\embdb\_JF0

  • Files under JP1/AJS3-installation-folder#\log\embdb

In UNIX:
  • Directories and files under /opt/jp1ajs2/embdb/_JF0

  • Files under /var/opt/jp1ajs2/log/embdb

18

KFPX29618

An error occurred during startup of the embedded database or initialization of the table area.

  • Make sure that the name of the host on which the embedded database is built can be resolved, and that communication is possible with the resulting IP address.

  • The system resources required by the embedded database are insufficient. See 3.2.5 Estimating the values for kernel parameters in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide, and check the required resources.

19

KFPX29619

An internal error occurred in the embedded database.

Back up the following information, and contact the system administrator:

In Windows:
  • Folders and files under JP1/AJS3-installation-folder\embdb\_JF0

  • Files under JP1/AJS3-installation-folder#\log\embdb

In UNIX:
  • Directories and files under /opt/jp1ajs2/embdb/_JF0

  • Files under /var/opt/jp1ajs2/log/embdb

20

KFPX29620

An error occurred during the creation of a temporary file.

23

KFPX29623

An internal error occurred in the embedded database.

24

KFPX29624

KFPS00031

The embedded database environment has already been created.

Uninstall JP1/AJS3 and then re-install JP1/AJS3.

25

KFPX29625

Memory is insufficient.

Secure sufficient memory.

26

KFPX29626

An internal error occurred in the embedded database.

Back up the following information, and contact the system administrator:

In Windows:
  • Folders and files under JP1/AJS3-installation-folder\embdb\_JF0

  • Files under JP1/AJS3-installation-folder#\log\embdb

In UNIX:
  • Directories and files under /opt/jp1ajs2/embdb/_JF0

  • Files under /var/opt/jp1ajs2/log/embdb

27

KFPX29627

An internal error occurred in the embedded database.

#

One of the following folders will be used:

  • If the installation destination folder is the default folder or a folder under a folder protected by the system

    %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2

    The default for %ALLUSERSPROFILE% is system-drive\ProgramData.

    A "folder protected by the system" refers to the following paths:

    - Paths under system-drive\Windows

    - Paths under system-drive\Program Files

    - Paths under system-drive\Program Files (x86) (for 64-bit Windows)

  • If the installation target folder is none of the above

    JP1/AJS3 - Manager-installation-folder