Upgrading AccessAgent
Upgrade to AccessAgent 8.2.2 to use the new and enhanced AccessAgent features. Upgrading AccessAgent involves replacing the old AccessAgent version but preserving the existing configurations.
Upgrade options
The following upgrade options are supported:
| Current version | Upgrade path |
|---|---|
| 8.2.1 | Do a direct upgrade to version 8.2.2 |
| 8.2 | Do a direct upgrade to version 8.2.2 |
| 8.1 | Do a direct upgrade to version 8.2.2 |
| 8.0.1 |
|
How to upgrade
Upgrading AccessAgent from 8.x to 8.2.2 is like doing a new installation. You install AccessAgent 8.2.2 in all of the computers where AccessAgent 8.x is installed. To upgrade AccessAgent to 8.2.2, follow the instructions in "Upgrading to 8.2.2" in the IBM Security Access Manager for Enterprise Single Sign-On Installation Guide.
What happens when you upgrade
When
you upgrade to AccessAgent 8.2.1:
- By default, AccessAgent 8.0.1 or 8.1 is installed in C:\Program Files\Encentuate\. When you upgrade, the AccessAgent 8.2.2 installer automatically uninstalls the existing AccessAgent and the new version is installed in C:\Program Files\IBM\ISAM ESSO\AA.
- If you have an existing AccessAgent installed
and a Wallet with user credentials, installing the new version automatically
moves the Wallet with user credentials to the new version. An AccessAgent upgrade
does not require any changes to the IMS Server.
After the upgrade, users can use AccessAgent with all their applications and websites.
- The following data are preserved and moved to the new AccessAgent installation
directory:
- Existing user and machine Wallets
- System data
- Fingerprint and smart card settings
- Registry entries from HKEY_LOCAL_MACHINE\SOFTWARE\Encentuate\DeploymentOptions
- Registry entries from HKEY_LOCAL_MACHINE\SOFTWARE\Encentuate\Integration
Upgrade considerations and limitations
Consider the following options, limitations, and changes before you upgrade:
- Upgrade the IMS Server before you upgrade AccessAgent.
- When you upgrade AccessAgent, make sure that you upgrade AccessStudio to the same version.
- Upgrade from AccessAgent 8.1 (x86) on a 64-bit platform to AccessAgent 8.2.2 (x64), is not supported. To upgrade, you must manually uninstall AccessAgent 8.1 (x86) and install AccessAgent 8.2.2 (x64).
- When you uninstall AccessAgent 8.1 (x86), the existing Wallets are removed.
- You must replicate any changes in the registry policies or registry-only settings in the new registry hive after the AccessAgent installation.
- If you set the Citrix Virtual Channel Connector mode properly in the AccessAgent 8.2.2 SetupHlp.ini file, there is no need to manually reinstall the Virtual Channel Connector after the AccessAgent upgrade to 8.2.2.