Installing Without Superuser Credentials

Micro Focus recommends that you install this product with superuser permissions. If, however, you need to perform a non-root installation, check the information below. The setup file supports installing into non-root owned directories.

Licensing considerations

  • SafeNet License Manager does not support non-root installs. When using non-root installations, the setup file automatically installs and configures AutoPass as the default License Manager.
  • Multiple users - on a machine that has multiple user accounts that need access to the product and licensing, you must install the product under a user id that has read, write, and execution permissions for all users.

    By default, most user account areas can only be accessed by the owner. In order for all of the users to be able to use the product and License Manager, the installation must be in an account whose $HOME directory all other users on the machine can access.

Performing a non-root installation

  1. Give execute permissions to the setup file:
    chmod +x setup_visualcobol_deveclipse_7.0_platform
  2. Run the installer with the -noroot command line argument:
    setup_visualcobol_deveclipse_7.0_platform -noroot

    This installs the product in the default location, $HOME/microfocus/VisualCOBOL, where $HOME should point to the top-level login directory for the current user.

    The product configuration files are stored in $HOME/microfocus/config, and the CAS regions are stored in $HOME/microfocus/es, by default.

  3. After the installation, you can execute $COBDIR/bin/cobsetenv to set up all the required environment variables.

After installing

Once the installation is complete, you need to run the cobsetenv script in order to set up your COBOL environment. To do this, execute the following command:

. $HOME/microfocus/VisualCOBOL/cobsetenv
. $HOME/microfocus/EnterpriseDeveloper/cobsetenv

If you use any custom environment-setting scripts, you need to add the MFCES_INIT_LOCATION environment variable to them as follows:

MFCES_INIT_LOCATION=$HOME/microfocus/licensing/ces/bin/ces.ini
export MFCES_INIT_LOCATION

This provides the location of the ces.ini licensing configuration file in the non-root installation area for the COBOL Run-Time System.

Configuring ports

The /etc/services file for the registration of port 86 is owned by the root user and cannot be changed without superuser permissions.

You need to ensure that this file includes the mfcobol port entries. On most new operating systems, the entries are present.

However, on some operating systems these port entries might be missing. The setup file reports this issue before installing the product. To resolve it, you need to edit /etc/services manually in a text editor with root permissions and add the following two lines:

mfcobol		86/tcp	# Micro Focus Cobol
mfcobol		86/udp	# Micro Focus Cobol

Additional arguments

Specify -ESadminID="username", if you want to use the SOA functionality.

For non-default installation locations for the product and the product configuration files, use the -installlocation, - mfconfiglocation, and -CASrtDIR command line arguments. See Install Options for details.