IBM Security Access Manager for Enterprise Single Sign-On, Version 8.2

Installing Context Management

To use context management, you must install Carefx Crypto Utility, Carefx Fusionfx Context Channel and Carefx Fusionfx Context Enabler. You must also edit the Carefx registry and properties file.

Before you begin

Make sure that:
Important: If you have a previous version of Context Management, uninstall the previous version and delete or rename its folder. See Uninstalling Context Management.

Procedure

  1. Download the latest installer of your context management system from the FTP or download site.

    If the installer is in a compressed file, create a folder in your local computer and extract the compressed file into that folder. For example: <INSTALLDIR>.

  2. Navigate to the Integrated_Installer folder.
  3. Select Start > Run.
  4. Navigate to <INSTALLDIR>\FCM Enabler\Setup.exe.
  5. Run the program and retain the default values for the installation options.
  6. Navigate to <INSTALLDIR>\CfxCrypto\Cfx- Crypto.exe.
  7. Run the program and retain the default values for the installation options.
  8. Navigate to <INSTALLDIR>\Context Channel\Setup.exe.
  9. Run the program and retain the default values for the installation options.
  10. Navigate to the <INSTALLDIR>\WTS Session folder.
  11. Copy its contents to the <PROGDIR>\Carefx\cm-sdk\cm-client folder.
    Note:
    • <PROGDIR>\Carefx is the base installation folder for Carefx.
    • Overwrite the existing files with the copied files that have the same name in this folder.
  12. In the <PROGDIR>\Carefx\cm-sdk\cm-client folder, double-click the contextsession.reg file.
  13. When prompted, click Yes to add the registry file into the system registry.
  14. Click OK.
  15. Register the COM components.
    1. Select Start > Run.
    2. Enter cmd in the Open field.
    3. Click OK.
    4. Type cd <PROGDIR>\Carefx\cm-sdk\cm-client\.
    5. Press Enter.
    6. Type regsvr32 CarefxSessionUtil.dll.
    7. Press Enter. A dialog box is displayed, indicating that the registration of the library file has been completed.
    8. Click OK.
    9. Type regsvr32 CMWtsUtil.dll.
    10. Press Enter. A dialog box is displayed, indicating that the registration of the library file has been completed.
    11. Click OK.
    12. Type exit then press Enter.
  16. Navigate to the <INSTALLDIR>\Properties folder.
  17. Copy the cmsecurity.properties file to the <PROGDIR>\Carefx\cm-sdk\properties folder.

    Overwrite the existing files with the copied files that have the same name in this folder.

  18. Navigate to the <PROGDIR>\Carefx\cm-sdk\Fusionfx\Context Channel\ folder.
  19. Right-click the fcc.ini file, and then click Edit.
  20. Add the following lines in the [CCOW] section:
    userSubjectSuffix=desktop
    patientSubjectSuffix=desktop
    encounterSubjectSuffix=
  21. Save the file then close the window.
  22. Navigate to the <INSTALLDIR>\Launcher folder.
  23. Copy the contents of the entire folder to the <PROGDIR>\Carefx folder.
  24. Create a shortcut of <PROGDIR>\Carefx\CM-sdk\cm-server\startcs.cmd.
  25. Paste the shortcut in Start menu > All Programs > Startup so that the program runs when Windows starts.
  26. Enable the logon or logoff script policies in the IMS Server for the Carefx user.

    To know which VBScript to add, see Testing Context Management.

  27. Restart the computer.
  28. Open the Registry Editor and export the registry location [HKLM\Software\Encentuate\AccessAgent\Integration\Carefx\FusionFx].
  29. Open the exported registry file.
  30. Replace Encentuate with IBM\ISAM ESSO. For example:
    Original location
    [HKEY_LOCAL_MACHINE\SOFTWARE\Encentuate\AccessAgent\Integration\Carefx\FusionFx]
    Updated location
    [HKEY_LOCAL_MACHINE\SOFTWARE\IBM\ISAM ESSO\AccessAgent\Integration\Carefx\FusionFx]
  31. Double-click the registry file to add to the registry.
  32. Verify that [HKEY_LOCAL_MACHINE\SOFTWARE\IBM\ISAM ESSO\AccessAgent\Integration\Carefx\FusionFx] is created in the Registry Editor.

What to do next

After you have installed Context Management, you can upgrade AccessAgent to a later version. The upgrade does not affect the current installation of Context Management. See "Upgrading the AccessAgent" in the IBM Security Access Manager for Enterprise Single Sign-On Installation Guide.

After upgrading AccessAgent, edit the PATH environment variable to include the <aa_home>. For example: C:\Program Files\IBM\ISAM ESSO\AA.

To edit the PATH environment variable:
  1. Right-click My Computer and then click Properties.
  2. Click Advanced > Environment Variables.
  3. Click an existing variable PATH either from the User variables or System variables, and then click Edit to change its value.


Feedback