This document provides product-specific instructions for installing the Adabas Directory Server on z/OS UNIX.
This document covers the following topics:
Installing and running the ADI on z/OS UNIX requires:
Java to already be installed in your installation.
Required authority to create, write to, and execute from the directories created during the install.
Installing the Adabas Directory Server (ADI) Java components includes the following steps:
Create a directory to be used to install the Adabas Directory Server.
Copy the delivered .tar file to the install directory.
Unpack the .tar file, that will create the folder structure with subdirectories and files needed for the Directory Server.
Configure the properties in the adi.properties file (if not using the defaults).
ADIENV source member, and make needed
changes for your environment.
Modify the sample
ADIJOB job, used to start and
run the Directory Server.
Start the Directory Server.
To install the Adabas Directory Server, complete the following steps:
Create a z/OS UNIX directory to be used for installing the Adabas Directory Server:
Copy the delivered .tar file to the directory created in Step 1.
This can be done by either:
Navigating to the Directory and executing the following command:
cp "//'hlq.WCPvrs.MVSTAR'" adi.tar
TSO oput command:
tso "oput 'hlq.WCPvrs.MVSTAR' '/u/SAG/SoftwareAG/adi.tar' binary"
The target directory needs to point to the fully qualified name for your installation.
Navigate to the directory containing the adi.tar file and execute the following command to unpack the contents:
pax -r < adi.tar
The default values supplied in the adi.properties file can be changed as required. Please refer to the documentation of the valid values for the fields, contained within the Adabas Directory Server properties file. For example:
Software AG has registered default ADIPORT number 4952 with the Internet Assigned Numbers Authority (IANA) for use by the Adabas Directory Server.
Modify a copy of the
member, to supply the environment variables needed to launch the Java VM.
<path1> with the fully qualified
path to your ADI installation.
<ver1> with the version of the
Adabas Directory Server.
APP_HOME= /u/SAG/SoftwareAG/adi IJO="$IJO -DADIDIR=/u/SAG/SoftwareAG/adi" IJO="$IJO -DADIVER=22.214.171.124"
Modify a copy of the
Supply a valid JOB card
<path to ADI
jar> to the fully qualified path to the Adabas Directory Server
STDENV DD statement to point to
ADIENV member modified in the previous step.
// JAVACLS=' -jar /u/SAG/SoftwareAG/adi/target/adi-126.96.36.199.jar' //STDENV DD DISP=SHR,DSN=hlq.WCPvrs.MVSSRCE(ADIENV)
This section describes how to start and operate the Adabas Directory Server.
To start the Directory Server, submit the modified ADIJOB.
To stop the Directory Server, issue the
P ADIJOB operator
To change the ADIPORT,
Stop the Directory Server.
Modify the value in the adi.properties file as described in step 4 of the installation,
Submit the ADIJOB to restart the Directory Server with the new value.