Maintenance mode
To carry out maintenance work, switch the web application to maintenance mode. You use maintenance mode, for example, to enable an update at a particular time.
No new sessions are permitted in maintenance mode. Current sessions are not affected. While maintenance work is being performed, users who view the web application are displayed the contents of the Maintenance.html file, which is located in the installation directory of the web application. You can edit this file to display details of the maintenance work for the user.
To switch the web application to maintenance mode
- Open the Runtime Monitor in the browser.
- On the Status tab, click Start maintenance mode.
To end maintenance mode
- Open the Runtime Monitor in the browser.
- On the Status tab, click End maintenance mode.
Maintenance mode can also be activated by creating the file App_Data\Maintenance.mode in the installation directory of the web application, and terminated by deleting this file.
Related topics
Using the performance indicators for monitoring
When you install a web application, performance counters are registered, which provide information about the state of the application.
Performance indicators can be installed later.
NOTE: Prerequisites for this are that the web application is installed on a Windows Server and has sufficient permissions to offer performance indicators. It may be necessary to add the application pool user account to the local group Performance monitoring user for this. Apart from this, the web application must be running in order to select the performance indicators.
To post-install performance indicators
- Open the Web Designer Configuration Editor.
- Click Web settings and Create Windows performance counters.
After this is successfully completed, an installation prompt is displayed.
- Confirm the prompt with OK.
To view performance counters
- Log in to the server on which the web application is installed.
- Start performance monitoring of Windows.
- In the dialog on the left-hand side, select Performance monitoring.
- In the performance monitoring view, click .
-
In the Add Counters dialog, under Available Counters, select One Identity ManagerWeb Portal and add to the entry.
This displays performance indicators for the web application. The following indicators are available.
Table 44: Performance indicators
AJAX calls |
Number of HTTP queries processed asynchronously. |
Objects |
Number of active database objects. |
Exceptions |
Number of exception errors that have occurred. |
Forms |
Number of active forms. |
HTML requests |
Number of HTML page requests. |
PID |
Number of process IDs. |
Contexts |
Number of active module objects. |
Sessions |
Number of active sessions. |
Sessions total |
Total number of sessions since the application started. |
-
Enter any new performance indicators you wish and select the web application under Instances of selected object:.
TIP: Only running web applications are displayed for selection. If you install a new web application, it may take a few minutes before the list of available web applications including the new one is available.
Installing and updating the Manager web application
Manager functionality can be provided by web applications. Before installation ensure that the minimal hardware and software prerequisites are fulfilled on the server.
Detailed information about this topic
Installing the Manager web application
One Identity Manager requires each web application to be defined in one language. If you wish to publish an application in two languages, you must install two separate applications. Web Installer installs one application per language by default.
You can define a language pool for these applications if several application are running at once. If a user calls up a web application from the language pool, he is automatically diverted to the web application which matches his language. It is, therefore, not important to declare all the web application URLs in the language pool.
This mechanism also allows you to achieve simple load balancing.
IMPORTANT: Start the Manager web application installation on the server.
To install the Manager web application
-
Launch autorun.exe from the root directory of the One Identity Manager installation medium.
-
Go to the Installation tab and select the Web based components item and click Install. Starts the Web Installer.
-
On the start page of the Web Installer, select Install Manager web application and click Next.
-
On the Database connection page, enter the connection credentials for the One Identity Manager database.
- Configure the following settings on the Select setup target page.
Table 45: Settings for the installation target
Application name |
Name used as application name, as in the title bar of the browser, for example. |
Target in IIS |
Internet Information Services web page on which to install the application. |
Enforce SSL |
Specifies whether insecure websites are available for installation. If the option is set, only sites secured by SSL can be used for installing. This setting is the default value. If this option is not set, insecure websites can be used for installing. |
URL |
The application's Uniform Resource Locator (URL). |
Install dedicated application pool |
Specifies whether an application pool is installed for each application. This allows applications to be set up independently of one another. If this option is set, each application is installed in its own application pool. |
Application pool |
The application pool to use. This can only be entered if the Install dedicated application pool option is not set.
If you use the DefaultAppPool default value, the application pool has the following syntax:
<application name>_POOL |
Identity |
Permissions for executing an application pool. You can use a default identity or a custom user account.
If you use the ApplicationPoolIdentity default value, the user account has the following syntax:
IIS APPPOOL\<application name>_POOL
You can authorize another user by clicking ... next to the box, enabling the Custom account option and entering the user and password. |
Web authentication |
Specifies the type for authentication against the web application. You have the following options:
- Windows authentication (single sign-on)
The user is authenticated against the Internet Information Services using their Windows user account and the web application logs in the employee assigned to the user account as role-based. If single sign-on is not possible, the user is diverted to a login page. You can only select this authentication method if Windows authentication is installed.
- Anonymous
Login is possible without Windows authentication. The user is authenticated against the Internet Information Services and the web application anonymously, and the web application is directed to a login page. |
Database authentication |
NOTE: You can only see this section if you have selected a SQL database connection on the Database connection page.
Specifies the type for authentication against the One Identity Manager database. You have the following options:
- Windows authentication
The web application is authenticated against the One Identity Manager database with the same Windows user account that your application pool uses. Login is possible with a user-defined user account or a default identity for the application pool.
- SQL authentication
Authentication is completed with a SQL Server login and password. The SQL Server login from the database connection is used. Use the [...] button to enter a different SQL login, for example, if the application is executed with a access level for end users. This access data is saved in the web application configuration as computer specific encrypted. |
-
Specify other application specific settings on the Configuration page.
-
Select the language of the application from the Language menu. The language influences how dates and numbers displayed amongst other things.
-
The web application requires access permissions to itself. If you selected the Windows authentication (single sign-on) authentication type as web authentication, enter the domain, user account, and password for the user. For anonymous web authentication, no further entries are required.
-
Specify the user account for automatic updating on the Set update credentials page. The user account is used to add or replace files in the application directory.
-
Use IIS credentials for update: Set this option to use the user account under which the application pool is executed for the updates.
-
Use other credentials for updates: To use a different user account, set this option. Specify the domain, the user name, and the user password.
-
Installation progress is displayed on the Setup is running page. Once installation is complete, click Next.
-
Click Finish on the last page to end the program.
NOTE: The Web Installer generates both the web application and the configuration file (web.config). The Web Installer uses default values for the configuration settings. You can keep these values. It is recommended you check the settings with the help of the Manager Web Configuration Editor. You will find the configuration file (web.config) in the web application directory in the Internet Information Services.
Related topics