Software Requirements

The setup file will check your machine for whether the prerequisite software is installed and will install any missing prerequisites and the product components. A supported version of Microsoft's Visual Studio must be installed in advance.

Note:
  • Besides the software listed below, the setup file also installs the 64-bit AdoptOpenJDK's OpenJDK 8 (u202) with Hotspot.
  • This product includes OpenSSL version 1.1.1b.

Visual Studio IDE

You must have Microsoft's Visual Studio 2019 version 16.1 or a newer one installed in advance. (Visual Studio 2019 16.0 is supported but you need to use the search field in the Create a new project dialog box in order to find the COBOL project templates).

You need one of the advanced versions of Visual Studio listed below:

  • Professional, Enterprise or Community Edition - see the next section for the Visual Studio components you must install.

Microsoft's Visual Studio Express Edition is not supported.

Important:
  • When installing Visual Studio, ensure you select the Help Viewer component for installing if you want to view the Visual COBOL product help inside Visual Studio. When you select components to install in the Visual Studio installer, click Individual components and check Help Viewer in the Code tools section.

The following software is also required:

  • Microsoft .NET Framework 4.7.2. This is included with Visual Studio.

Selecting the Visual Studio components to install

The Visual Studio installer enables you to customize and only install the workloads and components that are most suitable for your area of development. For example, you can select the components that are required for .NET desktop development, ASP.NET Web or C++ development.

If not already installed, the Visual COBOL setup file will install the following components:

  • .NET Framework version 4.7.2.
  • Debugger
  • Data services

A number of workloads and components are optional and only required by specific types of applications or tasks:

  • Azure, WCF, Web, WPF or SQL CLR application development.

If you require any of these, you can select them when you start the Visual Studio installer or, enable them after completing the installation - see the next section.

Installing Visual Studio features that are not currently installed

If a feature of Visual Studio was not installed during the Visual Studio installation, the respective functionality or the project templates for it are not available. You can install a missing feature in one of the following ways:

Rerun the Visual Studio installer:

  1. Start the Visual Studio installer and choose to modify an existing Visual Studio instance.
  2. Select the workloads and the components that are missing (for example, ASP.NET and web development or Help Viewer).
  3. Start the Visual Studio installation.

Use the Quick Launch control in Visual Studio:

  1. Start Visual Studio.
  2. Type the name of the feature in the Quick Launch control - for example, type ASP.NET or Help Viewer.

    A drop-down list with any features matching your search string appears. If the feature is not already installed, one of the search results will be an option to install it.

Use the Install Missing Feature(s) command in Visual Studio:

  1. Start Visual Studio.
  2. Click Help > Micro Focus Product Help > Install Missing Feature(s) > Feature Name.

    Follow the instructions in the installer to install the missing feature.

  3. Alternatively, if a Micro Focus project template requires a Visual Studio feature which is not currently installed, the IDE displays an information bar with instructions to install the feature.

Other Requirements

Important: 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 a network server, you must update the license server before installing the product as the client is not able to communicate with license servers of versions older than 10000.2.660. On Windows, you can check the version of your license server by clicking Help > About in the Micro Focus License Administration tool.

If Micro Focus License Manager version 10000.2.02070 or older is installed, it must be uninstalled before the product installation or upgrade can continue.

You can download the new version of the license server software from the Micro Focus SupportLine Web site: http://supportline.microfocus.com.