Guide for the Conversion to Genexus 9.0

Unofficial Content

We suggest following this guide step by step to convert your knowledge base to GeneXus 9.0.

We identify three stages in this process. 
We understand that converting an application implies much more than converting  the knowledge base.  For an overview on the conversion of applications to GeneXus 9.0 we recommend reading Conversion of GeneXus Application - Technical Guide

Stage 1 - Preparing the KB for the conversion

Since the process is not back-compatible, we recommend making a previous backup. We also suggest minimizing the conversion time by following the steps detailed below: 

1. Backup the knowledge base to be converted
We recommend performing a backup of the knowledge base to be converted before starting the process. 
This backup will be the one to be converted to version 9.0. Bear in mind that there are different backup options (for further information go to:,4,61,O,S,0,,7728)
Just the Knowledge Base backup will be enough for this. 

2. Rebuild indexes
To avoid problems of corrupted indexes in the knowledge base we suggest doing a rebuild -Y.
Access here (,4,61,O,S,0,,2106) for further information.

3. Delete every non-used model  
To achieve a faster conversion we recommend deleting all the non-used models and the corresponding backup models, if any. 

4.Delete non-used objects
To save work in the conversion, we recommend deleting all the non-used objects. These non-used objects may have programming errors that may impede their conversion.   

5. Install the Source and Target generator in version 9.0
When the knowledge base conversion also implies a change of generator (e.g.: from VB to .NET, or from VFP to Java), we recommend installing also the Source generator in version 9.0, although it will be not used later. In the migration process, it is frequently necessary to access property files of the source generator, and the fact of not finding them results in errors.

6. Convert the KB
Execute GeneXus 9.0 and open the knowledge base to be converted. See the conversion process.
Remember to save the file with the objects that have conversion errors. It will have to be used to solve the problems reported. 

Stage 2 - Adjusting the KB

We recommend performing an analysis of the models properties, since their default values are frequently changed, which may result in a change of behavior. 

7. Analyze the properties default values
Access here to visualize the changes of the default properties and how this may impact your database.

8. Compatibility
Access here to visualize compatibility topics.

9. New properties
Access here to see the new properties defined in the KB. These new properties should not imply changes in behavior; anyway, we recommend reviewing them.   

Stage 3 - Detailed analysis of the KB

The navigations of all the objects between the initial version and version 9.0 will be analyzed to verify that the behavior is the expected one.
For this, there is an additional tool available that generates a unified text format of the navigations.  

10. Compare navigations
Access here to visualize the methodology to be followed to compare the navigations.
Once the comparison has been completed, you can guarantee that the knowledge base has been converted to version 9.0 maintaining the desired behavior.

11. Test
To finish, you must generate the application in the corresponding Generator and start testing it. If you are performing a basic conversion this process can be executed right away.