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.
-
Copy the installer binary file to a desired location in a system where OFCOBOL is installed.
-
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
-
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
-
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:
-
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):
-
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 :
-
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:
-
The installation progress bar appears.
=============================================================================== Installing... ------------- [==================|==================|==================|==================] [------------------|--
-
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.
-
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
-
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.
-
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
-
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.