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.
-
Open the IDOL Content component configuration file in a text editor.
-
In the
[Server]
section, add theRegenerateIndex
configuration parameter for the index that you want to regenerate, and set it toTrue
. The following parameters regenerate the indexes that correspond to some of the validation steps.-
RegenerateNumericIndex
-
RegenerateRefIndex
-
RegenerateSecIndex
-
RegenerateUnstemmedIndex
For more information about these parameters, refer to the IDOL Content component Reference.
NOTE: If validation fails for the
nodetable
ordiskindex
stages, you must reindex your content to repair the index. -
-
Save and close the configuration file.
-
Restart the IDOL Content component for your changes to take effect.
-
In the configuration file, delete the
RegenerateIndex
parameter, or set it toFalse
. This step ensures that Content does not waste time regenerating the index again when you next restart.
On startup, Content regenerates the specified index.
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:
NOTE: The |
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
-
In the Service Control tab in the Console page, click Regenerate.
The Regenerate dialog box opens.
-
In the Type list, select the type of subindex that you want to regenerate.
-
In the Priority list, select the priority for the action, which determines how the action is queued.
- Click Regenerate.