This document covers the following topics:
This section describes the steps which are needed to be completed after the installation of Adabas on Windows.
To complete the installation of Adabas on Windows.
Activate the Adabas license.
Copy the file holding the license key to a temporary location on your Windows machine.
Start a Command Prompt to activate the license via the Start menu under: All Programs> Start Menu group name > Administration > Adabas n.n > Activate License.
In the Command Prompt execute the adalic
script to activate the license file. Enter:
adalic activate path_to_license_file
where
path_to_license_file represents the
fully qualified path to your license file.
In the case of a first-time installation, continue as described under the step "Verify the Installation" below.
Side-by-Side Installation
If you already have a previous version of Adabas installed and activated:
Terminate your active databases. The administration
command adashow -a lists
the databases that must be terminated.
Deactivate the previous Adabas installation via the Start menu under: All Programs > Start Menu group name > Administration > Adabas n.n > Deactivate Installation.
Activate the current installation via the Start menu under: All Programs> Start Menu group name 2 > Administration > Adabas n.n > Activate Installation.
Continue as described under the step "Verify the Installation" below.
Verify the Installation.
Note:
This step is optional.
To verify your installation, you may choose to:
Create the Demo Database
Start the database
Generate a database report
Terminate the database
To achieve this, execute the following steps:
Create the Demo Database
Via the Start menu under: All Programs > Start Menu group name > Administration > Adabas n.n > Create Demo Database.
Execute the script to create the Demo Database.
Start a Command Prompt to execute Adabas utilities via the Start menu under: All Programs > Start Menu group name > Administration > Adabas n.n > Start Command Prompt.
Start the database from the command prompt issuing the command:
adastart dbid
Where dbid
represents the Database ID of your database.
For further details on adastart, refer to the
section Start
Database: adastart in the Extended
Operation documentation
Generate a database report from the command prompt issuing the command:
adarep dbid=dbid contents
Where dbid
represents the Database ID of your database.
For further details on adarep, refer to the
section ADAREP in the
Utilities documentation.
Determine whether the database is active by executing the following commands from the command prompt:
adashow -a
and
getdbinfo dbid
Terminate the database from the command prompt issuing the command:
adastop dbid
Where dbid
represents the Database ID of your database.
For further details on adastop, refer to the
section Stop
Database: adastop in the Extended
Operation documentation.
Note:
In the above description n.n
represents the current version of Adabas: the 1st digit denotes the major
version, the 2nd digit – the minor version.
If you have Adabas REST Administration installed, the changed Adabas Data directory needs to be updated for Adabas REST Administration service in two locations:
<install-dir>/AdabasRestAdministration/configuration/config.xml
<install-dir>/AdabasRestAdministration/INSTALL/restenv.xml
To apply the changes to these files, you must execute the following command in the Adabas REST administration bin directory:
service.bat data_dir new_location
Where new_location represents the fully qualified path to the new location of your Data directory.
Restart the Adabas REST Administration system service for the new Adabas Data directory location to take effect.
It is not possible to set Global Environment Settings for Adabas.
The Adabas utilities require the Adabas environment variables to be set. The required environment variables are automatically set when the utility programs are executed from the All Programs > Start Menu group name > Administration > Adabas n.n > Start command prompt, where n.n represents the currently installed version of Adabas (the 1st digit denotes the major version, the 2nd digit – the minor version).
Use the script adaenv.bat located in the directory
install_dir\Adabas\INSTALL\ to
set the environment variables, when Adabas utility programs are to be executed
outside the command prompt.
The Adabas Client environment is only required by applications and services, which access an Adabas database or utilize the database communication facilities.
In a Windows environment where multiple Adabas Client installations exist, only one Global Adabas Client Environment installation can be active.
By default, the highest installed version of Adabas Client is set as the Global Environment.
If you want to switch back to a lower version, you must first unset the previous installation and then set the current installation using the script aclenvvar.
To set the Adabas installation use the Start menu. Go to: All Programs > Start Menu group name > Administration > Adabas Client n.n > Configure Global Environment.
In the Command Prompt, execute the script aclenvvar with one of the following options:
- aclenvvar unset
Unsets the previous global environment.
- aclenvvar set
Sets the current global environment.
- aclenvvar show
Displays information about the current local and global environment setting.
Note:
In the above description n.n
represents the current version of Adabas: the 1st digit denotes the major
version, the 2nd digit – the minor version.
Information about the version number can be obtained using the following methods:
Open a command prompt from the menu: . Then execute
sagver %ADAPROGDIR%\adanuc.exe
Open a command prompt from the menu: . Then execute
type %ADAPROGDIR%\version.txt
Note:
In the above description n.n
represents the current version of Adabas: the 1st digit denotes the major
version, the 2nd digit – the minor version.
Information about the version number can be obtained using the following method:
Open a command prompt from the menu: . Then execute
sagver %ACLDIR%\adalnkx.dll
Note:
In the above description n.n
represents the current version of Adabas: the 1st digit denotes the major
version, the 2nd digit – the minor version.
If you are also using the Adabas SQL Gateway or the Adabas Event Replicator, you must reinstall these products. For further information, refer to the related product documentation.