Installing or uninstalling a search service for full-text search
To use the Web Portal or full-text search in the Manager, you need an application server with a search service installed on it. You usually set up the machine roles for search indexing for full-text search when you install an application server.
If necessary, you can install the machine roles at a later date. If necessary you can uninstall the machine roles again. Customize the application server installation.
To install the search server on an application server at a later date
-
Launch autorun.exe from the root directory of the One Identity Manager installation medium.
-
On the installation wizard's home page, perform the following actions:
-
Click Installation.
-
In the Web-based components pane, click Install.
Starts the Web Installer.
-
On the Web Installer home page, click Modify application server installation and click Next.
-
On the Installation source page, select the application server instance that you want to customize.
-
On the Database connection page, select the database connection and authentication method.
-
On the Assign machine roles page, enable the Search Service and Search Indexing Service machine roles.
-
Installation progress is displayed on the Setup is running page. After installation is complete, click Next.
-
Click Finish on the last page to end the program.
-
Close the autorun program.
To uninstall the search server on an application server
-
Launch autorun.exe from the root directory of the One Identity Manager installation medium.
-
On the installation wizard's home page, perform the following actions:
-
Click Installation.
-
In the Web-based components pane, click Install.
Starts the Web Installer.
-
On the Web Installer home page, click Modify application server installation and click Next.
-
On the Installation source page, select the application server instance that you want to customize.
-
On the Database connection page, select the database connection and authentication method.
-
On the Assign machine roles page, disable the Search Service and Search Indexing Service machine roles.
-
Installation progress is displayed on the Setup is running page. After installation is complete, click Next.
-
Click Finish on the last page to end the program.
-
Close the autorun program.
Updating the search index on application servers
The searched index is updated when changes are made to a table with indexed columns, to referenced tables or translations.
The Common | Indexing | Interval configuration parameter contains the interval between two indexing runs. The default value is 120 seconds. Once this time interval has elapsed, a new indexing run is started.
You can also update the search index manually.
To manually update the search index on the application server:
-
Open the status page for the application server in the browser.
-
In the menu for the currently logged-in user, click Update Index.
-
Select one of the following options:
-
All values: Updates all indexes.
-
Only changed values: Only updates changed indexes.
-
Optimize index: Optimizes the search index.
Updating application servers
NOTE: We recommend that you perform the automatic update only in specific maintenance windows, in which the application cannot be accessed by users and the application can be manually restarted with no risk.
The following permissions are required for automatic updating:
-
The user account for updating requires write permissions for the application directory.
-
The user account for updating requires the local security policy Log on as a batch job.
-
The user account running the application pool requires the Replace a process level token and Adjust memory quotas for a process local security policies.
To run an update, first load the files to be updated into the One Identity Manager database. The necessary files are loaded into the One Identity Manager database and updated when a hotfix, a service pack, or a full version update is run.
The test depends on the selected mode for automatic update. New files are loaded from the database as they are identified. The files cannot be updated while the application is running. The update waits until the application is restarted.
The application is restarted automatically by the web server when it has been idle for a defined length of time. However, this may take some time or be hindered by continuous user requests.
Configure the automatic update in the application server's appsettings.json configuration file. You can use the AutoUpdate configuration settings to control the update behavior.
Table 27: Configuration settings for automatic update
|
Off |
Specifies whether automatic update is disabled (true) or enabled (false). |
|
Mode |
Mode for automatic update. Permitted values are:
-
timer: Scheduled checking. At application start up, a check for updated files in the database is carried out and afterward, at scheduled intervals (checkinterval setting).
-
manual: Manual checking. You start the check from the application server's status page. Regular checking if updated files in the database does not take place.
Default value: timer |
|
CheckInterval |
Time period for search for update in timer mode.
Default value: 5 minutes |
|
InactivityTime |
Time period without user activity so that the update can be started.
Default value: 10 seconds |
Example: Entry for automatic updating of an application server in the appsettings.json configuration file
"AutoUpdate": {
// "Off": true,
"Mode": "timer", // Valid options: timer, manual
"CheckInterval": "00:05:00",
"InactivityTime": "00:00:10"
}
To start the update manually
-
Open the status page for the application server in the browser.
-
In the menu for the currently logged on user, click Update immediately.
Uninstalling application servers
Perform the following steps to uninstall the web application.
To uninstall a web application
-
Launch autorun.exe from the root directory of the One Identity Manager installation medium.
-
On the start page of the installation wizard:
-
Change to the Installation tab.
-
In the Web-based components pane, click Install.
This starts the Web Installer.
-
On the Web Installer start page, click Uninstall a web application and click Next.
-
On the Uninstall a web application page, double-click the application that you want to remove.
The 
icon is displayed in front of the application.
-
Click Next.
-
On the Database connection page, select the database connection and authentication method and enter the corresponding login data.
-
Click Next.
-
Confirm the security prompt with Yes.
-
The uninstall progress is displayed on the Setup is running page.
-
Once installation is complete, click Next.
-
On the Wizard complete page, click Finish.
-
Close the autorun program.
