Posted on

Example OAS App deployment instructions

Installation Instructions

Prerequisites:
1. Platform:
Oracle Application Server 10.1.3
Oracle RDBMS 10.2.0.4

Database Deployment
1. Open Database folder on CD and follow instructions:
a. If deploying to Testing Environment read:
DatabaseTestingInstructions.txt
b. If deploying to Production Environment read:
DatabaseProductionInstructions.txt

Application Deployment
1. Log in to Oracle Server web interface.

2. If the group “{PROJECT_NAME}_Group” does not exist, create it.
a. Go to Cluster Topology and scroll down to Groups list
b. Create a new group
c. Name the group “{PROJECT_NAME}_Group”
d. Click Create

3. If the OC4J Instance for “{PROJECT_NAME}_Home” does not exist, create it.
a. Go to Cluster Topology and scroll to Members list
b. Click the top level Application Server
c. Click Create OC4J Instance
d. Set OC4J Instance Name: “{PROJECT_NAME}_Home”
e. Add to an existing group “{PROJECT_NAME}_Group”
f. Check the box marked “Start instance after creation”
g. Click Create
h. Ensure the instance has started

4. Create Database Connection
a. Select the OC4J instance “{PROJECT_NAME}_Home”
b. Select Administration tab, then JDBC Resources from list
c. Create Connection Pool
i. Under Connection Pool heading click Create
ii. Select “default” application from drop down
iii. Select New Connection Pool
iv. Click Continue
v. NAME: {PROJECT_NAME}_CONNECTION_POOL
vi. Use default connection factory class
vii. JDBC URL: jdbc:oracle:thin:@//{SERVER_NAME}:1521/{SID}
viii. USERNAME: {PROJECT_NAME}_APPLICATION_USER
ix. PASSWORD: {APPLICATION_USER_PASSWORD}
x. Click Finish
d. Create Data Source
i. Under Data Sources heading click Create
ii. Select default application from drop down
iii. Select Managed Data Source
iv. Click Continue
v. NAME: {PROJECT_NAME}_JNDI_CONNECTION
vi. JNDI LOCATION: java:/comp/env/jdbc/{PROJECT_NAME}Datasource
vii. CONNECTION POOL: {PROJECT_NAME}_CONNECTION_POOL
viii. Click Finish

5. Deploy the application
a. Go to Cluster Topology and scroll down to Groups list
b. Select “{PROJECT_NAME}_Group”
c. Select Applications tab
d. Select Deploy
e. Set Archive Location to path to file on CD at Deploy{PROJECT_NAME}_{VERSION}.war
f. Click on next
g. Ensure that Root context and application name fields are the same
h. Click next
i. Select Configure Class Loading (the pencil)
j. Under Import Shared Libraries ensure the following are unchecked:
{Note: list libraries not needed for specific application }
{apache.commons.logging}
{oracle.toplink}
k. Click Ok
l. Click Deploy

6. Configure memory allocation
a. Go to Cluster Topology
b. Select “{PROJECT_NAME}_Home” in the Members list
c. Go to the Administration tab
d. Select Server Properties
e. Set Initial heap size to {MINIMUM_MEMORY}m
f. Set Maximum heap size to {MAXIMUM_MEMORY}m
g. Click Apply
h. Go to Cluster Topology
i. Select checkbox next to “{PROJECT_NAME}_Home” in the Members list
g. Click Restart

7. Test deployment of application and database connection
a. Bring up application login page:
b. Attempt to log in. Contact {poc} for user name and password.