Identity Manager 8.0 - Installation Guide

About this Guide One Identity Manager Overview Installation Prerequisites Installing the One Identity Manager Installing and Configuring the One Identity Manager Service Updating the One Identity Manager Installing and Updating a One Identity Manager Application Server Installing, Configuring and Maintaining the Web Portal Installing the Operations Support Web Portal Installing and Updating the Manager Web Application Logging into One Identity Manager Tools Troubleshooting Appendix: One Identity Manager Authentication Modules Appendix: Creating a One Identity Manager Database for a Test or Development Environment from a Database Backup Appendix: Manager Web Application Extended Configuration Appendix: Machine Roles and Installation Packages Appendix: Settings for a New SQL Server Database

Compiling the Web Portal from the Command Line

Compiling the Web Portal from the Command Line

An alternative to compiling the Web Portal in the Web Designer is to compile it from the command line using VI.WebDesigner.CompilerCmd.exe.

Table 47: Program parameters
Parameters Description
Mandatory parameter /conn {string} The database connection string sequence.
/dialog {string} The dialog authentication string sequence.
/project {name} The name of the web project.
Optional parameter /solution {path} The Web Designer solution file to use. If not given, a database project is used.
/mode {mode}

Runs in one of the given modes.

normal = full complication (default)

nostore = assemblies not saved to the database

nocompile = C# codegen executes but without compiling

nocodegen = only compiles Web Designer, no C# codegen

-E

Enables enhanced checking.

For more information about enhanced checking, see the chapter "Global Settings" in the One Identity Manager Web Designer Reference Guide.

-D Enables debug.
-R

Enables generation of stable C# text.

This setting prevents use of certain random values.

/csharpout {folder}

Target directory for C# text.

/help Displays the help text.
Example based on release compilation of the VI_StandardWeb

VI.WebDesigner.CompilerCmd.exe /conn "Data Source=mydbserver.lan;Initial Catalog=Q1IM; User ID=sa; Password=secret" /dialog "Module=DialogUser;User=cccAdmin;Password=strictlysecret" /project VI_StandardWeb

Example based on debug compilation of the VI_User_Registration_Web

VI.WebDesigner.CompilerCmd.exe /conn "Data Source=mydbserver.lan;Initial Catalog=Q1IM; User ID=sa; Password=secret" /dialog "Module=DialogUser;User=cccAdmin;Password=strictlysecret" /project VI_UserRegistration_Web -D

Sub-projects are not compiled, as opposed to the default settings in the Web Designer. This means, VI_UserRegistration_Web is not compiled when the VI_StandardWeb is compiled.

Uninstalling the Web Portal

Uninstalling the Web Portal

To uninstall a web application

  1. To uninstall a web application, use the Web Installer.
    1. Execute the program autorun.exe from the root directory on the One Identity Manager installation medium.
    2. Go to the Installation tab and select Web-based components and click Install. This starts the Web Installer.

    - OR -

    1. Start the Web Installer from Start | One Identity | One Identity Manager | Configuration | Web Installer.
  2. Select Uninstall a One Identity Manager web application on the Web Installer start page and click Next.
  3. All installed web applications are displayed on the page, Uninstall a One Identity Manager web application.
    1. Select the web application you want to remove by double-clicking on it.
    2. Select the authentication module in the Authentication method section and authenticate yourself.
    3. Click Next to start uninstalling.
    4. Confirm the security prompt with Yes.
  4. The uninstall progress is displayed on the Setup is running page. After installation is complete, click Next.
  5. Click Finish on the last page to end the program.

Configuring the Web Portal

Configuring the Web Portal

Web Portal configuration covers a number of settings. The web application configuration is saved in the web application configuration files web.config, NLog.config and monitor.config which are in the web application root directory and in the table QBMWebApplication of the One Identity Manager database respectively.

Use the Web Designer Configuration Editor (WebDesigner.ConfigFileEditor.exe), to edit the configuration file.

Connection strings and login data are automatically encrypted in the configuration files noted above with the default Microsoft ASP.NET cryptography.

To configure a web application

  1. Start the Web Designer Configuration EditorWebDesigner.ConfigFileEditor.exe, which you will find in the setup folder.

    This opens the Open configuration file window.

  2. Select the configuration file web.config in the Open configuration file view and click Open.
  3. Select the authentication type required and log in.

    This opens a Web Designer Configuration Editor dialog box. Set the account options in each section.

Detailed information about this topic

Database Connection

The database connection is normally already selected. You can also select a new database connection.

To select a new database connection

  1. Click Enter new connection in the Database connection section.

    This opens the dialog box Add new connection.

  2. Select one of the system types available and click Next.

    This displays a view with more settings.

    NOTE: You will see different options depending on the settings you already selected.

  3. If you have selected the system type SQL server, you are shown the following settings:
    1. Select in Server the server you want.
    2. Enable the check box Windows authentication to use this authentication.
    3. Enter in User the user name you want to use to log in.
    4. Enter in Password the corresponding password for this user name.
    5. Select in Database the database you want.

    - OR -

    If you have selected the system type Oracle, you are shown the following settings:

    NOTE: At this point, only those edit options not already mentioned in the SQL server settings are mentioned here.

    1. Enable the check box Direct access (without client).
    2. Enter the information required in Server, port, service name, user and password.

    - OR -

    If you have selected the system type Application server you will be shown the following options.

    1. Enter the connection data in URL.
  4. Click Finish.

    Your settings are saved and you are returned to the Web Designer Configuration Editor.

NOTE: Select either Test connection or Advanced options in the Options menu, if required.

Related Topics
Related Documents