COMSOL 6.2 - Managed Search Index Servers

Managed Search Index Servers

A managed search index server is a server instance of the Apache Solr™ enterprise search platform controlled by the Model Manager server itself. The page, opened by clicking in the navigation sidebar, shows a table with the configurations of all such managed search index servers. A single configuration — — is initially shown in the table. This default managed search index server is automatically created by the Model Manager server when the latter is started for the first time — see The Default Managed Database.


	Links to the Managed Search Index Servers page are hidden in the web interface if you cleared the Managed Apache Solr™ check box in the Products step of the Model Manager server installation.

Click on the label of a managed search index server in the table to show more details for that managed server. Click the button to add a new managed search index server.

Adding Managed Search Index Servers

You can add a new managed search index server to the Model Manager server. This is useful if you, for example, want to use different options than the default ones for the automatically added managed search index server but at the same time want to keep it around as a reference.

To add a new managed search index server:

Write a label for the managed search index server in the field.

Write the path on the file system where the data directory for the managed search index server will be created in the field.

The data directory must be located on a physical disk. Placing the directory on a network disk is not supported.

Select when and how the managed search index server is started in the list. Select if the server should start when the Model Manager server is started or when the search index server is used by a Model Manager database. Select if the server must be manually started on The Managed Search Index Server Page.

Click to add the new configuration. The data directory will be automatically created as needed the next time the managed search index server is started.


	The specified data directory must be empty if you want to create a new managed search index server. A nonempty data directory is assumed to belong to an existing managed search index server that you want to add a configuration for in the Model Manager server.


	The parent directory to the data directory must already exist on the file system for the server to automatically start after saving. If not, you can create the directory from The Managed Search Index Server Page and then manually start the server.


	Placing the data directory of a managed search index server on a network file system is not supported — see also Installation Planning.


	At least two search indexes need to be added to the managed search index server in order to use it for a Model Manager server database — see Search Indexes.


	Unlike Managed SQL Database Servers and Managed Resources Directories, a managed search index server requires no backup.

The Managed Search Index Server Page

The page contains details on the configuration of a managed search index server added to the Model Manager server — see Adding Managed Search Index Servers. The configuration fields are:

•

. The search platform used for the managed search index server.

•

. The label of the managed search index server. Used for display purposes in the Model Manager server web interface.

•

. The file system path to the data directory of the managed search index server.

The currently available disk space on the file storage containing the data directory is shown below the path.

You can see the current status of the data directory in its field. If the data directory does not exist on the file system, click the button to create it.

•

. The start mode of the managed search index server — if the server starts when the Model Manager server is started or when the search index server is used by a Model Manager database, if the server must be manually started.

The adjacent field shows, for example, if the server is currently started or if the server has failed to start due to some configuration issue. For the latter case, read the nested error information to look for hints to the underlying cause.

Click the button to stop a running managed search index server. Click to start it.

To edit the configuration for a managed search index server, proceed as follows:

Deactivate all Model Manager server databases using Search Indexes in the managed search index server. See also The Database Configuration Page.

Click the button to stop the managed search index server.

Click the button.

Enter the new configuration settings. If you change any directory paths, manually move the corresponding directories on the file system via, for example, a system file explorer before saving.

Click the button.

Start the managed search index server if not automatically started.

Activate all databases deactivated in the first step.

Deleting a Managed Search Index Server Configuration

Click the button to permanently delete the configuration.


	Clicking Delete Permanently will only delete the configuration for the managed search index server; it will not delete its data directory. You can add an existing search index server again by adding a new configuration that points to its data directory.

Search Indexes

The search data used by the Model Manager search functionality is populated in search indexes in the managed search index server. A Model Manager server database requires two search indexes. The search indexes are stored inside the data directory for the managed search index server.

The section shows a table with all search indexes in the search index server. The table columns are:

•

The column — the name of the search index.

•

The column — the Model Manager database using the search index, if any.

•

The permanently delete column — click the delete button to permanently delete the search index.


	A permanently deleted search index can be recreated by first adding back an empty search index. The empty search index is then automatically populated with search data when the Model Manager server database using the search index is activated.

To add a new search index, write the name of the search index and click the button under the section on the page. The name may only contain the letters a–z and digits 0–9 and must start with a letter. Suggested names are assets and items — the same names used by The Default Managed Database.


	The search index server must be running in order to add new search indexes.

Unlike the data directories of Managed SQL Database Servers and Managed Resources Directories, the data directory and its search indexes do not require backup because the contents can be recreated from that of the SQL database — see Restore of a Managed Search Index Server.

Restore of a Managed Search Index Server

A managed search index server is automatically restored if its data directory is missing when the server is started, although all of its search indexes are then empty. The search indexes will be automatically populated with search data when the Model Manager server database using the search indexes is activated.

You can also manually restore the data directory as follows:

Deactivate all Model Manager server databases using Search Indexes in the managed search index server. See The Database Configuration Page.

Stop the managed search index server.

Move any existing data directory to a new location.

Start the managed search index server.

At this point, the data directory and its search indexes will be recreated based on the configuration settings of the managed search index server. The search indexes will, however, be empty of search data.

Activate all databases deactivated in the first step.

At this point, the empty search indexes will be automatically repopulated with search data loaded from the corresponding SQL database as needed.


	Populating the search indexes after a restore may take some time depending on the size of the SQL database.