Before You Begin
Purpose
This tutorial shows you how to install Micro Focus® Server Express™ COBOL compiler and license for use with PeopleSoft environments on an Oracle Compute Cloud Service instance.
Time to Complete
30 to 45 minutes
Background
PeopleTools Installation for your database platform, "Installing and Compiling COBOL on UNIX."
PeopleSoft Enterprise Frequently Asked Questions About PeopleSoft and COBOL Compilers, My Oracle Support, Doc ID 747059.1.
Context
This OBE is part of the following set of OBEs, which describe how to deploy a PeopleSoft environment to Oracle Compute Cloud Service:
- Generating an SSH Key Pair
- Migrating PeopleSoft Applications to Oracle Compute Cloud Service
- Installing Micro Focus COBOL Compiler and License on an Oracle Compute Cloud Service Instance (optional)
- Compiling PeopleSoft COBOL Programs on an Oracle Compute Cloud Service Instance (optional)
- Performing PeopleTools-Only Upgrade on PeopleSoft Environments Running in Oracle Cloud (optional)
- Performing a PeopleTools Patch Update on a PeopleSoft Environment Running in Oracle Cloud (optional)
- Cloning a PeopleSoft Environment in Oracle Cloud (optional)
- Scaling Existing PeopleSoft Environments on Oracle Cloud (optional)
- Using PeopleSoft Update Images in Oracle Compute Cloud Service
What Do You Need?
- The Micro Focus Server Express software media
file
For this tutorial, download V75535-01.zip from Oracle Software Delivery Cloud for Micro Focus Server Express 5.1 Wrap Pack 11. - License for Micro Focus Server Express COBOL
Compiler
Oracle is the exclusive reseller of the Micro Focus COBOL compiler for use with PeopleSoft applications. Contact your Oracle sales representative for a license. - Subscription to Oracle Compute Cloud Service
See Oracle Compute Cloud Service, Get Started. - Secure Shell (SSH) key with a bit size of 2048
or higher
See Creating Oracle Compute Cloud Service Instances Using an Orchestration, Generating an SSH Key Pair. - The operating system on your Oracle Compute Cloud Service instance used for the PeopleSoft Application Server must be Oracle Linux 6.6.
- Storage volumes attached to the created
instance.
The installation of Server Express 5.1 WP11 compiler requires 245 MB, in addition to the PeopleSoft Application and PeopleTools storage requirements.
Process Overview
The installation includes the following high-level steps:
- Transfer the Server Express distribution to an Oracle Cloud compute node.
- Install the Server Express COBOL compiler and License Management Facility.
- Install the Server Express license.
Transferring the Server Express Zip File to the Oracle Cloud Instance
This section transfers the Server Express software
zip file to the Oracle Cloud instance using SCP
(Secure Copy). The file is transferred from a
source machine to a target Oracle Cloud instance with
IP address 192.51.100.112.
- Create a directory, for example, MicroFocus, on
the target Oracle Cloud instance for the Server
Express software media file, in the user home
directory.
$ pwd
/home/opc/MicroFocus - On the source machine, copy your public key, for example id_rsa_opc, to your $HOME/.ssh folder, such as /home/psftuser/.ssh
- On the source machine, copy the Server Express
file to the /home/psftuser/MicroFocus directory.
srcsrv : /home/psftuser : ls MicroFocus
opc@192.51.100.112
V75535-01.zip - On the source machine, transfer the Server
Express zip file to the target Oracle Cloud
instance using the following scp command.
scp -i /home/psftuser/.ssh/id_rsa_ocp /home/psftuser/MicroFocus/V75535-01.zip opc@192.51.100.112:/home/opc/MicroFocus/V75535-01.zip
The scp command displays statistics indicating the percent progress, bytes copied, transfer rate and estimated time remaining.
srcsrv : /home/psftuser : 51.100.112:/home/opc/MicroFocus/V75535-01.zip <
V75535-01.zip 37% 26MB 260.5KB/s 02:51 ETA
Installing Server Express and the License Management Facility
- Log in as root on the target Oracle Cloud
instance.
$sudo su -root
- Create a directory for the Micro Focus Server
Express installation; for example:
mkdir -p /products/mf/svrexp-5.1-wp11-64bit
- Change directory to the one that you created in
the previous step.
cd /products/mf/svrexp-5.1-wp11-64bit
- Copy V75535-01.zip from the /home/opc/MicroFocus
directory to /products/mf/svrexp-5.1-wp11-64bit.
# cp /home/opc/MicroFocus/V75535-01.zip # ls
V75535-01.zip - Unzip the file.
# unzip V75535-01.zip
Archive: V75535-01.zip
inflating: V75535-01.tar - Extract the tar file.
# ls
V75535-01.tar V75535-01.zip
# tar -xvf V75535-01.tar - List the items in the directory with the
ls -lcommand.
# ls -l
total 267288
-r--r--r-- 1 root root 10455 Jan 21 2015 ADISCTRL
dr-xr-xr-x 2 root root 400 Jan 21 2015 aslmf
dr-xr-xr-x 4 root root 5780 Feb 10 2015 bin
dr-xr-xr-x 2 root root 1280 Jan 21 2015 cpylib
dr-xr-xr-x 28 root root 560 Jan 21 2015 demo
dr-xr-xr-x 2 root root 80 Jan 21 2015 deploy
dr-xr-xr-x 2 root root 540 Jan 21 2015 dialog
dr-xr-xr-x 6 root root 300 Feb 10 2015 docs
dr-xr-xr-x 2 root root 1200 Jan 21 2015 dynload
dr-xr-xr-x 2 root root 400 Jan 21 2015 dynload64
dr-xr-xr-x 4 root root 80 Jan 21 2015 es
-r--r--r-- 1 root root 11949 Jan 21 2015 eslmf-mess
dr-xr-xr-x 6 root root 2780 Jan 21 2015 etc
dr-xr-xr-x 2 root root 420 Jan 21 2015 include
-r-xr-xr-x 1 root root 9446 Jan 21 2015 install
dr-xr-xr-x 17 root root 360 Jan 21 2015 lang
dr-xr-xr-x 7 root root 14560 Jan 21 2015 lib
dr-xr-xr-x 6 root root 540 Jan 21 2015 lmf
dr-xr-xr-x 3 root root 60 Jan 21 2015 snmp
dr-xr-xr-x 8 root root 160 Jan 21 2015 src
-rw------- 1 root root 200232960 Mar 10 2015 V75535-01.tar
-rwx------ 1 root root 72884693 Dec 16 09:45 V75535-01.zip
dr-xr-xr-x 10 root root 500 Jan 21 2015 terminfo - Set the environment variable COBDIR to the
current directory,
/products/mf/svrexp-5.1-wp11-64bit.
# export COBDIR='pwd'
- To begin the installation run the command
sh ./install. Answer y to continue the installation:
# sh ./install
This script will install Micro Focus Server Express 5.1 on this computer.
The readme.txt file included in this delivery contains details of
new features, enhancements and any restrictions of which you should
be aware. This file is located in :
/products/mf/svrexp-5.1-wp11-64bit/docs
We strongly recommend you read this file once the installation is complete.
Do you wish to continue (y/n): y - Read the license agreement and type y (yes) to accept it.
- If you are installing on an operating system
platform that Micro Focus has not built the
product on, you see the following message. The
message has been truncated for brevity, as
indicated by [....]. Type y (yes) at the
prompt:
--------------------------------------------------------------------------------
Micro Focus Install
This product was not built or tested on this version
of the Operating System.
[....]
Please confirm that you want to continue with this installation (y/n) y - After reading the following information press
ENTER to continue.
--------------------------------------------------------------------------------
When you press return you will be shown details of the reference
environment (and any compatibility environments).
Please press return when you are ready: - Type y (yes) to continue after reading the
listing of the reference environment. For
the sake of brevity, the text has been truncated,
as indicated by [….]:
This product is certified on the following reference environment:
The command(s) used to gather the information is given following each entry.
Operating System
----------------
RedHatEnterpriseServer 2.6.18-348.el5 x86_64
Red Hat Enterprise Linux Server release 5.9 (Tikanga)
lsb_release -si
uname -r
uname -m
cat /etc/redhat-release
C Compiler
----------
cc gcc version 4.1.2 20080704 (Red Hat 4.1.2-54)
gcc -v 2>&1 | tail -1
C++ Compiler
------------
/usr/bin/g++ gcc version 4.1.2 20080704 (Red Hat 4.1.2-54)
g++ -v 2>&1 | tail -1
[....]
Please confirm your understanding of the above reference environment
details (y/n): y - Answer n (no) to the following prompt:
--------------------------------------------------------------------------------
Do you want to make use of COBOL and Java working together? (y/n): n
Skipping Java setup
Should you want to use Java with COBOL later on
as super user run the command /products/mf/svrexp-5.1-wp11-64bit/bin/java_setup
to select the version of Java you want to use. - Answer y (yes) to the following prompt
to install the licensing facility:
--------------------------------------------------------------------------------
This product is protected using the Micro Focus License Management
Facility (LMF). Please refer to the Development System Licensing Guide
for information relating to the installation of the licensing system
and licenses.
If you do not have LMF installed or want to upgrade to the latest version,
we recommend you install it now.
Would you like to install LMF now? (y/n): y - Enter the directory name, which is /products/mf/mflmf-svrexp-5.1-wp11-64bit
in this example, where you want to install the
License Management Facility (LMF).
Note. Micro Focus and Oracle recommend that you install LMF in its own directory, instead of a sub-directory of the Server Express installation.
Enter the directory name where you wish to install License Manager
(Press Enter for default directory /opt/microfocus/mflmf) /products/mf/mflmf-svrexp-5.1-wp11-64bit
/products/mf/mflmf-svrexp-5.1-wp11-64bit
/products/mf/mflmf-svrexp-5.1-wp11-64bit does not exist
do you wish to create it ? (y/n) y - Enter y (yes) to restrict access to
the License Admin System to the superuser account:
Empty database created ok
Do you want only superuser to be able to access the License Admin System? (y/n) y - Enter y (yes) to start to start the
license manager automatically at boot time:
It is recommended that you let license manager autostart at boot time
Do you want license manager to be automatically started at boot time? (y/n) y - If you want to consult the documentation on how
to install licenses, follow the instructions in
this prompt:
Please consult the Development Licensing Guide for detailed information
on how to install licenses.
This may be done by running the mflicense tool.
--------------------------------------------------------------------------------
To run your applications you need a deployment license installed using Apptrack.
See your Deployment Licensing Guide for details.
Installing Apptrack...
Access permissions on directory /var/mfaslmf have changed on this release
Write access permission has been removed except for superuser use
Apptrack installation complete - Enter 64 for the system default bit
mode:
--------------------------------------------------------------------------------
This product can be used in either 32-bit or 64-bit modes.
Please enter either 32 or 64 to set the system default mode: 64
System default COBMODE has been set to 64. - Wait for the documentation to be installed, and
then enter n (no) at the following
prompt:
--------------------------------------------------------------------------------
Enterprise Server provides a scalable, managed and high-performance
transactional environment for the deployment of COBOL applications
and services, COBOL/J2EE applications and direct COBOL Web Services.
Your Enterprise Server requires configuration. You can either do it now
or later. To do it now you need to know the alphanumeric user ID of the
Enterprise Server System Administrator.
To do it later, enter the following commands whilst logged in as root :
/products/mf/svrexp-5.1-wp11-64bit/bin/eslminstall
/products/mf/svrexp-5.1-wp11-64bit/bin/casperm
Do you wish to configure Enterprise Server now? (y/n): n - Review the information concerning setting the
COBDIR, LD_LIBRARY_PATH, and PATH environment
variables in the concluding prompt:
--------------------------------------------------------------------------------
(Remember to set COBDIR to /products/mf/svrexp-5.1-wp11-64bit,
include /products/mf/svrexp-5.1-wp11-64bit/lib in LD_LIBRARY_PATH
and include /products/mf/svrexp-5.1-wp11-64bit/bin on your PATH)
WARNING: Any executables (whether a Run-Time System or an application)
must be relinked using this new release. Otherwise, the results of
running the older executables with this new release are undefined.
Installation completed successfully.
The COBOL system is ready to use.
Installing the Compiler License
Use the License Management Facility (LMF) to install the Server Express compiler license.
Note. A 64-bit license will license both 32-bit and 64-bit Server Express products. So if you are running mixed mode environments, install the 64-bit license.
- Change directory to the Micro Focus installation
directory:
# cd /products/mf/mflmf-svrexp-5.1-wp11-64bit/
- List the items in the directory with the
ls -lcommand. Themflmcmdprogram (bold font) is used in the next step.
# ls -l
total 556
dr-xr-xr-x 2 root root 4096 Jan 21 2015 bin
-r-xr-xr-x 1 root root 364 Jan 21 2015 devas
-r-xr-xr-x 1 root root 16512 Jan 21 2015 INSTMAIN.S
dr-xr-xr-x 17 root root 4096 Jan 21 2015 lang
dr-xr-xr-x 2 root root 4096 Jan 21 2015 lib
-r-xr-xr-x 1 root root 2448 Jan 21 2015 lmfdbrecover
-r-xr-xr-x 1 root root 14228 Jan 21 2015 lmfgetpv
-r-xr-xr-x 1 root root 16351 Jan 21 2015 lmfinstall.euc
-r-xr-xr-x 1 root root 16349 Jan 21 2015 lmfinstall.sj
-r-xr-xr-x 1 root root 17487 Jan 21 2015 lmfinstall.utf8
-r-xr-xr-x 1 root root 11620 Jan 21 2015 lmf-mess
-r-xr-xr-x 1 root root 3166 Jan 21 2015 lmfnewdb.gnt
-r-xr-xr-x 1 root root 480 Jan 21 2015 LMFOPTPLATFORM
-r-xr-xr-x 1 root root 4 Dec 16 10:57 LMFVERNO
-r-xr-xr-x 1 root root 573 Jan 21 2015 mflmadm
-r-xr-xr-x 1 root root 197915 Jan 21 2015 mflm_admin
-r-xr-xr-x 1 root root 293 Jan 21 2015 mflmcmd
-r-xr-xr-x 1 root root 54027 Jan 21 2015 mflm_cmd
-rwxrwxrwx 1 root root 149 Dec 16 10:49 mflmfdb
-rwxrwxrwx 1 root root 3072 Dec 16 10:49 mflmfdb.idx
-rwxrwxrwx 1 root root 0 Dec 16 10:57 mflmfdbX
-rwxrwxrwx 1 root root 0 Dec 16 10:57 mflmfdbX.idx
-r-xr-xr-x 1 root root 0 Dec 16 10:57 MF-LMF.log
-r-xr-xr-x 1 root root 0 Dec 16 10:57 mflm-history
-r-xr-xr-x 1 root root 264 Jan 21 2015 mflmman
-r-xr--r-- 1 root root 62599 Jan 21 2015 mflm_manager
-rwxr-xr-x 1 root root 239 Dec 16 10:57 mflmrcscript
-r-xr-xr-x 1 root root 550 Dec 16 10:57 PRODFILE
-r-xr-xr-x 1 root root 12509 Jan 21 2015 README.txt
-r-xr-xr-x 1 root root 16637 Jan 21 2015 ref-as.gnt
dr-xr-xr-x 10 root root 4096 Jan 21 2015 terminfo
-r-xr-xr-x 1 root root 37970 Jan 21 2015 terminfo.txt - Run the command
sh ./mflmcmdto initially install the LMF licenses.
# sh ./mflmcmd
Micro Focus License Manager Command Line Interface
--------------------------------------------------
Select the function you require from the list:
License Install - Enter 'I'
License Uninstall - Enter 'U' - Enter the letter I to install a
license.
I
Ready to install license
Enter the Serial Number part of the License Key: - Enter your Server Express Serial
Number and License Number.
In this example, the Serial Number is PEOPLESOFT-CUSTOMER-SERIAL-NUMBER, and the License Number is 12345 ABCDE 67890 ABCDE 1234.
Ready to install license
Enter the Serial Number part of the License Key:
PEOPLESOFT-CUSTOMER-SERIAL-NUMBER
Enter the License Number part of the License Key:
12345 ABCDE 67890 ABCDE 1234
License added ok
Note that the license database cannot be moved, copied,
or restored without reloading the license keys - Change directory.
Note. $COBDIR is set to /products/mf/svrexp-5.1-wp11-64bit.cd $COBDIR/aslmf
- To verify that the license was installed, run
the command apptrack, and enter 6 spaces to remove
the access password:
# ./apptrack
You must set an access password, before proceeding
Enter 6 characters as the password
(6 spaces removes password)
******
Please re-enter the new password
******
Password removed - Select menu item 1 to list the
licenses.
Server License Administration System - AppTrack
-----------------------------------------------------------
1. License List
2. License Summary
3. License Install
4. License Uninstall
5. Change/Set Password
6. Reinitialize Licensing
7. Current Users
9. Quit
Enter the Menu Selection 1
2015/12/16 12:49:08 Server licenses: ---------------------------------------------------------- 00001 Version of Server Express 64-bit Model 1 License units: 00005 **AS Developer Usage Duration: Unlimited PEOPLESOFT-CUSTOMER-SERIAL-NUMBER 12345 ABCDE 67890 ABCD.... -------------------------------------------- 00002 Version of Server Express 64-bit Model 1 License units: 00005 **AS Developer Usage Duration: Unlimited PEOPLESOFT-CUSTOMER-SERIAL-NUMBER 12345 ABCDE 67890 ABCD.... More... (Esc to Quit) 00003 Version of Server Express 64-bit Model 1 License units: 00005 **AS Developer Usage Duration: Unlimited PEOPLESOFT-CUSTOMER-SERIAL-NUMBER 12345 ABCDE 67890 ABCD.... -------------------------------------------- 00004 Version of Server Express 64-bit Model 1 License units: 00001 **ES Developer Usage Duration: Unlimited PEOPLESOFT-CUSTOMER-SERIAL-NUMBER 12345 ABCDE 67890 ABCD.... -------------------------------------------- Continue... - Enter 2 to get a license summary.
Application Server License Administration System - AppTrack
-----------------------------------------------------------
1. License List
2. License Summary
3. License Install
4. License Uninstall
5. Change/Set Password
6. Reinitialize Licensing
7. Current Users
9. Quit
Enter the Menu Selection 2
2015/12/16 12:53:40 Summary of AS Licenses Installed, In System and In Use:
-----------------------------------------------------------------------------
Installed Sys In Use
--------- --- ------
**AS Developer Usage
5 0 0 Server Express 64-bit (Model 1)
**AS Developer Usage
5 0 0 Server Express 32/64-bit (Model 1)
**AS Developer Usage
5 0 0 Server Express 32/64-bit (Model 2)
Continue... - Enter 9 to exit AppTrack.
Application Server License Administration System - AppTrack
-----------------------------------------------------------
1. License List
2. License Summary
3. License Install
4. License Uninstall
5. Change/Set Password
6. Reinitialize Licensing
7. Current Users
9. Quit
Enter the Menu Selection 9
Note. After completing the
installation procedure described here, follow the
instructions for compiling and relinking COBOL. See
OBE Compiling PeopleSoft COBOL Programs on an Oracle
Cloud Compute Service Instance.