Installation

Supported Platforms

Ianus is fully supported on Windows and Linux systems.

Prerequisites

Ianus is a .NET core application and requires .NET Core 8 SDK or runtime. It can be obtained at https://dotnet.microsoft.com/download/dotnet-core.

Additional software

In order to execute specific operations, Ianus requires additional sofware and/or licenses.

  • Connecting DB2 on z/OS requires a valid IBM DB2 Connect license (only license - not the DB2 client). Once Ianus is installed a valid and compatible (same version) license file (i.e. db2consv_ee.lic) must be copied in: <IANUS_INSTALLATION_DIR>\bin\clidriver\license (for Windows) or <IANUS_INSTALLATION_DIR>\bin-lnx\clidriver\license (for Linux).
  • JCL submit tasks towards MFES classic or .NET as well as the SORT feature of the filecompare task, require Micro Focus Enterprise Server or Developer to be installed on the system.
  • Excel task requires libgdiplus.

Software Installation

Please follow the steps indicated below for the target platform. .NET 6 must be installed before proceeding with the Ianus installation.

Windows

If you are installing on Windows:

  • Unzip the distribution package in the desired directory (i.e. C:\Ianus)
  • Add the directory containing the Ianus executables to the PATH environment variables. For example:
set PATH=%PATH%;C:\Ianus\bin

Linux

If you are installing on Linux:

  • Unzip the distribution package in the desired directory (i.e. $HOME/Ianus). For example:
unzip Ianus-3.0.0.zip –d $HOME/Ianus
  • Add the directory “bin-lnx” in the distribution folder to your PATH:
PATH=$HOME/Ianus/bin-lnx:$PATH

Make sure that the file ianus in the bin-lnx directory has the necessary permissions to be executed. If not, set the x permission. Example:

chmod 755 $HOME/Ianus/bin-lnx/ianus

DB2 Clients

Ianus DOES NOT requires any DB2 client to be installed to connect DB2.

On linux systems where DB2 clients are installed, Ianus DB2 drivers may conflict with DB2 clients and produce connection errors like the following, when trying to connect DB2:

[fatal] IBM.Data.Db2.DB2Exception (0x80004005): ERROR [58005] [IBM][DB2.NET] SQL0902 An unexpected exception has occurred in  Process: 226665 Thread 12 AppDomain: Name:Ianus
There are no context policies. Function: AESEncryptADONET (Encryption Info)

The root cause is an incompatibility with the DB2 GSKit. In this case, the solution is to copy the GSK libraries libgsk* provided by the following packages:

  • gskssl64-8.0-55.18.x86_64
  • gskcrypt64-8.0-55.18.x86_64

in the directory <IANUS_INSTALLATION_DIR>\bin\clidriver (for Windows) or <IANUS_INSTALLATION_DIR>/bin-lnx/clidriver (for Linux).

On systems where DB2 server is installed, the process above might not work. In this case follow the following steps:

  • go in the IANUS binaries directory (<IANUS_INSTALLATION_DIR>\bin or <IANUS_INSTALLATION_DIR>/bin-lnx)
  • backup the directory clidriver
  • create a new directory clidriver and subdirectory clidriver/lib
  • copy libdb2.so in the freshly created clidriver/lib

Licensing

Important

Starting with version 2.0, Ianus implements a licensing control mechanism. The license is connected to the machine specific data. It is contained in license key or in license file that must be located on the machine executing Ianus and indicated in the Environment file (see License Element).

Windows

To obtain a valid license file, the processor ID and the BIOS serial number of the workstation to license must be provided to HPE to generate the license file for the workstation.

The processor ID and the BIOS serial number can be obtained issuing the following commands to a DOS prompt:

wmic cpu get processorid
wmic bios get serialnumber

Linux

To obtain a valid license file, the processor serial number be provided to HPE to generate the license file for the workstation.

The processor serial can be obtained issuing the following commands to a shell prompt:

cpuid | grep "processor serial number"