How to upgrade and configure UD6/CMtool Driver for Uniface NINE

This guide is for customers who currently use UD6 with Uniface EIGHT who are upgrading to UNIFACE NINE.

If you are upgrading UD6 and already using Uniface NINE, and want to stay with Uniface NINE (or perform a 'point upgrade', eg: Uniface 9.6.01 to 9.7.05) then please refer to Uniface Minor Upgrade guide.

If you are new to UD6, and this is your first UD6 install, use the Installing UD6/CMtool Driver guide instead.

Step 1 You should first become familiar with the new features of UD6 3.1 ( and the upgrade path that is best for you.
Step 2 Run the UD6 3.1 ( installer executable, and when prompted for an installation directory choose the directory where you have Uniface installed (eg: c:\usys97).
Step 3 Alter the [USER_3GL] section in the usyscom:adm\usys.asn file, eg:
; assuming the default start in directory is c:\usys97\project
Step 4 If you are upgrading from UD6 2.1 then alter the USYS$UD6_PARAMS in your ASN file as described in the ASN Settings for Upgrading guide and the What's new in UD6 3.1 guide.
Step 5

If using Uniface 9 userver (the new polyserver) it may be necessary to enable "exclusive connections to userver" in the client ASN file.

$tcp tcp:server+13000|username|password| -ex
$tcp tcp:server+13000|username|password|ust -ex
Step 6 All versions of Uniface until 9.x will allow you to start against an "old" repository and begin an upgrade. With Uniface 9 this is not possible, so UD6 will fool Uniface 9.1 into believing it is starting against a Uniface 9 repository regardless of where the UD6 XML files were created. However if you are using Uniface 9.2 you must set the version of the repository in the in your ASN file USYS$UD6_PARAMS. These settings are:
USYS$UD6_PARAMS=forcever, etc etc
Step 7 When you perform the Uniface 9 Migration step with your Uniface 8.4.x repository it will perform some special actions. In order for these to work correctly you must specify some additional settings in your ASN file USYS$UD6_PARAMS. These settings are:
USYS$UD6_PARAMS=performance 239, etc etc
Step 8 Before you start Uniface 9 you must delete these models and all associated relationships, tables and sub-types:
  • DICT
  • UVCS
  • TEXT

The simplest way to do this is from a "DOS SHELL" and use the del *DICT*.XML (or similar) command.

Step 9 From within the Uniface 9 IDF, use the MIGRATE REPOSITORY function.
Step 10 When the upgrade has completed, check the message frame (messages like: UD6 PERFORMANCE ... can be ignored). Close the IDF and remove the performance 239 setting from the ASN file.

$Revision: 1.3 $ $Date: 2019/06/22 08:17:09 $[go to top]