How to install IBM SDS 6.4.0.27 LDAP Client tools on Linux

Applies to

HCL Digital Experience 8.5 and higher

Introduction

It is very common for HCL Digital Experience (DX) to perform searches and modifications on LDAP servers. This article describes how to install IBM SDS Client tools version 6.4.0.27 (June 2023).

IBM's LDAP, known as Security Directory Server (SDS) (formerly Tivoli Directory Server), is very common in DX environments. This article provides detailed steps to install the following IBM SDS Client tools:

idsldapadd
idsldapchangepwd
idsldapdelete
idsldapexop
idsldapmodify
idsldapmodrdn
idsldapsearch
idsldaptrace

Note

Check the product offerings for the latest version.

Instructions

To install the IBM SDS Client tools, refer to the following steps:

Install the IBM Security Directory Server

Note

You can install the Client Tools without the server installed. The IBM Security Directory Server is only needed for testing purposes.

Instantiate the necessary environment variables (change them appropriately). For example:

SDS64="<your server's IP address>"
PORT="389"
DN="cn=root"
PASSWORD="<password>"
export SDS64 PORT DN PASSWORD

Download the latest SDS64 fixes from My HCLSoftware (MHS) or IBM and copy the files to the /mnt/install/portal95/sds64/fixes directory. For this article, version 6.4.0.27 is used, for which the following files need to be downloaded:
- 6.4.0.27-ISS-ISDS-LinuxX64-IF0027.tar.gz
- 8.0.55.29-ISS-GSKIT-LinuxX64-FP0029.tar.gz
Create a temporary directory using the following command:
```
mkdir -p /tmp/sds64/fixes
```
Copy the SDS64 Client packages into the /tmp/sds64/fixes directory using the following command:
```
cp /mnt/install/portal95/sds64/fixes/*ISS* /tmp/sds64/fixes
```

Unpack the downloaded files using the following command:

cd /tmp/sds64/fixes
tar xvf *ISS-ISDS-LinuxX64*
tar xvf *ISS-GSKIT-LinuxX64*

Install the ISDS license using the following command:

/tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/license/idsLicense -q

Verify the license status (a "0" indicates success) and install the license RPM using the following command:

/tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/license/idsLicense -t
echo $?
rpm -ivh /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-license64-6.4.0-*.x86_64.rpm

Install the GSKit using the following command:

rpm -ivh /tmp/sds64/fixes/*-ISS-GSKIT-LinuxX64-*/64/gsk*64*rpm

Install all client search programs and tools using the following command:

rpm -ivh /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-cltbase64-6.4.0-*.x86_64.rpm
rpm -ivh /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-clt64bit64-6.4.0-*.x86_64.rpm
rpm -ivh --force /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-cltjava64-6.4.0-*.x86_64.rpm

Install all English, Spanish, and Portuguese language packages using the following command:

rpm -ivh --force /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-msg64-es-6.4.0-*.noarch.rpm
rpm -ivh --force /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-msg64-pt_BR-6.4.0-*.noarch.rpm
rpm -ivh --force /tmp/sds64/fixes/*-ISS-ISDS-LinuxX64-*/images/idsldap-msg64-en-6.4.0-*.x86_64.rpm

Create links for all binaries and libraries using the following command:
```
/opt/ibm/ldap/V6.4/bin/idslink -i -l 64 -s base
```

Perform an LDAP search on the SDS64 LDAP server:

idsldapsearch -B -D $DN -w $PASSWORD -h $SDS64 -p $PORT -s sub objectclass=*