Compatibility between GeneXus and GeneXus Server versions (X Evolution 3)

Unofficial Content

Some aspects must be considered when working with different combinations of GeneXus and GeneXus Server.

Recommendation: Make sure that the GeneXus Server Upgrade is equal or higher than the GeneXus Upgrade. The reason is that new properties, or structural changes, may cause properties to lose their values when GeneXus Server's operations are performed.

For information about how to migrating a Knowledge Base between GeneXus Server instances, please refer to GeneXus Server Storage Migrator Utility.

Combinations

Using GeneXus Server X Evolution 3

  • GeneXus X Evolution 3

Some considerations are necessary to work with this combination, refer to the Release Notes of the different upgrades of GeneXus X Evolution 3 to know whether new properties have been added and if that affects your installations.

  • GeneXus X Evolution 2 or prior

The combination is not supported.

GeneXus X Evolution 3 or higher is needed when working with GeneXus Server X Evolution 3 or greater.

Note: The following message will appear when working with this combination:

error: GeneXus Server: srv022:Your version of GeneXus is not compatible with this version of GeneXus Server. Please upgrade to at least version 10.3.0.81542

Using GeneXus Server X Evolution 2

  • GeneXus X Evolution 3

The combination is not supported.

  • GeneXus X Evolution 2 

There are some compatibility issues with this combination:

  • GeneXus X Evolution 2 Upgrade 3 introduces new properties, so GeneXus X Evolution 2 Upgrade 3 or higher must be combined with GeneXus Server X Evolution 2 Upgrade 3 or higher.
  • GeneXus X Evolution 2 Upgrade 4 introduces new properties and feature, so GeneXus X Evolution 2 Upgrade 4 or higher must be combined with GeneXus Server X Evolution 2 Upgrade 4 or higher.

Note: as GeneXus X Evolution 2 Upgrade 4 Commit or Update operations involving unknown properties will fail if its value of the property is not the default. The error will be:

Invalid property '<Property Name>'.

For further information, please see SAC#34842.

  • GeneXus X Evolution 1

The combination is not supported.

Using GeneXus Server X Evolution 1

  • GeneXus X Evolution 3

The combination is not supported.

  • GeneXus X Evolution 2 

The combination is not supported.

  • GeneXus X Evolution 1

There are some compatibility issues with this combination:

  • If using the Release version in one of the products, then the Release version must be used in both products.

This means that you can't use GeneXus X Evolution 1 Release Version combined with GeneXus Server with a later Upgrade applied or vice versa. 

This is a result of the Knowledge Base compression implemented in GeneXus X Evolution 1 Upgrade 1. More information here.

  • Any other combination with GeneXus X Evolution 1 (any Upgrade) will imply no errors or considerations required.

 

Troubleshooting

  • When performing a Send Knowledge Base operation using GeneXus X Evolution 1 Upgrade 3 and GeneXus Server X Evolution 1 Release, you'll see the following error:
GeneXus Server: Processing file 'C:\gxserver25909\VDir\binGenexus\ObjectDefinitions\Theme\ThemeGenexusX.xpz'...
GeneXus Server: Reading import file objects...... Finished
GeneXus Server: Importing Theme 'GeneXusX'... ... Failed
error: GeneXus Server: Exception has been thrown by the target of an invocation.
error: GeneXus Server: The Writer is closed or in error state.
...........................................................................................

GeneXus Server: Processing file 'C:\gxserver25909\VDir\binGenexus\ObjectDefinitions\Language\Japanese.xpz'...
GeneXus Server: Reading import file objects...... Finished
GeneXus Server: Importing Language 'Japanese'...
GeneXus Server: Successful
error: GeneXus Server: Exception has been thrown by the target of an invocation.
error: GeneXus Server: The Writer is closed or in error state.
error: GeneXus Server: There was an error creating the Knowledge Base but GXServer could not recover. If you want to send it again remove the broken Knowledge Base 'Prueba98' from the server or send it with a different alias.
error: GeneXus Server: Error cleaning up:'Only user processes can be killed.'
error: GeneXus Server: '', hexadecimal value 0x01, is an invalid character. Line 1, position 1.
error: GeneXus Server: Unable to Deserialize Data.
Send to GeneXus Server Failed

See also