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 947: AnyCA Gateway Upgrade Compatibility Matrix for upgrade compatibility between Keyfactor AnyCAGateway formats.

Table 947: AnyCA Gateway Upgrade Compatibility Matrix

Source Version → From

Target Version ↓ To

 DCOM v22.1.1 DCOM v23.3 DCOM v23.4 DCOM v24.1 DCOM v24.2 DCOM v24.3 REST v23.1 REST v24.1 REST v24.2 REST v24.3 REST v24.4
DCOM v22.1.1  
DCOM v23.3  
DCOM v23.4  
DCOM v24.1  
DCOM v24.2  
DCOM v24.3  
REST v23.1 * * + + +  
REST v24.1 * * * + +  
REST v24.2 # # # # +  
REST v24.3 # # # # #  
REST v24.4 # # # # #  

Table 948: Legend: AnyCA Gateway Upgrade Compatibility Matrix

Symbol Meaning
Supported

Downgrade not supported, or REST to DCOM not supported
* Not Supported - Must upgrade to DCOM 24.1, then to REST v24.1
** Not Supported - Must upgrade to DCOM 24.2, then to REST v24.2
+ Not Supported - Must upgrade directly to REST v24.1
++ Not Supported - Must upgrade directly to REST v24.2
  Same Version
  Supported - Special case - This was the most recent DCOM release at the time of the REST 23.1 release