Hitachi

Hitachi Advanced Database Messages


KFAA91581-E

An error occurred while the HADB Option was being installed. (reason = aa....aa, command = bb....bb, return code = cc....cc) (E)

An error occurred while the HADB Option was being installed.

aa....aa:

Cause of the error

bb....bb:

Name of the OS command resulting in an error

cc....cc:

Return code

S:

Terminates processing.

Action:

Take corrective action depending on the cause of the error that was output.

Display of aa....aa

Cause of the error

Corrective action

permission to write to the server directory was denied

An attempt to write to the server directory failed. Or no permissions have been granted.

The following describes the causes of the error and the corrective action to take.

  • The free space in the server directory is insufficient

    Check whether there is sufficient free space in the server directory. If there is not enough free space, allocate enough free space in the server directory.

  • The HADB administrator has not been granted write, read, or execution permissions for the server directory

    Check whether the HADB administrator has been granted write, read, and execution permissions for the server directory (including directories and files under the server directory). If the HADB administrator does not have the necessary permissions, grant the HADB administrator write, read, and execution permissions.

After performing the corrective action above, re-execute the adboptinstall command.

the server directory does not exist

The server directory does not exist.

The following describes the causes of the error and the corrective action to take.

  • The value of the specified environment variable ADBDIR is invalid.

    Check and, if necessary, revise the value of the specified environment variable ADBDIR. If the specified value of the environment variable ADBDIR is invalid, specify the correct value for the environment variable ADBDIR.

  • The server directory does not exist in the path specified in the environment variable ADBDIR

    Check whether the server directory exists in the path specified in the environment variable ADBDIR. If the server directory does not exist in the path specified in the environment variable ADBDIR, specify the correct path in the environment variable ADBDIR.

  • Incorrect configuration in the server directory or the server directory is corrupt

    If this message appears even though the server directory exists in the path specified in the environment variable ADBDIR, the server directory may be corrupt. In this case, back up the server directory and then recreate the server directory using the adbinstall command.

After performing the corrective action above, re-execute the adboptinstall command.

permission to write to the install data storage directory was denied

An attempt to write to the directory used for installation failed. Or no permissions have been granted.

The following describes the causes of the error and the corrective action to take.

  • The free space in the directory used for installation is insufficient

    Check that there is enough free space in the directory used for installation. If there is not enough space, make sure there is enough free space in the directory used for installation.

  • The HADB administrator has not been granted write, read, or execution permissions for the directory used for installation

    Check whether the HADB administrator has been granted write, read, and execution permissions for the directory used for installation (including directories and files under the directory used for installation). If the HADB administrator does not have the necessary permissions, grant the HADB administrator write, read, and execution permissions.

After performing the corrective action above, re-execute the adboptinstall command.

extraction of the install file failed

Failed to expand the tar.gz format file required for installation.

The following describes the causes of the error and the corrective action to take.

  • The HADB administrator has not been granted read permission for the tar.gz file under the directory used for installation.

    Check if the HADB administrator has been granted read permission for the tar.gz file under the directory used for installation. read If the HADB administrator not have the read permission, grant the HADB administrator the read permission.

  • The hash value of the tar.gz format file under the directory user for installation does not match the hash value file

    Check the hash value of the tar.gz format file under the directory user for installation. If the hash value is different from the hash value file of the cloud storage facility (adbhashfile_s3option_sha256.txt for AWS environment or Amazon S3-compatible object storage environment, adbhashfile_azoption_sha256.txt for Azure environment), re-copy the installation data in the installation CD-ROM.

After performing the corrective action above, re-execute the adboptinstall command.

the install file does not exist

The directory used for installation does not contain the tar.gz format file that is required for installation. Or, the file name in tar.gz format is incorrect.

The following describes the causes of the error and the corrective action to take.

  • The tar.gz format file required for installation is not stored in the directory used for installation.

    Copy the tar.gz file from the installation CD-ROM to the directory used for installation.

  • The tar.gz file name in the directory used for installation does not match the tar.gz file name on the installation CD-ROM.

    Copy the tar.gz file from the installation CD-ROM to the directory used for installation.

    If you have manually renamed the tar.gz file on the installation CD-ROM after copying it to the directory used for installation, copy the tar.gz file from the installation CD-ROM again.

After performing the corrective action above, re-execute the adboptinstall command.

the HADB server version is invalid

The version of the HADB server is invalid.

The following describes the causes of the error and the corrective action to take.

  • The version of the HADB server installed does not support the HADB option.

    Install the version of the HADB server that supports the HADB Option. For details, see HADB Server Version Upgrade in the HADB Setup and Operation Guide.

After performing the corrective action above, re-execute the adboptinstall command.

an error occurred during execution of a command

An error occurred during the execution of the adboptinstall command.

This message is output when an error occurs in a HADB command executed as an extension of the adboptinstall command.

Check the OS or HADB error message output immediately before this message.

The main causes when an OS error message is output are described below.

  • The prerequisite packages for the HADB server are not installed.

  • The server directory is incorrect or corrupted.

The main causes when an HADB error message is output are described below.

  • The value set for the environment variable LANG is incorrect.

Check the return code output in this message and take appropriate action.

  • If the return code is 8

    This return code is output when the value set for the environment variable LANG is incorrect. Check the value set for the environment variable LANG. In addition, verify whether the locales supported by the HADB server (prerequisite packages glibc-langpack-ja or glibc-langpack-en) are installed. If the prerequisite packages are not installed, install them. For details on how to check installed packages, see Checking prerequisite packages in Tasks that must be performed before HADB server installation in the HADB Setup and Operation Guide.

  • If the return code is 126

    This return code is output when the adbls command cannot be executed. Check the OS message output immediately before this message. If a message indicating "Permission denied" is displayed, the server directory may be corrupted. In this case, after backing up the server directory, re-execute the adbinstall command to perform the HADB server installation.

  • If the return code is 127

    Verify whether the prerequisite packages for the HADB server are installed. If the prerequisite packages are not installed, install them. For details on how to check installed packages, see Checking prerequisite packages in Tasks that must be performed before HADB server installation in the HADB Setup and Operation Guide.

    In addition, if the server directory is corrupted, back up the server directory and then re-execute the adbinstall command to perform the HADB server installation.

  • If the return code is other than the above

    Check the OS message output immediately before this message.

After performing the above corrective actions, re-execute the adboptinstall command.