Installation and Uninstallation

This chapter describes how to install and uninstall OFCOBOL in Linux.

1. Installation

To install OFCOBOL, an installer binary file appropriate for the system is required. To move to the previous step, enter 'back'. To quit the installation, enter 'quit' and press <Enter>.

The following are the steps for installing OFCOBOL.

  1. Copy the installer binary file to a desired location in a system where OFCOBOL is installed.

  2. If the execution permission is not set on the installer binary, grant the permission using the chmod command as follows.

    The following example grants execution permission to an installer binary for 64-bit Linux.

    $ chmod a+x OpenFrame_COBOL4_0_Linux_x86_64.bin
  3. Execute the installer binary file using one of the following commands, and press <Enter>.

    ./OpenFrame_COBOL4_0_Linux_x86_64.bin
    sh OpenFrame_COBOL4_0_Linux_x86_64.bin
  4. Review the installation introduction. Press <Enter> to proceed.

    Preparing to install...
    Extracting the installation resources from the installer archive...
    Configuring the installer for this system's environment...
    
    Launching installer...
    
    Preparing CONSOLE Mode Installation...
    
    ===============================================================================
    OpenFrame COBOL                  (created with InstallAnywhere by Macrovision)
    -------------------------------------------------------------------------------
    ===============================================================================
    Introduction
    ------------
    
    InstallAnywhere will guide you through the installation of OpenFrame_COBOL3_0.
    
    It is strongly recommended that you quit all programs before continuing with
    this installation.
    
    Respond to each prompt to proceed to the next step in the installation.  If you
    want to change something on a previous step, type 'back'.
    
    You may cancel this installation at any time by typing 'quit'.
    
    PRESS <ENTER> TO CONTINUE:
  5. OFCOBOL License Agreement appears. Enter 'Y' to accept or 'N' to decline the License Agreement and then press <Enter>. The installation will quit if the agreement is not accepted.

    ===============================================================================
    License Agreement
    -----------------
    
    Installation and Use of OFCOBOL Requires Acceptance of the Following License
    Agreement:
    
    TmaxSoft Release
    TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement
    
    Product : OpenFrame COBOL 4.0
    
    This is a legal agreement between you (either an individual or an company) and
    TmaxSoft, Incorporated.  By opening the sealed software package and/or by using
    the software, you agree to be bound by the terms of this agreement.
    
    TmaxSoft License
    1.  Grant of License:  This TmaxSoft License Agreement ("License") permits you
    to use one copy of the TmaxSoft product Tmax, on any single computer, provided
    the software is in use on only one computer at any one time.  If this package
    is a license pack, you may make and use additional copies of the software up to
    the number of licensed copies authorized.  If you have multiple licenses for
    the software, then at any time you may have as many copies of the software in
    use as you have licenses.
      The software is "in use" on a computer when it is loaded into the temporary
    memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk,
    CD-ROM, or other storage devices) of that computer, except that a copy
    installed on a network server for the sole purpose of distribution to other
    computers is not "in use".  If the anticipated number of users of the software
    will exceed the number of applicable licenses, then you must have a reasonable
    
    PRESS <ENTER> TO CONTINUE:
    
    mechanism or process in place to ensure that the number of persons using the
    software concurrently does not exceed the number of licenses.
    
    2.  Copyright:  The software (including any images, "applets," photographs,
    animations, video, audio, music and text incorporated into the software) is
    owned by TmaxSoft or its suppliers and international treaty provisions.
    Therefore, you must treat the software like any other copyrighted materials
    (e.g., a book or musical recording) except that you may either (a) make one
    copy of the software solely for backup or archival purposes, or (b) transfer
    the software to a single hard disk provided you keep the original solely for
    backup or archival purposes.  You may not copy the printed materials
    accompanying the software, nor print copies of any user documentation provided
    in "online" or electronic form.
    
    3.  Other restrictions: This license is your proof of license to exercise the
    rights granted herein and must be retained by you. You may not rent, lease, or
    transfer your rights under this license on a permanent basis provided you
    transfer this license, the software, and all accompanying printed materials,
    retain no copies, and the recipient agrees to the terms of this license. You
    may not reverse engine, decompile, or disassemble the software, except to the
    extent that the foregoing restriction is expressly prohibited by applicable
    law.
    
    PRESS <ENTER> TO CONTINUE:
    
    DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):
  6. Choose the set to install. The default is OpenFrame COBOL. Choose '2' for the preprocessor for MFCOBOL only, or '3' for the preprocessor for NETCOBOL only and then press <Enter>.

    ===============================================================================
    Choose Install Set
    ------------------
    
    Please choose the Install Set to be installed by this installer.
    
      ->1- OpenFrame COBOL
        2- Preprocessor for MFCOBOL (Only)
        3- Preprocessor for NETCOBOL (Only)
    
    ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
       :
  7. Specify the installation directory. Press <Enter> to use the default directory ($HOME/OFCOBOL), or enter the desired installation directory and press <Enter>.

    ===============================================================================
    Choose Install Folder
    ---------------------
    
    Where would you like to install?
    
      Default Install Folder: /home/oframe/OFCOBOL
    
    ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
          :

    If the entered directory already exists, enter '1' to overwrite, '2' to enter another directory, or '3' to quit the installation and then press <Enter>.

    Directory Check
    
    User Specified Directory exists.
    To overwrite OFCOBOL, click 'Overwrite'. To choose a Different directory,
    click 'Change'. To cancel the installation, click 'Cancel'.
    
      ->1- Overwrite
        2- Change...
        3- Cancel
    
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
    DEFAULT:
  8. The installation progress bar appears.

    ===============================================================================
    Installing...
    -------------
     [==================|==================|==================|==================]
     [------------------|--
  9. When the installation is complete, the following message is displayed. Press <Enter> to exit the installer.

    ===============================================================================
    Installation Complete
    ---------------------
    
    Congratulations. OFCOBOL has been successfully installed
    
    PRESS <ENTER> TO EXIT THE INSTALLER:

2. Verifying the Installation

Verify the OFCOBOL installation by checking the following items.

  • Checking log and configuration files

  • Checking directory structure

2.1. Checking Log and Configuration Files

The following describes how to check log and configuration files.

  1. Open the the file in the following directory with an editor and check that there are no error logs.

    $OFCOB_HOME/UninstallerData/log/OpenFrame_COBOL_InstallLog.log
  2. Open the .profile or .bash_profile file and check that the configuration variables are set correctly as in the following example.

    # New environment setting added by OpenFrame_COBOL on Tue Mar 03 08:36:13 MSK 2015 1.
    # The unmodified version of this file is saved in /home/oframe/.bash_profile707936663.
    # Do NOT modify these lines; they are used to uninstall.
    OFCOB_HOME=/home/oframe/OFCOBOL
    export OFCOB_HOME
    # End comments by InstallAnywhere on Tue Mar 03 08:36:13 MSK 2015 1.
    
    # New environment setting added by OpenFrame_COBOL on Tue Mar 03 08:36:13 MSK 2015 2.
    # The unmodified version of this file is saved in /home/oframe/.bash_profile707936663.
    # Do NOT modify these lines; they are used to uninstall.
    PATH="${PATH}:$OFCOB_HOME/bin:"
    export PATH
    # End comments by InstallAnywhere on Tue Mar 03 08:36:13 MSK 2015 2.
    
    # New environment setting added by OpenFrame_COBOL on Tue Mar 03 08:36:13 MSK 2015 3.
    # The unmodified version of this file is saved in /home/oframe/.bash_profile707936663.
    # Do NOT modify these lines; they are used to uninstall.
    LD_LIBRARY_PATH=$OFCOB_HOME/lib:$LD_LIBRARY_PATH
    export LD_LIBRARY_PATH
    # End comments by InstallAnywhere on Tue Mar 03 08:36:13 MSK 2015 3.
    
    # New environment setting added by OpenFrame_COBOL on Tue Mar 03 08:36:13 MSK 2015 4.
    # The unmodified version of this file is saved in /home/oframe/.bash_profile707936663.
    # Do NOT modify these lines; they are used to uninstall.
    OFCOBCPY="${OFCOBCPY}:$OFCOB_HOME/copybook"
    export OFCOBCPY
    # End comments by InstallAnywhere on Tue Mar 03 08:36:13 MSK 2015 4.

2.2. Checking Directory Structure

Once installed, OFCOBOL and preprocessor have different directory structures.

  • Installation of OFCOBOL

    The following is the directory structure created after OFCOBOL is installed.

    $OFCOB_HOME
       +---- UninstallerData
       +---- bin
       +---- cobolparser
             +---- bin
             +---- lib
       +---- config
       +---- copybook
       +---- include
       +---- lib
       +---- license
       +---- llvm
       +---- sample
  • Installation of preprocessor only

    The following is the directory structure when only preprocessor is installed.

    $OFCOB_HOME
       +---- UninstallerData
       +---- bin
       +---- cobolparser
             +---- bin
             +---- lib
       +---- include
       +---- lib
       +---- sample

The followings are the common directories.

UninstallerData

Contains files used to uninstall OFCOBOL.

bin

Contains executable files used in OFCOBOL.

cobolparser

Contains COBOL parser used in OFCOBOL and includes the following subdirectories.

Subdirectory Description

bin

Contains executable files used in the COBOL parser.

lib

Contains library files used in the COBOL parser.

config

Contains configuration files used to configure compiler options in OFCOBOL.

copybook

Contains copybook files used for compiling in OFCOBOL.

include

Contains header files used for compiling in OFCOBOL.

lib

Contains library files used in OFCOBOL.

license

Contains the OFCOBOL license file.

llvm

Contains LLVM-related files used in OFCOBOL.

sample

Contains sample files of OFCOBOL.

3. Uninstallation

To uninstall OFCOBOL, execute Uninstall_OFCOBOL in $OFCOB_HOME/UninstallerData or remove the installation directory using the console command. When using the command, restore the user’s .profile or .bash_profile to the point before the installation.

The following is the OFCOBOL uninstallation process when using the uninstallation file.

$./Uninstall_OFCOBOL

Preparing CONSOLE Mode Installation...
===============================================================================
OpenFrame COBOL                   (created with InstallAnywhere by Macrovision)
-------------------------------------------------------------------------------
===============================================================================
Uninstall OFCOBOL
-----------------

About to uninstall...

OFCOBOL

This will remove features installed by InstallAnywhere.  It will not remove
files and folders created after the installation.

PRESS <ENTER> TO CONTINUE:

===============================================================================
Uninstalling...
---------------

...*
*
*************************
*************************
*************************
************************
...*
*
*************************
*************************
*************************
*************************

===============================================================================
Uninstall Complete
------------------

All items were successfully uninstalled.

4. Verifying the Uninstallation

Verify the OFCOBOL uninstallation by checking the following items.

  1. Checking files and directories

    Check that the installation directory specified during the installation has been removed. Besides the installation directory, any directories created after the original installation may have to be deleted manually.

    Execute the following command to remove the remaining directories and files.

    $ rm -rf OFCOBOL
  2. Checking the configuration file (.profile or .bash_profile)

    Check that the OFCOB_HOME, PATH, LD_LIBRARY_PATH, and OFCOBCPY configuration items created during the installation have been removed.