Upgrade Guide


Upgrading from a previous Adabas Version

This section is intended to assist a user upgrading to Adabas 6.6 from an older version of Adabas.

Installation

One of the major new features of Adabas 6.6 is that installation of the product is now performed by the SAG Installer, which requires different handling procedures compared to previous versions.

On Unix platforms, the default installation directory is /opt/softwareag. Nevertheless, it is recommended that you install in a separate subdirectory (e.g. /opt/softwareag/Suite1) or in another location because it is not possible to install more than one Adabas version into the same directory. You cannot overwrite an existing version, you can only uninstall it.

For further information see the section Important Information and follow the instructions in the section Installing Adabas.

Adabas License and ADADATADIR

Adabas 6.6 requires that every Adabas installation is licensed separately. If you are upgrading to Adabas 6.6 from an older version and want to access existing databases, ADADATADIR must be changed to point to the directory where the database directories are located.

Follow the instructions in the section Completing the Installation to complete the installation, to activate the license, and to change the default ADADATADIR.

Converting a Database from a previous Version to Version 6.6

If you want to upgrade a database from Version 6.1, 6.2, 6.3, 6.4 or 6.5 to Version 6.6, there are two options available to you:

  1. Convert the data using either the utility ADABCK or ADAORD. This option requires that you:

    1. Create a new Version 6.6 database;

    2. Unload the old database using ADABCK DUMP or ADAORD EXPORT (old version);

    3. Load the new database using ADABCK RESTORE or ADAORD IMPORT (version 6.6).

  2. Convert the data using the utility ADACVT (for further information see Utilities Manual). This utility converts an existing database in place.

    If you want to upgrade a database from Version 3 or Version 5, you must first upgrade the database to Version 6.1, 6.2, 6.3, 6.4 or 6.5, as described in the Release Notes of the version-specific documentation, and then proceed as described above.

The utilities ADACVT, ADABCK and ADAORD make the following modifications:

  • The structure level of the General Control Block (GCB) is increased;

  • The structure of the FDT is changed, when a Version 6.1 database is converted;

  • Databases are included in the ADABAS.INI file, when a DBxxx.INI file exists;

Important:
Software AG strongly recommends that you perform the following actions: before converting a database, use ADABCK to dump the database, then after a database has been converted, use the ADAVFY FIELD and INDEX functions to verify the consistency of the database.

Upgrading from a previous Adabas 6.6 Service Pack

This section is intended to assist a user upgrading from a previous Adabas 6.6 Service Pack to the current Adabas 6.6 version.

Installation

You can install multiple versions of Adabas on the same machine, but each version must be installed in a separate directory, over-installing is not allowed. Therefore, you must choose a separate installation directory for installing the current Service Pack.

For further information see the section Important Information and follow the instructions in the section Installing Adabas.

Adabas License and ADADATADIR

Adabas 6.6 requires that every Adabas installation is licensed separately.

If you want to access existing databases, ADADATADIR must be changed to point to the directory where the database directories are located.

Follow the instructions in the section Completing the Installation to complete the installation, to activate the license, and to change the default ADADATADIR.

Converting a Version 6.6 Database to Version 6.3, 6.4, or 6.5

You have got two options to convert a Version 6.6 database back to a previous version, provided new features introduced with Adabas Version 6.6 were not used.

Use the utility ADACVT to convert a database to a previous version; the conversion will be done in place.

Alternatively you can convert a database using ADABCK. To achieve this, take a backup with ADABCK Version 6.6 and restore the database with the appropriate version of ADABCK.

Care should be taken if collation descriptors were used. As collation descriptors created with ICU version 5.4 are not processed correctly with Adabas Version 6.3 and Adabas Version 6.4, you must reinvert those descriptors.