Software Requirements

Eclipse requirements

  • Visual COBOL installs the 64-bit Eclipse IDE by default and requires a 64-bit Java installation.
  • On SUSE 12, you can only install and use the 64-bit version of Visual COBOL.
  • On other platforms, Visual COBOL only supports the 64-bit version of Eclipse. You can use the 64-bit Eclipse to create both 32-bit and 64-bit applications.
  • The setup file installs Visual COBOL and the 64-bit version of Eclipse 4.8. After the installation, you can install Visual COBOL as a plug-in into other Eclipse 4.8 instances available on the same machine - see Installing Visual COBOL into other instances of Eclipse.
    Note: On Red Hat platforms, you need Red Hat 7 or later, if you want to install Visual COBOL into Eclipse 4.8.

Other software requirements

Before installing this product, you must have the following software installed on your computer:

  • The unzip utility is required by the setup file.
  • The "awk", "ed", "ps", "sed", tar", "sed" and "which" "tar" utilities must be installed and added to the PATH.
  • The pax archiving utility is required by the setup file. Pax is distributed with most UNIX/Linux systems but, if it is missing, you must install it separately. To verify pax is installed, run pax --help or pax --version at the command line.

    On Red Hat 8.1, pax is no longer installed by default. You must install the spax version found in the OS ISO. Use the yum install spax command.

  • On Red Hat, if SELinux is installed, the "SELINUX" configuration must be disabled. To do this, set SELINUX=disabled in /etc/selinux/config.

    This enables the Micro Focus License daemons to start when the machine is booted and the Micro Focus tools and programs to run correctly.

  • Required libraries - 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.

    Library 32-bit Library Name 64-bit Library Name
    SUSE 12ยน SUSE 151 Red Hat 7 Red Hat 8
    glibc2 glibc-*.i686 glibc-*.x86_64 X X
    libgcc libgcc-*.i686 libgcc-*.x86_64 X X
    libstdc++ libstdc++-*.i686 libstdc++-*.x86_64 X X
    glibc-locale glibc-locale-32bit glibc-locale-2 X X
    gtk2 N/A libgtk-2_0-0-2 X X
    gtk2 N/A gtk2-tools-2 X X
    gtk2 N/A libXcomposite1-0 X X
    gtk2 N/A libgdk_pixbuf-2_0-0-2 X X
    gtk2 N/A gdk-pixbuf-query-loaders-2 X X
    gtk2 N/A libjasper1-1 X X
    gtk2 N/A gtk2-*.x86_64 X X
    gtk2-x11 N/A libgthread-2_0-0-2 X X
    libXtst N/A libXtst6-1 X X
    libXtst N/A libXtst-*.x86_64 X X
    glibc-devel glibc-devel-*.i686 glibc-devel-*.x86_64 X X
    PackageKit-gtk N/A PackageKit-gtk-module-*.x86_64
    PackageKit-gtk3 N/A PackageKit-gtk3-module-*.x86_64 X X
    gtk2-engines N/A gtk2-engines.*.x86_64
    libcanberra-gtk2 N/A libcanberra-gtk2-*.x86_64 X
    libcanberra-gtk3 N/A libcanberra-gtk3-*.x86_64 X
    webkitgtk N/A webkitgtk.x86_64
    webkitgtk3 N/A webkitgtk3.x86_64 X X
    webkit2gtk3 N/A webkit2gtk3.x86_64
    xterm Any version Any version X X X X
    unzip Any version Any version X X X X
    libgnome N/A libgnome.x86_64 X
    gcc3, 4 gcc*.i686 gcc*x86_64 X X X X
    cpp3 cpp*x86_64 X X
    libnotify-tools5 libnotify-tools*x86_64 X X
    Note:
    • 1 On SUSE 12 or 15, you can only install the 64-bit version of Visual COBOL. The glibc-locale-32bit library is still required by the SafeNet Sentinel licensed components.
    • * Additional libraries required to use the core_on_error runtime variable. The gdb packages (for the GNU Project Debugger) can be installed from the install media for your OS.
    • 2On 64-bit Red Hat 7, you only need to install glibc-2.17*.x86_64 and glibc-2.17*.i686.
    • 3 On Red Hat, these libraries are required to enable COBOL to compile.
    • Libraries marked with an 'X' are not included in the platform and need to be installed separately.
    • 4 On Red Hat, only the 64-bit gcc libraries are required.
    • 5 For SUSE 12 and later, you might need to install the Notifications Library tools (libnotify-tools). This is to enable notifications to be displayed by the notify-send tool when starting Visual COBOL for Eclipse from a desktop icon. Execute the following command to install the libnotify-tools library:
      zypper install libnotify-tools

    Visit the Red Hat Web site for more information.

  • Xterm, the terminal emulator for the X Window System, is part of your UNIX/Linux distribution but is not installed by default. Use your UNIX/Linux installation media to install it.
  • Java 11 (64-bit) is required to run the Eclipse IDE. The minimum recommended version is AdoptOpenJDK's OpenJDK 8 (u202) with Hotspot. You can download AdoptOpenJDK's OpenJDK 8 with Hotspot from AdoptOpenJDK's Web site and unpack the archive anywhere on your machine.

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.