EACAA Release Notes 11.0 - ELEXON€¦ · 11.1.1.6) 1.5 Summary of Changes Changes as indicated in...

EAC/AA Software Release Notes Version 1.0

© ELEXON Limited 2013 of 28

EAC/AA Software Release Notes 11.0.0

Version Number 1.0



EAC/AA Software Release Notes 11.0.0

Status : Final

Version : 1.0

Date : 27 June 2013

Prepared by : Cognizant

Approved by (Cognizant) : Project Manager



Table Of Contents

1 Introduction .................................................................................................. 4 1.1 Purpose ...................................................................................................... 4 1.2 Scope ......................................................................................................... 4 1.3 Structure of Document .............................................................................. 4 1.4 Amendment History .................................................................................. 5

1.5 Summary of Changes ................................................................................ 5 1.6 Changes Forecast ...................................................................................... 5 1.7 References ................................................................................................. 5 1.8 Abbreviations ............................................................................................ 5 1.9 Intellectual Property Rights and Copyright ............................................... 5

2 Environment ................................................................................................. 7 2.1 Build Environment .................................................................................... 7 2.2 Database Customisation ............................................................................ 7

3 Installation Procedures ................................................................................ 8 3.1 Pre-requisites ............................................................................................. 8 3.2 Database Server ......................................................................................... 8 3.3 Application Server .................................................................................... 9

4 Post-Installation Procedures ..................................................................... 26 4.1 Quick Installation Check ......................................................................... 26

5 EAC/AA Amendments in this release ...................................................... 27

6 Known defects not in this release ............................................................. 28



1 Introduction

1.1 Purpose

This document refers to Release 11.0.0 of the EAC/AA software and this

number should always be used when referring to the EAC/AA software or

related documents. There is an additional reference number associated with

this release, C11.0.0S, which relates to the Cognizant build of the software.

The Application Server software has the same version number as the

Database Server software for this release.

1.2 Scope

This is a full release that will install all of the EAC/AA server and client

files. The release has been built using the new version of the following

software components:

Software Version

Oracle Database 11.2.0.3

Oracle Pro*C pre-compiler 11.2.0.3.0

Sun Studio compiler 12 C

Oracle Fusion Middleware (used for Forms &

Reports)

11.1.1.6

Oracle WebLogic server 10.3.6

Java RTE 1.6.0.31

For detailed list of other supporting components and versions, please refer

to [OUPGAPP].

This release should only be installed onto a Sun SPARC server running the

Solaris 5.10 operating system and Oracle Database Server

Release11.2.0.3.0.

It should be noted:

that this version has not been tested on any previous version of Sun

Solaris or Oracle Database Server;

that this version was built and tested using Sun Solaris 5.10, patched

to 118833-36;

If the release is installed as an upgrade then it requires that EAC/AA release

10.0.3 (L10.0.4S) is installed. No other direct upgrade path from any other

release is supported.

1.3 Structure of Document

Section 2 deals with the environment used to build the software and any

customisations of the application that are not allowed.

Section 3 addresses any installation issues for this version of the application.

Full installation details are provided in the EAC/AA Installation Guide.

Section 4 identifies any post installation actions that need to be undertaken.



Section 5 lists the changes in this release and any subsequent patches since

the last full release of the application.

Section 6 highlights any known defects that are not fixed in this release.

1.4 Amendment History

Version Date Details

1.0 27/06/2013 CP1383 - Updated for Tech Upgrade

(Oracle DB upgrade from 10.2.0.3 to

11.2.0.3 and OAS upgrade from 10.1.2.2 to

11.1.1.6)

1.5 Summary of Changes

Changes as indicated in the amendment history.

1.6 Changes Forecast

None.

1.7 References

Mnemonic Information Details

[EINGDE] Title:

Version No:

Author:

Date:

EAC/AA Installation Guide

17.0

Cognizant

27 June 2013

[EOPSGDE] Title:

Version No:

Author:

Date:

EAC/AA Operations Guide

18.0

Cognizant

27 June 2013

[ESMGDE] Title:

Version No:

Author:

Date:

EAC/AA System Management Guide

17.0

Cognizant

27 June 2013

[OUPGAPP] Title:

Version No:

Author:

Date:

Oracle Upgrade approach document

1.1

Cognizant

27 June 2013

1.8 Abbreviations

EAC/AA Estimation of Annual Consumption / Annualised Advance

BSC Balancing and Settlements Code

1.9 Intellectual Property Rights and Copyright

The copyright and other intellectual property rights in this document are vested in

ELEXON. These materials are made available to participants in the GB electricity

industry to review and copy for the sole purpose of their participation in the

electricity industry. All other commercial use is prohibited including downloading,

copying, distributing, modifying, transmitting, publishing, selling or creating

derivative works (in whatever format) from this document or in other cases use for

personal academic or other non-commercial purposes. All copyright and other

proprietary notices contained in the document must be retained on any copy you

make.



All other rights of the copyright owner not expressly dealt with above are reserved.

No representation, warranty or guarantee is made that the information in this

document is accurate or complete. While care is taken in the collection and

provision of this information, ELEXON Limited shall not be liable for any errors,

omissions, misstatements or mistakes in any information or damages resulting from

the use of this information or action taken in reliance on it.



2 Environment

2.1 Build Environment

The database server software was built on the following environment:

Sun Solaris 5.10 for SPARC chip-set, patched to 118833-36

Oracle 11g Server Release 11.2.0.3.0

Pro*C/C++: Release 11.2.0.3

Sun Studio 12 C Compiler, patched to 124867-01

The Windows application server software was built on the following

environment:

Microsoft Windows 2003 with Service Pack 2

Oracle Application Server 11g (11.1.1.6.0) - Forms & Reports

Services Standalone edition, plus the patches listed in [EINGDE]

Appendix G.

The Sun Solaris application server software was built on the following

environment:

Sun Solaris 5.10 for SPARC chip-set

Oracle Application Server 11g (11.1.1.6.0) - Forms & Reports

Services Standalone edition, plus the patches listed in [EINGDE]

Appendix G.

2.2 Database Customisation

Please note that both the database indexes and constraints are considered to

be part of the software and, as such, should not be customised, or have their

location within the database amended.

If you do amend these items, you may be required to satisfy the

Certification Agent that there are no functional implications for the

application.

If customisation has been applied to your current level of code, we suggest

you reverse the changes prior to installing this new release.

The tables used by this application are all stored under a single schema

within the Oracle database. Whilst it is possible to create additional tables

for analysis of the data, there is no guarantee that the installation or upgrade

script will be able to successfully cope with these tables. If additional tables

are required it is recommended that they are placed within a separate

schema within the database.



3 Installation Procedures

The release affects the database server software and application server

software. The set of software can be downloaded from ELEXON portal. The

Sun Solaris application server software is delivered in the same bundle as

the database server software; the Windows application server in a separate

bundle. For full details on how to install or upgrade the application please

refer to [EINGDE].

3.1 Pre-requisites

3.1.1 New Instance

If the release is installed as a new instance then it is strongly recommended

that it is installed onto a Sun SPARC server running the Solaris 5.10

operating system and Oracle Server Release11.2.0.3.0.

3.1.2 Upgrade from an existing Installation (EAC/AA10.0.3)

If it is installed onto an existing EAC/AA instance then:

release 10.0.3 must already have been installed.

all objects within the database need to be valid.

3.2 Database Server

3.2.1 New Instance

Refer to [EINGDE].

3.2.2 Upgrade from an Existing Instance (EAC/AA10.0.3)

3.2.2.1 Install the new version of the software.

Before installing the new version of EAC/AA software, below steps should

be carried out.

Ensure that all users has exited from EAC/AA online (Front end)

Connect to UNIX as the EAC/AA batch user.

Stop all the daemons

Take a backup of the runtime directory

Rename the runtime directory. For example, if the current runtime

directory is EACAA_10_0_0, then rename it as EACAA_11_0_0.

Here after, the renamed runtime directory EACAA_11_0_0 will be

referred as runtime directory.

Copy eacaa_setup_solaris_11_0_0.gz from ELEXON portal to

HOME directory of the Solaris server. (Use the FTP tool WinSCP3to

copy the software from Windows to Solaris)

Extract the file eacaa_setup_solaris_11_0_0.gz using gunzip

command.

Change the mode of the executable using the below command.

chmod a+x eacaa_setup_solaris_11_0_0

Run the executable eacaa_setup_solaris_11_0_0.



Reset the runtime directory, Oracle home directory and Oracle

instance as necessary when prompted.

3.2.2.2 Database Application Upgrade

Having copied the database onto Sun Solaris, this section describes the

steps required to upgrade the EAC/AA database to the new version. In

order for the database to be updated, the following will need to be carried

out:

Log on as the EAC/AA Owner UNIX user.

Login to the database using the command sqlplus

<username/password@DBname>. The user should have the DDL

access to the table edb_ref_values.

Execute the below queries:

update edb_ref_values set value_to = '11.0.0 (C11.0.0S)' where

domain_code = 'SYS' and value_from = 'VERS';

update edb_system_configuration set

eacaa_root_dir='<<EACAA_ROOT>>'

commit;

Execute the below query to ensure that all database objects are

valid.

select * from dba_objects where status <> 'VALID';

3.3 Application Server

Instructions are provided in this section:

1) Upgrading the EAC/AA software on an existing Oracle Application

Server on Sun Solaris.

2) Upgrading the EAC/AA software on an existing Oracle Application

Server on Microsoft Windows.

3.3.1 Oracle Application Server on Solaris

This section describes how to adapt the instructions given in [EINGDE]

section 2.3.3 for an upgrade (i.e. version 10.0.0 of the EAC/AA Oracle

Application Server is installed already).

EACAA Directory:

The instructions in the table below are for creating the EACAA directory,

and copying all the files from the $EACAA_HOME/unix_web_forms

directory to a new directory named EACAA. Note that it is possible to

leave the files in the location where they are delivered – in which case, omit

the instructions in this table and then the directory referred to as

/oradata/sva/EACAA in subsequent sections is the

$EACAA_HOME/unix_web_forms/EACAA directory. Ensure that the

oracle user has read and execute permissions on the files under this

directory.

The Help files should be treated like Forms, Library, Menus and icons files.



Files/Directories Description

EACAA Create /oradata/sva/EACAA directory on the unix

server where Oracle Application Server is installed (or

you may choose another directory name but the

instructions assume the directory is named

/oradata/sva/EACAA).

forms Copy the EACAA/forms directory from

$EACAA_HOME/unix_web_forms to

/oradata/sva/EACAA directory.

library Copy the EACAA/library directory from



icons Copy the EACAA/icons directory from



menu Copy the EACAA/menu directory from



help Copy the EACAA/hHelp directory from



EACAA Env Directory:

The location of the environment files are totally different between 10g and

11g. Instructions for copying the EACAA_ENV directory files from

$EACAA_HOME/unix_web_forms to beneath the $ORACLE_HOME

directory, where $ORACLE_HOME is the Oracle Home directory where

Oracle Application Server is installed. This section cannot be omitted.

In the below example, the directory structure has the below notations.

<MW_HOME> denotes the Middleware Home directory. For

example: /app/oracle/Middleware11gR1

<DOMAIN_NAME> denotes the domain name created during the

OFM configuration. For example: ELXON

<ORACLE_INSTANCE> denotes the Oracle instance directory of

the OAS. For example: /app/oracle/Middleware11gR1/asinst_1


Eacaa.env Copy the EACAA_ENV\eacaa.env file from

$EACAA_HOME/unix_web_forms to the

<MW_HOME>/user_projects/domains/<DOMAIN_NAME>/

config/fmwconfig/servers/WLS_FORMS/applications/formsa

pp_11.1.1/config directory on the application server. If

multiple environments are required for different test systems,




create multiple copies of this file e.g. named eacaa1.env,

eacaa2.env.

eacaaRegistry.dat Copy the EACAA_ENV\eacaaRegistry.dat file from


<MW_HOME>/user_projects/domains/<DOMAIN_NAME>/

config/fmwconfig/servers/WLS_FORMS/applications/formsa

pp_11.1.1/config/forms/registry/oracle/forms/registry

directory

formsweb.cfg Set the ORACLE_HOME variable to point to the OAS

home directory.

If the formsweb.cfg file does not exist in the

<MW_HOME>/user_projects/domains/<DOMAIN_NAM

E>/config/fmwconfig/servers/WLS_FORMS/applications/

formsapp_11.1.1/config directory:

Copy the EACAA_ENV\formsweb.cfg file from


$ORACLE_HOME/user_projects/domains/<DOMAIN_N

AME>/config/fmwconfig/servers/WLS_FORMS/applicati

ons/formsapp_11.1.1/config directory on the application

server.

If the formsweb.cfg file exists in the

<MW_HOME>/user_projects/domains/<DOMAIN_NAM

E>/config/fmwconfig/servers/WLS_FORMS/applications/

formsapp_11.1.1/config directory, add the lines below to

the end of that file.

[eacaa]

lookandfeel=Generic

colorScheme=Gray

background=eacaa

envFile=eacaa.env

form=eacaa.fmx

width=840

height=652

separateFrame=TRUE

ImageBase=codeBase

serverApp=eacaaRegistry

(omit the separateFrame=TRUE line if you do want the

forms application to run on a separate browser window)

If multiple environments are required, create multiple

sections containing these lines, named e.g. [eacaa1]

[eacaa2] etc – one for each .env file and change the

respective .env file name assigned in the parameter

envFile given above.

forms.conf If the forms.conf file does not exist in the




<ORACLE_INSTANCE>/config/OHS/ohs1/moduleconf

directory:

Copy the EACAA_ENV\forms.conf file from



directory on the application server.

If the forms.conf file exists in the


add the lines below to the end of that file.

# BEGIN EACAA CONFIG

RewriteRule ^/forms/eacaa_help/(..*) /eacaa_help/$1 [PT]

AliasMatch ^/eacaa_help/(..*) "/oradata/sva/EACAA/help/$1"

WLExcludePathOrMimeType /forms/eacaa_help

RewriteRule ^/forms/eacaa_reports/(..*) /eacaa_reports/$1 [PT]

AliasMatch ^/eacaa_reports/(..*) "/oradata/sva/EACAA/reports/$1"

WLExcludePathOrMimeType /forms/eacaa_reports

# END EACAA CONFIG

If multiple environments are configured, these lines

should be updated by suffixing the environment number

as given below.

# BEGIN EACAA1 CONFIG

RewriteRule ^/forms/eacaa1_help/(..*) /eacaa1_help/$1 [PT]

AliasMatch ^/eacaa1_help/(..*) "/oradata/sva/EACAA1/help/$1"

WLExcludePathOrMimeType /forms/eacaa1_help

RewriteRule ^/forms/eacaa1_reports/(..*) /eacaa1_reports/$1 [PT]

AliasMatch ^/eacaa1_reports/(..*) "/oradata/sva/EACAA1/reports/$1"

WLExcludePathOrMimeType /forms/eacaa1_reports

# END EACAA1 CONFIG

plan.xml This file can be found under the directory

<DOMAIN_HOME>/deploymentplans/formsapp/11.1.1

This file maps the relative path given in the files

forms.conf and eacaa.env.

Under <variable-definition> add below entry: In the below entry, ensure that

the <value> tag is mapped to the directory where EACAA directory is

created.

<variable>

<name>vd-/oradata/sva</name>

<value>/oradata/sva</value>

</variable>

Under <module-descriptor external="false"> add below entry: In the below

entry, ensure that the url-pattern is set to the directory where the help and

reports directories were created.

<variable-assignment>





<xpath>/weblogic-web-app/virtual-directory-mapping/[url-

pattern="EACAA/reports/*"]/local-path</xpath>

</variable-assignment>




pattern="EACAA/help/*"]/local-path</xpath>


Note: The above changes are mapping the reports and help

directories correctly. The value given in the <value> tag and

url-pattern should form the help and reports directories.

svaicons Directory:

Instructions for creating the svaicons directory and copy .gif files:


svaicons Create the directory svaicons in the $ORACLE_

HOME/forms/java directory

eacaa.gif Copy the EACAA\Icons\eacaa.gif file from

$EACAA_HOME/unix_web_forms\Icons to the

$ORACLE_HOME/forms/java directory

Icons Copy all the files (including eacaa.gif) from the

EACAA/Icons directory to the

$ORACLE_HOME/forms/java/svaicons directory.

fmrweb.res File:

Instructions for maintaining the key mappings the same as forms 6i.


fmrweb.res Rename the

<$ORACLE_INSTANCE>/config/FormsComponent/forms/admin/resource/US/fmrweb.res file

to

<$ORACLE_INSTANCE>/config/FormsComponent/forms/admin/resource/US/fmrweb_orig.res,

and then copy

<$ORACLE_INSTANCE>/config/FormsComponent/forms/admin/resource/US/fmrpcweb.res to

<$ORACLE_INSTANCE>/config/FormsComponent/forms/admin/resource/US/fmrweb.res.



forms.conf File:

Instructions for customising the contents of file <forms.conf>.

Keyword Description

/forms/html/ Change the default directory

/app/oracle/Middleware/asinst_1/ to the correct

Oracle instance Directory of OAS.

/forms/eacaa_reports Change the default directory

“/oradata/sva/EACAA/reports” to specify the

location of EAC/AA report files.

/forms/eacaa_help Change the default directory “/oradata/sva/

EACAA/help“ to specify the location of EAC/AA

help files.

WebLogicHost Change the default Web logic Host

CTSINTBMVELX3.cts.com to specify the host

where the web logic server is hosted.

WebLogicPort Change the default web logic post number 9007 to

the correct web logic port number which would

have been chosen during the OFM installation.

EAC/AA Reports Directory:

Instructions for creating the reports directory, which is used to store EAC/AA

report files generated from the EAC/AA application.


reports Create the reports folder as specified in the

/forms/eacaa_reports alias in the forms.conf file to

store the reports generated from the application.

Ensure that the oracle user can write to this

directory. If different folders are required for

different environments, create EACAA directory

with the same names as the environments.

e.g.EACAA1, EACAA2 etc

formsweb.cfg File:

Instructions for customising the contents of file <formsweb.cfg>

Keyword Description

Global Change Replace all occurrences of

D:\oracle\Middleware11gR1\Forms11g

with the correct Oracle Home if exists



eacaa.env File:

Instructions for customising the contents of file <eacaa.env>. If there are

multiple environments, then each may be customised with different values.

Keyword Description

ORACLE_HOME Change the default directory

/app/oracle/Middleware/Forms11g to reflect the

correct oracle home of OAS.

ORACLE_INSTANCE Change the default directory

/app/oracle/Middleware/asinst_1 to reflect the


TNS_ADMIN Change the default directory

/app/oracle/Middleware/asinst_1/config to

reflect the correct TNS admin directory of OAS.

FORMS_PATH Change the default directory



Also if the EACAA folder was not created

under /oradata/sva or not named EACAA then

replace all occurrences of /oradata/sva/EACAA

with the directory where the EACAA directory

was created.

CLASSPATH Change all the occurrence of the default

directory /app/oracle/Middleware/Forms11g to

reflect the correct oracle home of OAS.

PATH Change the default directory




under /oradata/sva or not name EACAA then



was created.

LD_LIBRARY_PATH Change the default directory



Change the default directory

/tmp/OraInstall2006-12-05_09-28-

55AM/jre/1.4.2/ to reflect the correct jre home.


under /oradata/sva or not name EACAA then



was created.

FORMS_RESTRICT_ENTE By default this parameter is set to TRUE. When



Keyword Description

R_QUERY it is set to TRUE, Oracle Forms limits the types

of query criteria that can be entered when in

Enter-Query mode. In general, it disallows the

use of:

conjunctions (AND, OR)

keywords which modify parts of the

SELECT statement outside of the

WHERE clause (ORDER BY),

All functions, including SQL functions

(LENGTH, TO_CHAR, LPAD,

SUBSTR).

Also, the Query/Where window is unavailable

when set to TRUE.

If the users need the freedom to enter these

types of criteria, add a line to the eacaa.env file,

setting the parameter to FALSE.

EP98EREPPATH This should not be changed from

/forms/eacaa_reports/ which is an alias defined

in the forms.conf file. If multiple environments

are configured, then then it should be updated

by suffixing the environment number (as

defined in the forms.conf) e.g.,

/forms/eacaa1_reports/

EP98ETEMP Change to specify the reports path. It must

match the /forms/eacaa_reports alias match

entry in the forms.conf file e.g..

/oradata/sva/EACAA/reports If

EP98EREPPATH is defined for multiple

environments, then it should be changed to to

match with the alias entry in the forms.conf file.

e.g. /oradata/sva/EACAA1/reports.

EP98EHELP Change to specify the help files path. It must

match the /forms/eacaa_help alias match entry

in the forms.conf file.

host_address Change the host_address entry to reflect the

Host address of OAS.

EP98EFILEEXT Change the default value .eac to specify the

extension to be used for EAC/AA Reports.

(The advantage of using an extension such as

.eac which is unique to EACAA is that there is

complete freedom to configure how this

extension is opened on the clients.)



Keyword Description

EP98EPORTPRTEXT Change the default value .por to specify the

extension to be used for EAC/AA Reports

which are printed portrait. (The advantage of

using an extension such as .por which is unique

to EAC/AA is that there is complete freedom to

configure how this extension is opened on the

clients.)

EP98ELANDPRTEXT Change the default value .lnd to specify the


which are printed landscape. (The advantage of

using an extension such as .lnd which is unique



clients.)

EP98PRINTW Do not change the default value of 132 – this is

used to control whether reports are printed

portrait or landscape.

EP98EVERS Do not change this line.

N.B. Restart Oracle Application Server after modifying all configuration files.

3.3.2 Oracle Application Server on Windows

This section describes how to adapt the instructions given in [EINGDE]

section 2.3.2 for an upgrade (i.e. version 10.0.0 of the EAC/AA Oracle

Application Server is installed already).

EACAA Directory:

The instructions in the table below are for creating the EACAA directory,

and copying all the files from the EACAA directory to a new directory

named EACAA.


EACAA Create the EACAA directory in the root directory

of the drive where Oracle Application Server is

installed (or you may choose another directory

name but the instructions assume the directory is

named EACAA).

For example, if the OAS is installed in D drive, the

EACAA directory should be created under the D

drive like D:\EACAA

Forms Copy the EACAA\Forms directory with its

contents from the directory CD to the EACAA

directory.

Library Copy the EACAA\Library directory with its

contents from the directory CD to the EACAA




directory.

Icons Copy the EACAA\Icons directory with its contents

from the directory CD to the EACAA directory.

Menu Copy the EACAA\Menu directory with its contents


Help Copy the EACAA\Help directory with its contents


EACAA Env Directory:

Instructions for copying the EACAA ENV directory files from the directory

CD to beneath the <ORACLE_HOME> directory, where

<ORACLE_HOME> represents the Oracle Home directory where Oracle

Application Server is installed:

In the below example, the directory structure has the below notations.

<MW_HOME> denotes the Middleware Home directory. For

example: D:\oracle\Middleware11gR1

<DOMAIN_NAME> denotes the domain name created during the

OFM configuration. For example: ELXON

<ORACLE_INSTANCE> denotes the Oracle instance directory of

the OAS. For example: D:\oracle\Middleware11gR1\asinst_1


eacaa.env Copy the EACAA ENV\eacaa.env file from the

directory CD to the

<MW_HOME>\user_projects\domains\<DOMAIN_N

AME>\config\fmwconfig\servers\WLS_FORMS\appli

cations\formsapp_11.1.1\config directory on the

application server. If multiple environments are

required for different test systems, create multiple

copies of this file e.g. named eacaa1.env, eacaa2.env

eacaaRegistry.dat Copy the EACAA ENV\eacaaRegistry.dat file from

the directory CD to the

<MW_HOME>\user_projects\domains\<DOMAIN_N

AME>\config\fmwconfig\servers\WLS_FORMS\appli

cations\formsapp_11.1.1\config\forms\registry\oracle\f

orms\registry directory




formsweb.cfg If the formsweb.cfg file does not exist in the

<MW_HOME>\user_projects\domains\<DOMAI

N_NAME>\config\fmwconfig\servers\WLS_FOR

MS\applications\formsapp_11.1.1\config

directory:

Copy the EACAA ENV\formsweb.cfg file from

the directory CD to the



MS\applications\formsapp_11.1.1\config directory

on the application server.

If the formsweb.cfg file exists in the



MS\applications\formsapp_11.1.1\config

directory, add the lines below to the end of that

file.

[eacaa]

lookandfeel=Generic

colorScheme=Gray

background=eacaa

envFile=eacaa.env

form=eacaa.fmx

width=840

height=652

separateFrame=TRUE

ImageBase=codeBase

serverApp=eacaaRegistry

(omit the separateFrame=TRUE line if you do

want the forms application to run on a separate

browser window)

If multiple environments are required, create

multiple sections containing these lines, named

e.g. [eacaa1] [eacaa2] etc – one for each .env file

and change the respective .env file name assigned

in the parameter envFile given above.

forms.conf If the forms.conf file does not exist in the

<ORACLE_INSTANCE>\config\OHS\ohs1\modu

leconf directory:

Copy the EACAA ENV\forms.conf file from the

directory CD to the


leconf directory on the application server.

If the forms.conf file exists in the





leconf directory, add the lines below to the end of

that file.

# BEGIN EACAA CONFIG

RewriteRule ^/forms/eacaa_help/(..*) /eacaa_help/$1 [PT]

AliasMatch ^/eacaa_help/(..*) "D:\eacaa\Help\$1"

WLExcludePathOrMimeType /forms/eacaa_help

RewriteRule ^/forms/eacaa_reports/(..*) /eacaa_reports/$1 [PT]

AliasMatch ^/eacaa_reports/(..*) "D:\eacaa\Reports\$1"

WLExcludePathOrMimeType /forms/eacaa_reports

# END EACAA CONFIG

If multiple environments are configured, these

lines should be updated by suffixing the

environment number as given below.

# BEGIN EACAA1 CONFIG

RewriteRule ^/forms/eacaa1_help/(..*) /eacaa1_help/$1 [PT]

AliasMatch ^/eacaa1_help/(..*) "D:\eacaa1\Help\$1"

WLExcludePathOrMimeType /forms/eacaa1_help

RewriteRule ^/forms/eacaa1_reports/(..*) /eacaa1_reports/$1 [PT]

AliasMatch ^/eacaa1_reports/(..*) "D:\eacaa1\Reports\$1"

WLExcludePathOrMimeType /forms/eacaa1_reports

# END EACAA1 CONFIG

plan.xml This file can be found under the directory

<DOMAIN_HOME>\deploymentplans\formsapp\

11.1.1

This file maps the relative path given in the files

forms.conf and eacaa.env

Under <variable-definition> add below entry: In the below entry,

ensure that the <value> tag is mapped to the directory where

EACAA directory is created.

<variable>

<name>vd-d:\</name>

<value>d:\</value>

</variable>

Under <module-descriptor external="false"> add below entry: In the

below entry, ensure that the url-pattern is set to the directory where

the help and reports directories were created.


<name>vd-d:\</name>


pattern="eacaa/reports/*"]/local-path</xpath>



<name>vd-d:\</name>


pattern="eacaa/help/*"]/local-path</xpath>


Note: The above changes are mapping the reports and




help directories correctly. The value given in the

<value> tag and url-pattern should form the help and

reports directories.



svaicons Directory:

Instructions for creating the svaicons directory and copy .gif files:


Svaicons

Create the directory svaicons in the <ORACLE_

HOME>\forms\java directory.

eacaa.gif Copy the EACAA\Icons\eacaa.gif file to the

<ORACLE_HOME>\forms\java directory

Icons Copy all the files (including eacaa.gif) from the

EACAA/Icons directory to the

<ORACLE_HOME>\forms\java\svaicons

directory.

fmrweb.res File:

Instructions for maintaining the key mappings same as forms 6i:

fmrweb.res Rename the

<ORACLE_INSTANCE>\config\FormsComponent\forms\fmrweb.res file to

<ORACLE_INSTANCE>\config\FormsComponent\forms\fmrweb_orig.res, and

then copy <ORACLE_INSTANCE>\config\FormsComponent\forms\fmrpcweb.res

to <ORACLE_INSTANCE>\config\FormsComponent\forms\fmrweb.res.

forms.conf File:

Instructions for customising the contents of file <forms.conf >.

Keyword Description

/forms/html/ Change the default directory

D:\oracle\Middleware11gR1\asinst_1 to reflect

the correct oracle home of OAS.

/forms/eacaa_help Change the default directory D:\eacaa\Help to

specify the correct location of EAC/AA help

files.

/forms/eacaa_reports Change the default directory D:\eacaa\Reports to

specify the location where EAC/AA report files

are stored.

WebLogicHost Change the default Web logic Host

CTSINTBMVELX3.cts.com to specify the host

where the web logic server is hosted.

WebLogicPort Change the default web logic post number 9007

to the correct web logic port number which



would have been chosen during the OFM

installation.

EAC/AA Reports Directory:

Instructions for creating the reports directory which is used to store

EAC/AA report files, generated from the EAC/AA application.


reports Create the reports folder as specified in the

/forms/eacaa_reports alias in the forms.conf file to

store the reports generated from the application. If

different folders are required for different

environments, create sub-folders e.g. with the same

names as the environments, eacaa1, eacaa2 etc

formsweb.cfg File:

Instructions for customising the contents of file <formsweb.cfg>.

Keyword Description

Global Change Replace all occurrences of

D:\oracle\Middleware11gR1\Forms11g

with the correct Oracle Home if exists.

eacaa.env File:

Instructions for customising the contents of file <eacaa.env>. If there are

multiple environments, then each may be customised with different values.

Keyword Description

ORACLE_HOME Change the default directory

D:\oracle\Middleware11gR1\Forms11g to


ORACLE_INSTANC

E



the correct oracle instance of OAS.

FORMS_PATH Change the default directory

D:\oracle\Middleware11gR1\Forms11g\ to




the correct oracle instance of OAS.

Also if the EACAA folder was not created on

D: or it was given a different name, then

replace all the occurrences of D:\EACAA with

the folder where the EACAA folder was

created.



Keyword Description

CLASSPATH Change the default directory



PATH Change the default directory



Also if the EACAA folder was not created on

D: or it was given a different name, then replace

all the occurrences of D:\EACAA with the

folder where the EACAA folder was created.

FORMS Change the default directory

D:\oracle\Middleware11gR1\Forms11g\ to


FORMS_RESTRICT

_ENTER_QUERY

By default this parameter is set to TRUE.

When it is set to TRUE, Oracle Forms limits the

types of query criteria that can be entered when

in Enter-Query mode. In general, it disallows

the use of:

conjunctions (AND, OR)

keywords which modify parts of the

SELECT statement outside of the

WHERE clause (ORDER BY),

All functions, including SQL functions

(LENGTH, TO_CHAR, LPAD,

SUBSTR).

Also, the Query/Where window is unavailable

when set to TRUE.

If the users need the freedom to enter these

types of criteria, add a line to the eacaa.env file,

setting the parameter to FALSE.

EP98EREPPATH This should not be changed from

/forms/eacaa_reports/ which is an alias defined

in the forms.conf file. if multiple

environments are configured, it should be

updated by suffixing the environment number

(as defined in the forms.conf file) e.g.,

/forms/eacaa1_reports/

EP98ETEMP Change to specify the reports path. It must

match the /forms/eacaa_reports alias match

entry in the forms.conf file, e.g.

D:\eacaa\Reports. If EP98EREPPATH is

defined for multiple environment, then the same

sub-folder name must be added to this variable



Keyword Description

as given in the forms.conf file , e.g..

D:\eacaa1\Reports

EP98EHELP Change to specify the help files path. It must

match the /forms/eacaa_help alias match entry

in the forms.conf file.

host_address Change the host_address entry to reflect the

Host address of OAS.

EP98EFILEEXT Change the default value .eac to specify the

extension to be used for displaying EAC/AA

Reports. (The advantage of using an extension

such as .eac which is unique to EAC/AA is that

there is complete freedom to configure how this

extension is opened on the clients.)

EP98EPORTPRTEX

T

Change the default value .por to specify the


which are printed portrait. (The advantage of

using an extension such as .por which is unique



clients.)

EP98ELANDPRTEX

T

Change the default value .lnd to specify the


which are printed landscape. (The advantage of

using an extension such as .lnd which is unique



clients.)

EP98PRINTW Do not change the default value of 132 – this is

used to control whether reports are printed

portrait or landscape.

EP98EVERS Do not change this line.

N.B. Restart Oracle Application Server after modifying all configuration files.



4 Post-Installation Procedures

4.1 Quick Installation Check

Start up the EAC/AA front-end and select the Help About menu option.

The dialogue box should contain the version numbers shown here:



5 EAC/AA Amendments in this release

None



6 Known defects not in this release

Please note the following behaviour of this release of the system. These

observations are not classified as defects; however we are in the process of

resolving the observation.

ELEXON

Reference

Description

NA In EACAA application, the report “DMA Calculation

Exceptions” can be displayed by clicking the Display

button and the Print button. We observed on one

occasion that the report did not open correctly after

clicking the print button. If this happens, restarting the

web logic server will resolve the issue.

EACAA Release Notes 11.0 - ELEXON€¦ · 11.1.1.6) 1.5 Summary of Changes Changes as indicated in...

Documents

Transcript of EACAA Release Notes 11.0 - ELEXON€¦ · 11.1.1.6) 1.5 Summary of Changes Changes as indicated in...