16.16.13 Problems related to synonym dictionary files (when the multi-node function is being used)

(1) Steps to take when a problem occurs in relation to a synonym dictionary file when the multi-node function is being used

Take the following action when a problem occurs in relation to a synonym dictionary file when the multi-node function is being used.

Note

The synonym dictionary files used in a multi-node configuration are stored in the directory specified for the adb_syndict_node_storage_path operand in the server definition.

Action 1

When an error occurs in relation to a synonym dictionary file, the following messages are output to the message log file on the slave node where the error occurred:

• KFAA30959-E

• KFAA34008-E

• KFAA51537-W

Take the action as explained in the action to take section of the message. If taking the action explained in the action to take section of the message does not resolve the problem or you are unable to take the action the message suggests, try action 2.

Action 2

Delete the synonym dictionary file that caused the error. Then, execute the adbsyndict command to synchronize the synonym dictionary files. For details about how to synchronize the synonym dictionary files, see 16.24.5 Synchronizing synonym dictionary files.

To Page Top

(2) Steps to take when there is insufficient free space for the multi-node synonym dictionary storage directory

If the adbsyndict command terminates abnormally due to there being insufficient free space for the multi-node synonym dictionary storage directory, messages are output as follows:

• KFAA51519-E is output on the master node.

• KFAA51514-E is output on the node where the lack of free space occurred.

If the operation target information in the message KFAA51514-E is synonym-dictionary-file and the error number is 28 (ENOSPC), there might be insufficient free space for the storage directory for synonym dictionary files. In this case, first try Action 1. If you cannot perform Action 1 or there is still not enough free space after Action 1 is performed, perform Action 2.

Note

The multi-node synonym dictionary storage directory is the directory specified for the adb_syndict_node_storage_path operand in the server definition.

Action 1

If multiple synonym dictionaries are updated at once when the adbsyndict command is executed, try updating the synonym dictionaries one at a time. Because less free space is required when updating fewer synonym dictionaries, you might be able to execute the adbsyndict command successfully.

Action 2

Create the multi-node synonym dictionary storage directory again on another disk with more free space. The following shows the procedure.

Procedure:

1. Create another multi-node synonym dictionary storage directory on a disk with more free space. For details about how to create this directory, see (6) Creating the multi-node synonym dictionary storage directory in 16.24.1 Preparing for synonym search operations.

2. Perform a normal termination of the node where the lack of free space occurred. For details about how to terminate a node normally, see (2) Terminating an HADB server on a specific node in 16.4.2 Terminating HADB servers in the multi-node configuration.

3. After the node has terminated normally, change the value specified for the adb_syndict_node_storage_path operand in the server definition. Specify the directory you created in 1.

4. Start the node normally and return it to the multi-node configuration. For details about the procedure for returning a node to a multi-node configuration, see 16.15.3 Returning a node to the multi-node configuration.

5. Execute the adbsyndict command to synchronize the synonym dictionary files. For details about how to synchronize the synonym dictionary files, see 16.24.5 Synchronizing synonym dictionary files.

6. Delete the old multi-node synonym dictionary storage directory.

To Page Top