swift configurator installation-manual

SwiftConfigurator ndash Installation Manual

Installation Manual

This document explains how to install SWIFTCONFIGURATOR 1) Installation requirements 2

Operating system minimum requirements 2 Database version 2 Application server version 2 Web browser version 2 Oracle Applications version 2

2) Oracle 11g Database Server Post-Installation Configuration 3 3) Application Server Post-Installation Configuration 6

Application Deployment 11 Getting started 19 Additional setups 20 4) Appendix A ndash Special Instructions for AS10gR2 on RHEL5 22

Applies to 22 What is being announced 22 What do you need to do 23

Follow Operating System Requirements for OEL 5x or RHEL 5x 23 Follow Installation Requirements for OEL 5x or RHEL 5x 25 Known Issues 26

1


1) Installation requirements

Operating system minimum requirements bull Pentium 4 24 GHz or equivalent bull You need to install the following Operating system

Red Hat Enterprise Linux ES 5x bull A minimum of 1GB of memory (RAM) for SwiftConfigurator application

Note you need a minimum of 2 GB (RAM) if the application and database server are installed on the same machine

bull A minimum of 3GB of hard disk space for SwiftConfigurator core tables data bull httpwwwredhatcom

Database version Oracle Database 11g (v11106 or above) (character set UTF-8) httpwwworaclecomtechnologysoftwareproductsdatabaseindexhtml

Application server version Oracle Application Server 10g Release 2 Patch Set 3 (10123) Download available here

httpwwworaclecomtechnologysoftwareproductsiashtdocs101202htmlSee special installation instructions in appendix A of this document

Web browser version SwiftConfigurator is compatible with the following browsers

o Internet Explorer 6028001106 o Mozilla Firefox v20x

Oracle Applications version SwiftConfigurator can build instances for Oracle Applications version 11510 and 120x

2


2) Oracle 11g Database Server Post-Installation Configuration Once Oracle 11g Database Server installation is complete please perform the following steps

1 Ensure that the PATH variable for the database user account includes the bin directory from DB 11g ltinstall prefixgtoracleproduct1020db_1bin

2 Ensure that ORACLE_HOME is properly set and exported eg a export ORACLE_HOME=erpphomesoraerpporacleproduct1020db_1

3 Copy all content of the folder softwareswiftconfigurator_db_scripts to any local folder Login as Database Admin User and make sure it has write permission to the folder

4 Change the current directory to swiftconfigurator_db_scripts 5 As per the README instructions execute startsh to create the swiftconfigurator database

Important you must first to specify the path for the datafile in the startsh (DATA_FILE_PATH=homeoradb10goracleoradataorcl) and the DB user name password

bull Oracle Enterprise Manager 11g Database Control must be installed and running

(httphostdomaincom1158em) See screenshot below

3


1 Navigate to the ldquoAdministrationrdquo ldquoAll Initialization Parametersrdquo

4


2 Select ldquoCursors and Library Cacherdquo then click ldquoGOrdquo then update the field ldquoopen_cursorsrdquo from

the default value 300 to 1000 then click ldquoApplyrdquo Repeat the same steps for the Panel ldquoSP filerdquo See screenshot below for directions

5


3) Application Server Post-Installation Configuration

The following configurations steps are necessary prior using the application

bull The Application server 10g Enterprise manager console should be installed and running o httphostnamedomaincom1810emd o Login as ias_admin and put password specified earlier during installation

bull OC4J configuration o Open the enterprise manager console o Click the ldquoHOMErdquo link

6


7


7


o Navigate to the ldquoAdministrationrdquo panel

8


o Navigate to the ldquoServer Propertiesrdquo panel

9


o Scroll down to the field ldquoJAVA OPTIONSrdquo and replace the content by the following line

-server -Xmx1024m -Xms1024m -Djavalibrarypath=$ORACLE_HOMElib -Djavasecuritypolicy=$ORACLE_HOMEj2eehomeconfigjava2policy -Djavaawtheadless=true

Then Restart the OC4J instance click on ldquoApplyrdquo

Copy the following folder softwareswiftconfigurator_config from the CD to the root of the J2EE container (OC4J) on the application server

Ex homeoraas10gproduct1012OracleASj2eehome then change the following property in the file configurationproperties to the path of your datafile folder DBF_FOLDER=homeoradb10goracleoradataorcl

10


Application Deployment Following are the steps to deploy the application into the Oracle Application server 1 Login into Enterprise Manager console and navigate to ldquoHomerdquo then ldquoApplicationsrdquo

11


2 Click on ldquoDeploy EAR filerdquo

12


3 Select the ear file located under Software and enter the application name ldquoswiftconfiguratorrdquo

Then click ldquoContinuerdquo

13


4 Click on ldquoFinishrdquo At that point SwiftConfigurator will be deployed after a couple of minutes

14


5 Modify Datasources parameters

Navigate to ldquoHomerdquo then click on ldquoAdministrationrdquo

15


6 Click on ldquodata sourcesrdquo

16


Click on ldquoCreaterdquo

Enter the following parameters ========================

Name swiftconfigurator Data Source Class comevermindsqlDriverManagerDataSource JDBC URL jdbcoraclethinssrscqa01erapidsuitecom1521ORCL (you need to change the red part by your own host AS10g) JDBC Driver oraclejdbcdriverOracleDriver Username rapidbuild Use Cleartext Password rapidbuild Location jdbcswiftconfiguratorDS Transactional(XA) Location jdbcxaswiftconfiguratorXADS EJB Location jdbcswiftconfiguratorDS

17


When finished click on ldquoCreaterdquo (the SwiftConfigurator application will be automatically redeployed

when the AS10g will be restarted)

18


Getting started Once all the above steps are completed you can access SwiftConfigurator web application login page at the following URL (after substituting the application_server_host_name and port number fields by the ones your administrator provided you) httpapplication_server_host_nameport_numberapplication_nameloginjsp (ex httprxprd02erapidsuitecom7777swiftconfiguratorloginjsp ) default port number 7777 default application name swiftconfigurator Here is the page you should see

Login with the user name password provided by your Administrator and enjoy SwiftConfigurator Example

User name admin Password admin 19


Additional setups bull Windows Language settings need to be configured At the regional Setting level select the languages that

you need support for (ex Chinese Taiwan Japanese or Korean) otherwise the browser running SwiftConfigurator will not be able to display the languages See screenshot for help

bull In case that you encounter an issue with the ldquoOPMNrdquo process on Linux taking up most of the CPU then stop the Application server and modify the following ports in the file asproduct1012OracleASopmnconfopmnxml

From ltnotification-servergt

ltport local=6100 remote=6200 request=6003gt ltlog-file path=$ORACLE_HOMEopmnlogsonslog level=4 rotation-size=1500000gt

ltssl enabled=true wallet-file=$ORACLE_HOMEopmnconfsslwltdefaultgt ltnotification-servergt

20


To ltnotification-servergt



Then restart the Application server

21


4) Appendix A ndash Special Instructions for AS10gR2 on RHEL5 By default Oracle AS10gR2 does not support Redhat Enterprise Linux (RHEL) v5x and will refuse to install Oracle has conveniently provided instructions on how to successfully install on RHEL5 contained in Oracle Metalink Note 5641741 The contents of that note are reproduced here httpsmetalink2oraclecommetalinkplsqlfp=130142412756531163047534 Subject Oracle Application Server 10g (1012) Requirements for Linux OEL 5

and RHEL 5 Doc ID Note5641741 Type ANNOUNCEMENT Last Revision Date 13-NOV-2008 Status PUBLISHED

In this Document What is being announced What do you need to do Follow Operating System Requirements for OEL 5x or RHEL 5x Follow Installation Requirements for OEL 5x or RHEL 5x Known Issues References

Applies to Oracle Application Server 10g Enterprise Edition - Version 101200 to 101230 Linux x86-64

What is being announced This document provides supplemental instructions and requirements for installing Oracle Application Server 10g Release 2 (101202) on the Oracle Enterprise Linux (OEL) 5x or Red Hat Enterprise Linux (RHEL) 5x operating systems It is necessary to then apply Oracle Application Server 10g Release 2 Patch Set 3 (10123) to comply with certification provided from the following location

Oracle Application Server 10g Release 2 (101202) Certification Information [httpwwworaclecomtechnologysoftwareproductsiasfilesas_certification_r2_101202html] Oracle has tested this combination and provides this document to list additional requirements complementing the Linux Installation Guide and Release Notes

Oracle Application Server 10g Release 2 (101202) Release Notes and Installation Guides [httpdownloadoraclecomdocscdB14099_19getstarthtm]

22


Important

bull As per the footnotes within Table 1 of the OTN Certification Guide the following installation types for the Oracle Application Server 10g Infrastructure are not supported on OEL 5x or RHEL 5x - Identity Management and Metadata Repository (co-located Infrastructure) - Metadata Repository (non-colocated with a 101 DB) This is because the Oracle Database Server 10g release 1 (101) is not certified on these platforms If requiring these Infrastructure installation types with an Oracle Database the recommendation is to install Oracle Database Server 10g Release 2 (102) After this the Metadata Repository Creation Assistant (MRCA) version 101203 can be run followed by an Identity Management installation type (Alternatively the MRCA 101401 and Identity Management 101401 may be installed for the non-colocated Infrastructure with Oracle Database 102) Therefore when using Oracle Application Server 10g Release 2 (1012) media only the middle-tier and Identity Management installation types are certifiedsupported

bull In addition to initial installation requirements the Oracle Application Server 10g Release 2 Patch Set 3 (10123) is required to be fully certified on OEL 5x or RHEL 5x

bull Oracle Application Server 10g Release 2 101200 or 101201 versions are not supported with Oracle Enterprise Linux (OEL) 50 or Red Hat Enterprise Linux (RHEL) 50 It is recommended that version 101202 be obtained and installed Note 4330611 How to Obtain Application Server Media Patchsets and Patches

What do you need to do

Follow Operating System Requirements for OEL 5x or RHEL 5x 1 The following packages (or later versions) must be installed on your Linux x86 or Linux x86-64 system binutils-2169105-234 gcc-410-284 gcc-c++-410-284 glibc-devel-24-312 libgcc-410-284 libstdc++-devel-410-284 libstdc++-410-284 make-380-2022 openmotif21-2130-11EL5i386rpm [httpossoraclecomprojectscompat-oracledistfilesEnterprise_Linuxopenmotif21-2130-11EL5i386rpm] xorg-x11-libs-compat-682-1EL3301i386rpm

23


[httpossoraclecomprojectscompat-oracledistfilesEnterprise_Linuxxorg-x11-libs-compat-682-1EL3301i386rpm]

2 Ensure that libXp has been installed The package libXp was not installed in RHEL 5OEL 5 with default RPM packages so it will need to be installed manually In RHEL 4 this file was provided by the package xorg-x11-deprecated-libs which is installed with default package installation but this is not the case for RHEL5OEL5 and is now provided with a different rpm the libXp rpm Install the package libXp by the command rpm -ivh ltpathtogtlibXpltversiongti386rpm Note libXpso6 can be found by installing the package ServerlibXp-100-81el5i386rpm under Disk3 of the OEL5 media Issue the following to confirm rpm -qa --queryformat NAME-VERSION-RELEASE (ARCH)n | grep libXp [ Reference Note 4436171 ] 3 When installing Oracle Application Server 10g Release 2 (101202) within the OEL 5x or RHEL 5x operating systems you will need to create the following symbolic link as root prior to doing any installations

ln -s usrliblibgdbmso200 usrliblibdbso2 If an error occurs stating that libdbso2 already exists it may be from a previous 1013 installation In this case either move the file for backup and create the symbolic link or skip this step to see if the following problem occurs

bull Without this symbolic link httpd will give the following error httpd error while loading shared libraries libdbso2 cannot open shared object file No such file or directory With this link in place httpd should start up successfully in OEL 50 or RHEL 50

4 The installation of Oracle Application Server 10g Release 2 (101202) requires the correct openmotif package to be installed on your OEL 5x or RHEL 5x box Without the correct package you will run into installation errors for those components that require openmotif (such as reports and forms) You may download the RPM package from the following location

[httpossoraclecomprojectscompat-oracledistfilesEnterprise_Linuxopenmotif21-2130-11EL5i386rpm]

24


As root you can install this RPM package by issuing the following command rpm -i openmotif21-2130-11EL5i386rpm 5 Any installation of Oracle Application Server 10g Release 2 (101202) on OEL 5x or RHEL 5x in which Reports is getting installed will fail with reports relinking errors unless you apply the required RPM listed belowYou may download the RPM package from the following location

[httpossoraclecomprojectscompat-oracledistfilesEnterprise_Linuxxorg-x11-libs-compat-682-1EL3301i386rpm] As root you can install this RPM package by issuing the following command rpm -i xorg-x11-libs-compat-682-1EL3301i386rpm After the RPM is installed you will also need to override the usrliblibXtstso6 with the one from usrX11R6liblibXtstso6 As root issue the commands mv usrliblibXtstso6 usrliblibXtstso6ORG ln ndashs usrX11R6liblibXtstso6 usrliblibXtstso6 Note On future OEL 5x and RHEL 5x versions these packages may be cumulative to newer packages Consult operating system vendor documentation for details

Follow Installation Requirements for OEL 5x or RHEL 5x

1 Before installing Oracle Application Server 10g Release 2 (101202) apply Patch 6687768 in order to start the installer If you do not apply this patch pre-req check for the OS Version will fail when you invoke the runInstaller

2 Follow all other instructions from the Installation Guide and Release Notes This Metalink Note is only for specific OEL 5x and RHEL 5x requirements

o Oracle Application Server 10g (101202) Release Notes and Installation Guides [httpdownloadoraclecomdocscdB14099_19getstarthtm]

Important The Known Issues below are for issues that have been found to occur during the installation and require steps to resolve Depending on your installation options review the Known Issues to prevent the errors from occurring

3

4 Apply Patch 5983622 which is the Oracle Application Server 10g Release 2 Patch Set 3 (10123) This is required in order to be fully certified on OEL 5x or RHEL 5x More information regarding

25


10123 can be found in Note3293611 Table 2 Note 3293611 Oracle Application Server 10g Release 2 (1012) Support Status and Alerts --See Table 2 Oracle Application Server Patchsets

Known Issues

1 When performing any Oracle Application Server 10g Release 2 (1012) installation a pop-up error message box may appear indicating ldquoopmn not startedrdquo The error message box appears just before the rootsh phase of the install From the command line issue the command ldquoopmnctl statusrdquo and it should show that opmn is up and running Hence you can ignore this pop-up error message and continue with the installation

2 Apply Patch 6690831 if you are performing an Oracle Application Server 10g Release 2 (1012) installation which includes Discoverer Without this fix the installation will fail during the OPMN Configuration Assistant phase because it cannot start up the Discoverer processes The Discoverer processes fail to start because there is an LD_ASSUME_KERNEL setting that needs to be removed in opmnxml for Discoverer The issue can be fixed following the below steps

o Download Patch 6690831 o Unzip it to a working directory o Run the shell script provided in the patch o After shell script runs successfully go back to OUI install o and press Retry on the OPMN Configuration Assistant

3 Apply the Patch 6706051 if you are performing an Oracle Application Server 10g Release 2 (1012) installation which includes Oracle Certification Authority (OCA) Without this fix the installation will fail during the Oracle Certification Authority Configuration Assistant phase The issue can be fixed following the below steps

o Download Patch 6706051 o Unzip it to a working directory o Run the shell script provided in the patch o After shell script runs successfully go back to OUI install and press o Retry on the Oracle Certification Authority Configuration Assistant

26


Operating system minimum requirements

Database version

Application server version

Web browser version

Oracle Applications version

2) Oracle 11g Database Server Post-Installation Configuration


Application Deployment

Getting started

Additional setups

4) Appendix A ndash Special Instructions for AS10gR2 on RHEL5

Applies to

What is being announced


Follow Operating System Requirements for OEL 5x or RHEL 5x


Known Issues



Operating system minimum requirements bull Pentium 4 24 GHz or equivalent bull You need to install the following Operating system

Red Hat Enterprise Linux ES 5x bull A minimum of 1GB of memory (RAM) for SwiftConfigurator application

Note you need a minimum of 2 GB (RAM) if the application and database server are installed on the same machine

bull A minimum of 3GB of hard disk space for SwiftConfigurator core tables data bull httpwwwredhatcom

Database version Oracle Database 11g (v11106 or above) (character set UTF-8) httpwwworaclecomtechnologysoftwareproductsdatabaseindexhtml

Application server version Oracle Application Server 10g Release 2 Patch Set 3 (10123) Download available here

httpwwworaclecomtechnologysoftwareproductsiashtdocs101202htmlSee special installation instructions in appendix A of this document

Web browser version SwiftConfigurator is compatible with the following browsers

o Internet Explorer 6028001106 o Mozilla Firefox v20x

Oracle Applications version SwiftConfigurator can build instances for Oracle Applications version 11510 and 120x

2










3



4




5






6


7


7



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues










3



4




5






6


7


7



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



4




5






6


7


7



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues




5






6


7


7



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues






6


7


7



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues


7


7



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



8



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



9







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues







10



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



11



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



12




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues




13



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



14




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues




15



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



16





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues





17




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues




18












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues












20






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues






21









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues









22


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues


Important






23








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues








24









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues









3


25



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues



Known Issues






26



Database version


Web browser version





Getting started

Additional setups


Applies to





Known Issues

swift configurator installation-manual

Documents

swiftconfigurator database

g database server installation

swiftconfigurator application

g database control

export oracle

database user account

database admin user

db user