Installing and Running Adabas Directory Server on z/OS

#### Search Results

Search

# Installing and Running Adabas Directory Server on z/OS

This document provides product-specific instructions for installing the Adabas Directory Server on z/OS UNIX.

This document covers the following topics:

- Prerequisites

- Installation Overview

- Installation Steps

- Adabas Directory Server on z/OS UNIX Operation

## Prerequisites

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.

## Installation Overview

Installing the Adabas Directory Server (ADI) Java components includes the following steps:

1. Create a directory to be used to install the Adabas Directory Server.

2. Copy the delivered .tar file to the install directory.

3. Unpack the .tar file, that will create the folder structure with subdirectories and files needed for the Directory Server.

4. Configure the properties in the adi.properties file (if not using the defaults).

5. Copy the `ADIENV` source member, and make needed changes for your environment.

6. Modify the sample `ADIJOB` job, used to start and run the Directory Server.

7. Start the Directory Server.

## Installation Steps

To install the Adabas Directory Server, complete the following steps:

1. Create a z/OS UNIX directory to be used for installing the Adabas Directory Server:

       mkdir SoftwareAG

2. 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

   Or:
   Execute the `TSO oput` command:

       tso "oput 'hlq.WCPvrs.MVSTAR' '/u/SAG/SoftwareAG/adi.tar' binary"

   Note
   The target directory needs to point to the fully qualified name for your installation.

3. Navigate to the directory containing the adi.tar file and execute the following command to unpack the contents:

       pax -r < adi.tar

4. 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:

       /u/SAG/SoftwareAG/adi/config/adi.properties

   Note
   Software AG has registered default ADIPORT number 4952 with the Internet Assigned Numbers Authority (IANA) for use by the Adabas Directory Server.

5. Modify a copy of the `hlq.WCPvrs.MVSSRCE(ADIENV)` source member, to supply the environment variables needed to launch the Java VM.

   - Replace variable `<path1>` with the fully qualified path to your ADI installation.

   - Replace variable `<ver1>` with the version of the Adabas Directory Server.

   - Replace variable `<pathJava17>` with the location of your Java 17 installation on USS.

   For example:

       APP_HOME=/u/SAG/SoftwareAG/adi
       IJO="$IJO -DADIDIR=/u/SAG/SoftwareAG/adi"
       IJO="$IJO -DADIVER=5.9.0.0"
       export JAVA_HOME=/usr/lpp/java/J17.0_64

6. Modify a copy of the `hlq.WCPvrs.MVSSRCE(ADIJOB)` source member, to:

   - Supply a valid JOB card

   - Point `<path to ADI jar>` to the fully qualified path to the Adabas Directory Server .jar file.

   - Modify the `STDENV DD` statement to point to the `ADIENV` member modified in the previous step.

   For example:

       //  JAVACLS=' -jar /u/SAG/SoftwareAG/adi/target/adi-5.9.0.0.jar'
       //STDENV   DD DISP=SHR,DSN=hlq.WCPvrs.MVSSRCE(ADIENV)

## Adabas Directory Server on z/OS UNIX Operation

This section describes how to start and operate the Adabas Directory Server.

- Starting the Directory Server

- Stopping the Directory Server

- Changing the ADIPORT

### Starting the Directory Server

To start the Directory Server, submit the modified ADIJOB.

### Stopping the Directory Server

To stop the Directory Server, issue the `P ADIJOB` operator command.

### Changing the ADIPORT

To change the ADIPORT,

1. Stop the Directory Server.

2. Modify the value in the adi.properties file as described in step 4 of the installation,

3. Submit the ADIJOB to restart the Directory Server with the new value.

### On this page

- Prerequisites
- Installation Overview
- Installation Steps
- Adabas Directory Server on z/OS UNIX Operation