Installing Encryption for Entire Net-Work

Before you install Encryption for Entire Net-Work, be sure you have met the requirements described in Prerequisites.

This document covers the following topics:


LUW Installation

On LUW systems, the installation of Encryption for Entire Net-Work provides the required SSL libraries used in encryption. It also provides the open source SSL Toolkit that you can use to create certificates. Although delivered on all supported LUW platforms, the SSL Toolkit only runs on Windows. This section describes general information you should understand prior to completing the installation as well as providing installation and uninstallation steps for Windows environments.

Installation

Installation of Encryption for Entire Net-Work is accomplished by the following steps:

  • Contact Software AG Support to obtain the delivery for the operating system(s) where you want to install Encryption for Entire Net-Work. The delivery is available as an archive (.zip for Windows, .tgz for all others) and will have the following format:

    WSLv2.0.0.0_<platform>.zip/.tgz

    …where <platform> corresponds to the operating system you are installing on.

  • Extract the contents of the archive to a temporary folder on all machines where you already have either Entire Net-Work Server or Entire Net-Work Client already installed and you want to take advantage of SSL communication.

  • Inside this folder, navigate to the WSL directory.

  • Inside this directory, you will see a script called install.bat (Windows) or install.sh. Run this script and follow the prompts to install Encryption for Entire Net-Work on your system.

  • Note that on Windows systems, install.bat requires a command line argument of either "all" or "toolkit". The argument "toolkit" will install only the SSL Toolkit that can be used to generate test certificates. The argument "all" will first install the required SSL libraries in your Adabas Client environment, then will prompt the user whether the SSL Toolkit should be installed as well.

    • The SSL Toolkit delivered is only for use on Windows. The supported Linux/Unix distributions of Encryption for Entire Net-Work deliver the SSL Toolkit as a .zip file that can be transferred to a Windows machine and extracted for use there.

  • When the script completes, Encryption for Entire Net-Work is now installed. See Activating Encryption for Entire Net-Work for details on configuring your Entire Net-Work Server and Clients for SSL usage.

Uninstalling Encryption for Entire Net-Work

Encryption for Entire Net-Work is uninstalled simply by deleting the files installed by the installation script. These files can be found under the AdabasClient directory in your environment as follows:

  • Windows: AdabasClient\bin\sagossl5.dll and AdabasClient\bin32\sagossl5.dll

  • UNIX/LINUX: AdabasClient/lib/libsagossl5.so and AdabasClient/lib_32/libsagossl5.so.

  • On Windows systems, if you have installed the SSL Toolkit, delete the entire SSLToolkit folder.