IDOL Server 24.2

# Repair an Index After Validation Fails

You can regenerate a data index if the validation step fails. There are three ways to regenerate an index:

- Use the `RegenerateIndex` configuration parameters and restart the server.
- Use the DREREGENERATE index action while the server is running.
- Use the IDOL Admin interface. This option provides a user interface for the `DREREGENERATE` index action.

All these methods recreate all the files for a particular data index without reindexing all your content.

NOTE: You can also use these methods to regenerate an index after you make a field configuration change. However, you cannot use the RegenerateRefIndex or DREREGENERATE `RefIndex` option to change the configuration for ReferenceType fields.

## Regenerate with a Server Restart

The `RegenerateIndex` configuration parameters allow you to recreate the data indexes.

To regenerate an index by using the Regenerate configuration parameters

1. Open the IDOL Content component configuration file in a text editor.

2. In the `[Server]` section, add the `RegenerateIndex` configuration parameter for the index that you want to regenerate, and set it to `True`. The following parameters regenerate the indexes that correspond to some of the validation steps.

   - RegenerateNumericIndex

   - RegenerateRefIndex

   - RegenerateSecIndex

   - RegenerateUnstemmedIndex

   NOTE: If validation fails for the `nodetable` or `diskindex` stages, you must reindex your content to repair the index.

3. Save and close the configuration file.

4. Restart the IDOL Content component for your changes to take effect.

On startup, Content regenerates the specified index.

5. In the configuration file, delete the `RegenerateIndex` parameter, or set it to `False`. This step ensures that Content does not waste time regenerating the index again when you next restart.

## Regenerate with an Index Action

The DREREGENERATE action allows you to recreate the data indexes while the server is running. Use this method if you need the IDOL Content component to be accessible while you regenerate.

NOTE: You cannot regenerate the unstemmed index by using `DREREGENERATE`. In this case, you must use the `RegenerateUnstemmedIndex` configuration parameter.

To regenerate the data index immediately, send a `DREREGENERATE` index action (case sensitive) from your Web browser:

    http://ContentHost:indexPort/DREREGENERATE?&Type=type

where:

`ContentHost` | is the IP address or host name of the machine on which the IDOL Content component is installed.
`indexPort` | is the IDOL Content component index port (specified as IndexPort in the `[Server]` section of the IDOL Content component configuration file).
`type` | is the type of subindex that you want to regenerate. You can specify multiple indexes in a comma-separated list. The following values are available for repairing a validation failure: `Numeric` `RefIndex` `SecIndex` NOTE: The DREREGENERATE index action also has options that allow you to regenerate field indexes to update the field configuration. See Update Field Configuration.

For example:

    http://12.3.4.56:20001/DREREGENERATE?&Type=Numeric,RefIndex

This index action uses port `20001` to regenerate the NumericType and ReferenceType field indexes of an IDOL Content component that is located on a machine with the IP address `12.3.4.56`.

## Regenerate with IDOL Admin

You can also regenerate the data index by using the Regenerate function in the Service Control tab in the Console page of the IDOL Admin interface.

To regenerate the data index by using IDOL Admin

1. In the Service Control tab in the Console page, click Regenerate.

   The Regenerate dialog box opens.

2. In the Type list, select the type of subindex that you want to regenerate.

3. In the Priority list, select the priority for the action, which determines how the action is queued.

4. Click Regenerate.

Copyright 2024 Open Text
Version 24.2 | Last updated March 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Server 24.2

Topic Title: Repair an Index After Validation Fails