3.2 Upgrading Identity Console Workstation on Windows

The following procedure describes how to upgrade Identity Console workstation on Windows.

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

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

  3. Select the following:

    • Product: eDirectory

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

    • Version: 9.2

  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, and copy the cert folder that was taken as backup during Uninstallation of 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 eDirectory trees, refer to the section: Multi-tree with Identity Console as Workstation.

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

  7. Navigate to the folder where the build is extracted and install NICI_w32 or NICI_wx64 depending on the system configuration

  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 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.

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