3.2 Upgrading OpenText Identity Console Workstation on Windows

NOTE:

  • Upgrade OpenText Identity Console to the latest version to support OpenText eDirectory 9.3.

  • Reinstall the NICI instance to support the upgraded version of OpenText Identity Console (version 1.9 and later).

The following procedure describes how to upgrade OpenText Identity Console (version 1.5 and later) workstation on Windows.

  1. Before upgrading to the new version, ensure to uninstall the previous version as explained: Uninstallation of OpenText Identity Console Workstation on Windows.

    NOTE:To retain the system preference settings, we recommend you to take backup of CustomConfig.json file from C:\IdentityConsole_version_workstation_win_x86_64\eDirAPI.

  2. Log in to the Software License and Download portal and navigate to the Software Downloads page.

  3. Select the following:

    • Product: OpenText eDirectory

    • Product Name: OpenText eDirectory per User Sub SW E-LTU

    • Version: 9.2, 9.3

  4. Download the latest version: IdentityConsole_<version>_workstation_win_x86_64.zip.

  5. Extract the downloaded IdentityConsole_<version>_workstation_win_x86_64.zip.

  6. Navigate to the extracted folder: IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\cert, IdentityConsole_<version>_workstation_win_x86_64\eDirAPI, and copy the keys.pfx and the customConfig.json file respectively that was taken as backup during Uninstallation of OpenText Identity Console Workstation on Windows.

    To get the certificates, refer to the section: System Requirements and Prerequisites for Workstation.

    If the user need to connect to multiple OpenText eDirectory trees, refer to the section: Multi-tree with OpenText Identity Console as Workstation.

    NOTE:The server certificate name must always be as keys.pfx.

  7. (Optional) Navigate to the folder where the build is extracted and install NICI_wx64 depending on the system configuration. If your system has eDirectory, proceed directly to step 8.

  8. Double-click on the file configure.bat > enter the server certificate (keys.pfx) password in the command prompt.

  9. Double-click on the file run.bat (Windows batch file).

    The eDirAPI process terminal (edirapi.exe) starts running, and the OpenText Identity Console login page appears.

NOTE:

  • If the eDirAPI process terminal (edirapi.exe) is already running, then run identityconsole.exe from the build extracted folder.

  • Users can find the following logs in: \IdentityConsole_<version>_workstation_win_x86_64\eDirAPI\log

    edirapi.log - This is used for logging different events in edirapi and debugging issues.

    edirapi_audit.log - This is used for logging audit events of edirapi. The logs follow CEF auditing format.

  • OSP based login is not supported in workstation mode.

  • OpenText Identity Console Workstation is listening on 9000 port. Do not modify the edirapi_win.conf file.