Page 1 of 14
COINS Upgrade to Patch 0901
This document will apply to both database AND patch upgrades to patch “0901”
Please ensure a database backup has been made prior to any works being carried out
Before you begin, the following must have been completed:
Installation of OpenEdge v10.1C
Installation of Java1.5
Installation of latest FOP
Operating System – check platform/patch dependencies below
32 Bit Platform – OE10.1C Product Availability
Platform Supported OS Edition (s)
32 Bit JVM entry level
IBM AIX AIX 5L v5.2 + maintenance update 9
(POWER PC) AIX 5L v5.3
AIX 6.1
Red Hat Enterprise Linux AS/ES/WS 4.0 (update 4)
Red Hat Enterprise Linux 5 Advanced
Red Hat Enterprise Linux 5
Linux Red Hat Enterprise Linux Desktop 5 with Workstation
(x86) SuSE Enterprise Server 9 (SuSE 9 support requires the customer to install the patch
http://support.novell.com/techcenter/psdb/ea8545892a565af183b0f83eeaeb62ad.html
SuSE Enterprise Server 10
rPATH Linux Release 1 1.5
HP-UX 11i v1 (11.11) + 12/2002 quality pack + GOLDBASE11i June 2007 + TOUR 3.1 Transport Optional Upgrade Release + PHKL_28512 POSIX_AIX JFS Patch
HP-UX (PA-RISC) HP-UX 11i v2 (11.23)
HP-UX 11i v3
Solaris Solaris 9 04/03 + kernel patch 112233-12
(SPARC) Solaris 10
UnixWare 7.1.4
SCO UnixWare
SCO OpenServer 6 (SCO OpenServer 6 certification and support: SCO OpenServer 6 certification is dependant on the platforms ability to natively support UnixWare 7.1.x applications. OpenEdge 10 support for OpenServer 6 is achieved via the UnixWare 7.1.4 OpenEdge product offering (Media ID 191). For more details regarding UnixWare and OpenServer 6 compatibility please refer to the following URL: http://www.sco.com/products/openserver6/single_cert.html)
Page 2 of 14
64 Bit Platform – OE10.1C Product Availability
Platform Supported OS Edition (s)
64 Bit JVM entry level
IBM AIX AIX 5L v5.2 + maintenance update 9
(POWER PC) AIX 5L v5.3
AIX 6.1
HP-UX Itanium2 HP-UX 11i v2 (11.23) Itanium2
(IA64) HP-UX 11i v3
Red Hat Enterprise Linux AS/ES/WS 4.0 (update 4)
Red Hat Enterprise Linux 5 Advanced
Red Hat Enterprise Linux 5
Linux Red Hat Enterprise Linux Desktop 5 with Workstation 1.5
(x86_64) SuSE Enterprise Server 9 (SuSE 9 support requires the customer to install the patch
http://support.novell.com/techcenter/psdb/ea8545892a565af183b0f83eeaeb62ad.html
SuSE Enterprise Server 10
rPATH Linux Release 1
HP-UX HP-UX 11i v1 (11.11) + 12/2002 quality pack + GOLDBASE11i June 2007 + TOUR 3.1 Transport Optional Upgrade Release + PHKL_28512 POSIX_AIX JFS Patch
(PA-RISC) HP-UX 11i v2 (11.23)
HP-UX 11i v3
Solaris Solaris 9 04/03 + kernel patch 112233-12
(SPARC) Solaris 10
This document assumes that a COINS Technical Consultant has carried out all
relevant works, and created all necessary scripts. If this is not the case, then this
work must be performed by a Progress database administrator who has experience
of writing/amending UNIX scripts.
Page 3 of 14
Version 10.17 IMPORTANT NOTICE
Please note with the release of v10.17 there are major changes to the payroll tables. If you
are using payroll we recommend you install the following fix depending on your current
version. The fix includes a test program that you can run as a check on the environment before you carry out the upgrade. The fix can be downloaded from our website.
If you are on an unsupported version of coins, please contact the comm centre:-
V1014-46982.tar
V1015-46981.tar
V1016-46980.tar
Once the fix is installed on the environment you need to run the following program from the
run command “. Prompt”. Please note that this program runs a dbanalyse – it should
therefore be run at a quiet time.
You will then receive the following screen :-
State Yes to proceed
Page 4 of 14
Once the check has completed you will receive one of the following messages – if the upgrade check is ok :-
If not
Page 5 of 14
Version 10.19 IMPORTANT NOTICE
Please note with the release of v10.19 there are major changes to the three tables
(ap_invoice, jc_costcode & pc_chgdet). If you are using these tables or are unsure if you are
using them we recommend you install the following fix depending on your current version.
The fix includes a test program that you can run as a check on the environment before you
carry out the upgrade. The fix can be downloaded from our website. If upgrade from version earlier than patch 0901 or version 10.17 please read the upgrade notices for those versions.
If you are on an unsupported version of coins, please contact the comm centre:-
10.18 – 50243, 10.17 – 50245, 10.16 – 50246 or 10.15 – 50247
Once the fix is installed on the environment you need to run the following program from the
run command “. Prompt”. Please note that this program runs a dbanalyse – it should
therefore be run at a quiet time.
You will then receive the following screen :-
State Yes to proceed
Page 6 of 14
Once the check has completed you will receive one of the following messages – if the upgrade check is ok :-
If not
If you receive the above notice please log a call in the normal way.
Page 7 of 14
Version 10.20 IMPORTANT NOTICE
Please note with the release of v10.20 there is a session parameter that requires updating.
From the Environment menu select configuration
Select Sessions
Select the Install Session
Press Enter until you get to the database connection screen as below
Press F1 to access the parameter Screen and change the –s parameter to be 80
Page 8 of 14
F1 To accept changes
F1 to return to the Environment Menu and Generate Scripts
Page 9 of 14
COINS Upgrade
If you are currently on a version of COINS prior to the 0901 patch you will need to follow the
notes below.
If you are on a patch later than 0901 the changes below for updating the Progress version to
v101c will have already been completed. You may complete the upgrade in the normal
manner.
In Coinsadmin from the main menu select
Environments
Administer an Environment
Select the Environment
Configuration
Environment Setup
Enter the appropriate progress directory path
Delete Adminserver port
F1 to accept the change
Generate Scripts
Shell out of coinsadmin „s‟
Now run the following command to update virtual system tables for v101C.
First check the following:
echo $DLC - this should return where your new version of progress has been install – eg
/u/dlc/v101c
echo $BASE – this should return the environment you are updating – eg /u/coins/cplive
Page 10 of 14
Once you are completely satisfied the above are correct, run the following command:
$DLC/bin/proutil $BASE/data/db/coins –C updatevst
Which will result as below
Type „exit‟ to take you back into coinsadmin
** CONTINUE WITH NORMAL UPGRADE PROCESS AS PER USUAL **
Page 11 of 14
Now amend the scripts under the Apache cgi-bin directory
From another unix session carry out the following :-
cd /var/www/cgi-bin
Amend the following file – for example oacplive
#!/usr/bin/sh
DLC=/u/dlc/v101c;export DLC
#DLC=/u/dlc/v101b;export DLC
PROMSGS=$DLC/promsgs;export PROMSGS
WRKDIR=/home/progress/v101c/wrk;export WRKDIR
$DLC/bin/cgiip -i oacplive
Hash the v101b line – using vi Esc i to insert
Unhash the v101c line – using vi Esc x to delete one character
Press Esc wq! to save and exit.
In Coinsadmin from the main menu select
Environments
Administer an Environment
Select the Environment
Configuration
Database
At the following screen – Press Enter to Select
And then F1 to the Database Structure screen
F1 Here to go to the database parameters
Page 12 of 14
Update the following parameter –Memcheck and change it from No to Yes
F1 to accept the change and F1 until you are back to the Setup Screen
Re-generate Scripts and then F4 back to the Environment Menu
Brokers
Start All
F4 back to the Environment Main Menu
Administer Servers and Brokers
Webspeed Administration
Select Environment – eg oacplive
Start Webspeed broker
Query Webspeed broker to ensure it has started correctly
Press F4 to exit from Coinsadmin.
The following scripts now also need amending so that they start automatically via the cronjob
add the # to the OE v101B scripts, delete the # from the OE v101c version.
Page 13 of 14
These are all held under /usr/local/bin
For example:
Version 101B Scripts
webstart_oe/webstop_oe/webquery_oe scripts – insert the hash against the environment you
have now converted using vi (Esc i to insert – Esc wq! to save and exit)
Eg – sample of webstart_oe script – cplive environment converted
DLC=/u/dlc/v101b;export DLC
#$DLC/bin/wtbman –port 20933 -i oacplive –start # hashed due to change to OE v101C
$DLC/bin/wtbman -port 20933 -i oalive -start
$DLC/bin/wtbman –port 20933 -i oalearn -start
Version 101C scripts
webstart/webstop/webquery – delete the hash from the environment you have converted
using vi (Esc x to delete one character – Esc wq! to save and exit
Eg – sample of webstart script – cplive environment converted
DLC=/u/dlc/v101c export DLC
$DLC/bin/wtbman -i oacplive -start
#$DLC/bin/wtbman -i oalive -start #remove the hash once using OE v101C
#$DLC/bin/wtbman -i oalearn –start #remove the hash once using OE v101C
Please ensure all scripts have been amended - use the table below as a tick list
Script Name Amended
webstart
webstop
webquery
webstart_oe
webstop_oe
webquery_oe
cgi-bin scripts
Once all environments have been changed across to OE v101C – please contact your
Technical Consultant to remove Version v101b of Progress and change your copy scripts
accordingly – eg cplive2col.sh
Page 14 of 14
Testing
After completion of your upgrade routine, please ensure the users test ‘day to day processing’, in
addition to the list below :-
Printing of forms
Payslips
Cheques
Subcontract certificates
Remittances
Purchase orders
Loading of Bank Statements
Visifax
ftp’ing from the coins environment (syget)
ftp’ing to the coins environment (syput)
CIM/OA Document Management
Commercials
ODBC connections
Coins Ecommerce
OA Application Adapter
GUI Applications
Valuations
Land Appraisal