Overview

DirX provides multiple packages for DirX Directory containerization:

  • A container image of a full, standalone DirX Directory installation referred as the dxd container image. This image uses a scratch base image so no operating system is included. This package can be deployed "as is" or used as a building block for creating shadowing and other configurations in a containerized environment.

  • Per-server container images that each contain only the respective server binary and its dependencies. The following per-server images are delivered: dirxdsa, dirxldapv3, and dirxhttp.

  • A dirxcontroller container image that is responsible for managing DSA replication in the scalable example project.

  • A standalone example Kubernetes project that demonstrates the use and capabilities of the dxd container image. This package can be used as a reference or development base when containerizing a custom DirX Directory installation.

  • A scalable example Kubernetes project that demonstrates how to deploy a horizontally scalable DirX Directory service using the per-server container images and the dirxcontroller image. This package can be used as a reference or development base when containerizing a scalable DirX Directory deployment.

Both example Kubernetes projects are delivered in the same archive as two separate folders.

This document assumes familiarity with DirX Directory and Kubernetes terms, concepts, and tools and provides only the specifics for using the packages with each product. Using the packages described here requires at least a basic understanding of these products.

The documents listed below provide additional details about the concepts and procedures referenced in this document. We recommend that you become familiar with the information in these documents before proceeding with the tasks described in this document:

For DirX Directory:

DirX Directory Administration Reference:

  • Environment Variables

  • IP Port Numbers

  • dbaminit command

  • dbamconfig command

  • dirxload command

DirX Directory Administration Guide

  • Setting up the DSA

For Kubernetes:

See the documentation available at https://kubernetes.io/docs/home