Software Requirements

Software required by the setup file

The following software must be installed in advance:

• Java versions 17 or 21 from Adoptium (such as the Adoptium OpenJDK Temurin 17 (LTS) with HotSpot) and Oracle are required for Visual COBOL for Eclipse.
• The unzip utility.
• The "awk", "ed", "ps", "sed", tar", "sed", and "which" utilities must be installed and added to the PATH.

• On AIX 7.2 and 7.3, the installer requires the Open XL C/C++ 17.1 Clang C++ compiler. You need to install the Open XL C/C++ 17.1 runtime environment and utilities package.

• If SELinux is installed and you plan to use anything other than core COBOL functionality, or plan to use Enterprise Server within an environment with ASLR enabled, the "SELINUX" configuration must be disabled. To do this, set SELINUX=disabled in /etc/selinux/config.

Libraries required by the setup file

The 32-bit libraries listed below are required on both 32-bit and on 64-bit Operating Systems for this product to install and work correctly.

If installing on a 64-bit OS, the 32-bit libraries are not installed by default and must be installed before you start the installation.

Required environment variables

Before you start the installation, you need to set the environment as follows:

• Set the JAVA_HOME environment variable. When installing the product, set this variable to a 64-bit Java installation or the installation terminates. For example, execute the following:

  export JAVA_HOME=java_install_dir

  where java_install_dir is the path to the JAVA installation directory such as /usr/java/javan.n

• Add $JAVA_HOME/bin to your system PATH variable. To do this, execute:

  export PATH=$JAVA_HOME/bin:$PATH

• You need to set the LANG environment variable to pick up localized messages. If you do not set it as specified here, the installation will run but you might experience unexpected behavior from the installer.

  The LANG settings are English and Japanese only so set it to one of the following locales:

  C, default, en_GB, en_GB.UTF-8, en_US, en_US.UTF-8

  ja_JP, ja_JP.SJIS, ja_JP.UTF-8, ja_JP.eucJP, ja_JP.eucjp, ja_JP.sjis, ja_JP.ujis, ja_JP.utf8, japanese

  You can set LANG before running the setup file as follows:

  export LANG=C

  Alternatively, add it to the start of the setup command line:

  LANG=C ./setupfilename

  See Using the LANG Environment Variable for details.

Software installed by the setup file

• The setup file installs Visual COBOL and the 64-bit version of Eclipse 4.28 (2023-06). After the installation, you can install Visual COBOL as a plug-in into other Eclipse 4.28 (2023-06) instances available on the same machine - see Installing Visual COBOL into other instances of Eclipse.
  Note: On SUSE platforms, you can only use the 64-bit version of Eclipse to produce 64-bit applications; on other 64-bit platforms, you can use Eclipse to produce both 32-bit and 64-bit applications.

• Xterm, the terminal emulator for the X Window System, is part of your UNIX/Linux distribution but is not always installed by default. Use your UNIX/Linux installation media to install it.

Requirements for running the product

• Java 17 (64-bit) or 21 is required to run the Eclipse IDE. The recommended version is Adoptium's OpenJDK Temurin 17 (LTS) with HotSpot. On Windows, the installer automatically installs Adoptium's OpenJDK Temurin 17 (LTS) with HotSpot. On Linux, you need to install Java before you install this product. You can download Adoptium's OpenJDK Temurin 17 (LTS) with HotSpot from Adoptium's Web site and unpack the archive anywhere on your machine.

License Manager requirements

• For local servers, you do not need to install the Micro Focus License Administration tool separately, as the setup file installs a new Visual COBOL client and a new licensing server on the same machine.
• If you have any network license servers, you must update them before you update the client machines.
• If you are upgrading from Visual COBOL release 2.2 or earlier, uninstall the license manager before installing the product.