Gateway Upgrade Matrix

There are now two formats of the Keyfactor AnyCAGateway (DCOM and REST). While it is the intention to deprecate the DCOM format eventually, for a brief period, both versions will be released. This complicates the upgrade process, in terms of determining whether a given gateway install can or cannot be upgraded to a particular destination version.

The allowed upgrade rules are as follows:

  • Upgrading from an older DCOM gateway to a newer DCOM gateway is allowed.

  • Upgrading from an older REST gateway to a newer REST gateway is allowed.

  • Converting a DCOM gateway to a REST gateway is only allowed on the exact version (so 24.1 DCOM can upgrade directly to 24.1 REST, but 23.4 DCOM cannot).

  • Converting from a REST gateway to a DCOM gateway is never allowed.

Note:  The DCOM AnyCAGateway blocks database upgrades from the REST AnyCAGateway to the DCOM AnyCAGateway. Upgrades are blocked with an error message stating that the database being upgraded is a REST AnyCAGateway database, and therefore cannot be upgraded. The DCOM AnyCAGateway also checks the database specified in the Set-KeyfactorGatewayDatabaseConnection cmdlet and makes sure it is a DCOM AnyCAGateway database; if it is not, a similar error is raised.

See Table 1039: AnyCA Gateway Upgrade Compatibility Matrix for upgrade compatibility between Keyfactor AnyCAGateway formats.

Table 1039: AnyCA Gateway Upgrade Compatibility Matrix

Source Version → From

Target Version ↓ To

DCOM v23.3 DCOM v23.4 DCOM v24.1 DCOM v24.2 DCOM v24.3 DCOM v25.1 REST v24.1 REST v24.2 REST v24.4 REST v25.1
DCOM v23.3  
DCOM v23.4  
DCOM v24.1  
DCOM v24.2  
DCOM v24.3  
DCOM v25.1  
REST v24.1 # #  
REST v24.2 # # #  
REST v24.4

Must upgrade to DCOM v24.1 then to REST v24.1 to REST v24.4

Must upgrade to DCOM v24.1 then to REST v24.1 to REST v24.4

Must upgrade to REST v24.1 then to REST v24.4

Must upgrade to REST v24.2 then to REST v24.4

 
REST v25.1 # # # # #  

Table 1040: Legend: AnyCA Gateway Upgrade Compatibility Matrix

Symbol Meaning
Supported

Version Downgrade not supported, or REST to DCOM not supported

# Not Supported - Must upgrade to the supported DCOM version on this row, then to the REST version
  Same Version