coins upgrade to patch 0901€¦ · coins upgrade to patch 0901 this document will apply to both...

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)


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


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.


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

of 14

Once the check has completed you will receive one of the following messages – if the upgrade check is ok :-

If not

of 14


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

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.

of 14


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

of 14

F1 To accept changes

F1 to return to the Environment Menu and Generate Scripts

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

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 **

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

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.

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

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

coins upgrade to patch 0901€¦ · coins upgrade to patch 0901 this document will apply to both...

Documents