Tuesday, October 6, 2009

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: \Database\TestingInstructions.txt b. If deploying to Production Environment read: \Database\ProductionInstructions.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.