9.20 npupdatesearchdata command (update search data)
Description
This command applies to search data the contents of Operational Contents at the time of the command's execution. Use this command in an environment in which the Search tab is displayed in the Operational Content Execution Window.
This command is used in the following cases:
-
New Operational Contents have been published.
-
Published Versions of Operational Contents have been edited.
-
Published Versions of Operational Contents have been deleted or made private.
-
Operational Contents have been updated by the npimport or nppubimport command.
If you have set this command to be executed automatically in the service property file (ucnp_service.ini), there is no need to execute it manually. We recommend that you execute the npupdatesearchdata command after you have executed the npimport and nppubimport commands because a large number of Operational Contents can be expected to have been updated.
Navigation Platform must be running when this command is executed.
Note that this command cannot be executed while the npstop command (stop) is executing. This command can be executed while search processing in Navigation Platform is underway.
Format
npupdatesearchdataΔ[-r]
Options
- -r
-
Reorganizes the search database after search data has been updated.
- Tip
-
You need to reorganize the search database periodically. We recommend that you add this command as a Windows task, and our guideline is that you execute the command once a day. Because it might take time to reorganize the search database, we recommend that you execute this command when traffic to Navigation Platform is light.
If you have set the search data to be updated automatically, a command lock error might occur depending on the timing of automatic updating and the timing of reorganization processing set in the Windows task. If reorganization processing has not been performed, perform reorganization processing again.
Trace files
When this command is executed, the following trace files are output:
- Output directory
-
Navigation-Platform-installation-directory\logs
- File name
-
ucnp_search_traceN.log (N: number of files)
- Size
-
Size specified in the ucnp.base.server.trace.size property in the user property file (ucnp_user.properties)
- Number of files
-
Value specified in the ucnp.base.server.trace.backup.number property in the user property file (ucnp_user.properties)
- Contents
-
-
Messages issued by commands
-
Information about the start and end of processing
-
Error information for errors that have occurred
If an error occurs before the trace is initialized, the error is output to the standard error output, in which case no trace is output.
-
Notes
-
Do not execute this command while the npimport command (import Operational Contents) or the nppubimport command (import Published Versions of Operational Contents) is executing. If this command is executed in such a case, consistency might be lost between the Operational Contents and the search data. If this has occurred, execute this command again after the import command has terminated.
-
If an Operational Content containing search data subject to update processing is deleted or made private while this command is executing, a message indicating that the search data for the corresponding Operational Content could not be updated might be displayed. If this happens, execute this command again after the Operational Content has been updated.
-
If there are many search data items to be updated, execution of this command might take several minutes.
Return value
Return value |
Description |
---|---|
0 |
The command terminated normally. |
1 |
The command terminated abnormally. |
2 |
A lock error occurred on the command. |
9 |
A command execution permission error occurred. |
Example
This example updates search data:
> Navigation-Platform-installation-directory\bin\npupdatesearchdata