Installing as an Upgrade

This release works concurrently with the previous version of COBOL Server, so you do not need to uninstall it.

Install the latest version in a different location and set the environment to point to it. To do this, run the COBOL Server installer with the –installlocation option:

  1. Execute the following command:
    ./InstallFile -installlocation="/opt/microfocus/VisualCOBOL"
    Note: You can use variables when specifying an absolute path for –installlocation. For example, the following examples are equivalent:
    -installlocation="/home/myid/installdir"
    -installlocation="$HOME/installdir"
  2. Execute cobsetenv to set the environment and point to the new install location:
    . <product-install-dir>/bin/cobsetenv
    Note: cobsetenv is only compatible with POSIX-like shells, such as bash, ksh, or XPG4 sh. It is not compatible with C-shell or pre-XPG4 Bourne shell.

Preserving Product Configuration

The following information applies when you are upgrading from releases 6.0, 7.0, or 8.0.

If you install this release to the same install location as release 6.0, 7.0, or 8.0, the product in the current location is moved to a backup directory name.

For example, if the 7.0 product is installed in the default install location, /opt/microfocus/VisualCOBOL, during the installation process it is moved to /opt/microfocus/VisualCOBOL.BKP.YYYY-MM-DD.HH:MM:SS. The new release will be installed in /opt/microfocus/VisualCOBOL. The backup location will store your original installation along with any files you deployed to that directory. It will also contain any configuration files you modified post-install.

When installing 9.0 the installer moves a number of specific configuration files to a different configuration location and symbolically links them back to the new release install location. The configuration location will be one of the following:

  • The default config location is /opt/microfocus/config/.
  • For non-root installation, the default location is $HOME/microfocus/config/.
  • To specify your own configuration location, run the setup file with the following command-line option: -mfconfiglocation=[location]

The setup file creates a directory in the configuration location using a 5-digit checksum of the $COBDIR path. This is so that each configuration location is unique to each product installation. The configuration files and directories are then placed in this COBDIR checksum directory. In the following example, the install location generates a checksum of 39082.

The file /opt/microfocus/config/39082/COBDIRlocation.txt details the COBDIR the configuration area is associated with.

If you have changed any other files in the original installation, you need to be copy these manually from the backup directory, /opt/microfocus/VisualCOBOL.BKP.YYYY-MM-DD.HH:MM:SS, into the install location after the upgrade installation is complete.

You can access the configuration area from $COBDIR/etc/config.

Currently, the setup file only moves the following files and directories, where applicable:

Source Destination
$COBDIR/etc/mfds /opt/microfocus/config/39082/mfds/mfds
$COBDIR/etc/ccsid /opt/microfocus/config/39082/config/ccsid
$COBDIR/etc/secrets /opt/microfocus/config/39082/secrets
$COBDIR/bin/mf370ctl.cfg /opt/microfocus/config/39082/config/mf370ctl.cfg
$COBDIR/bin/CCI.INI /opt/microfocus/config/39082/config/CCI.INI
$COBDIR/deploy/.mfdeploy /opt/microfocus/config/39082/deploy/.mfdeploy
$COBDIR/etc/cas/CTFesjcl.cfg /opt/microfocus/config/39082/cas/CTFesjcl.cfg
$COBDIR/etc/cas/dfhdrdat /opt/microfocus/config/39082/cas/dfhdrdat
$COBDIR/etc/commonwebadmin.json /opt/microfocus/config/39082/escwa/commonwebadmin.json
$COBDIR/etc/mfdsacfg.xml /opt/microfocus/config/39082/mfds/mfdsacfg.xml
$COBDIR/etc/mfdsacfg.dat /opt/microfocus/config/39082/mfds/mfdsacfg.dat
$COBDIR/etc/mf-client.dat /opt/microfocus/config/39082/mfds/mf-client.dat
$COBDIR/etc/mf-server.dat /opt/microfocus/config/39082/mfds/mf-server.dat
$COBDIR/etc/cobol.dir /opt/microfocus/config/39082/config/cobol.dir
$COBDIR/etc/cobopt /opt/microfocus/config/39082/config/cobopt
$COBDIR/etc/cobopt64 /opt/microfocus/config/39082/config/cobopt64
$COBDIR/etc/cobjvm.cfg /opt/microfocus/config/39082/config/cobjvm.cfg
$COBDIR/etc/cobutf8.cfg /opt/microfocus/config/39082/config/cobutf8.cfg
$COBDIR/etc/default.tcf /opt/microfocus/config/39082/config/default.tcf
$COBDIR/etc/mfescache.cfg /opt/microfocus/config/39082/config/mfescache.cfg
$COBDIR/etc/dsdef.cfg /opt/microfocus/config/39082/config/dsdef.cfg