lab 1 - installation and setup

Oracle Fusion Middleware Technology Group, APAC 1

Oracle BPM Workshop (11.1.1.6.0)

Lab1 - Installation and Setup

Lab Guide

.


Lab 1: Installation and Setup

Objectives

At the end of this exercise, you will be able to:

Install OracleXE Database

Install Oracle WebLogic Server + Coherence

Install Oracle SOA Suite

Setup and configure a domain for BPM Suite.

Install JDeveloper

Overview

In this lab, you will install and setup a development environment for Oracle BPM Suite for the purpose of

the hands-on exercises in the subsequent labs for this workshop.

An overview of the installation and setup steps and the installer files used are as follows:

1. Install OracleXE Database (OracleXEUniv.exe)

2. Install JDK1.6.0_35 (jdk-6u35-windows-x64.exe)

3. Install WebLogic Server + Coherence (wls1036_generic.jar)

4. Setup the required database schema using the Repository Creation Utility (ofm_rcu_win_11.1.1.6.0_disk1_1of1.zip)

5. Install BPM Suite (ofm_soa_generic_11.1.1.6.0_disk1_1of2.zip + ofm_soa_generic_11.1.1.6.0_disk1_2of2.zip)

6. Setup and configure a domain for BPM Suite.

7. Install JDeveloper (jdevstudio11116install.jar)

8. Update JDeveloper with the SOA extension (soa-jdev-extension.zip). This is required for SOA design time in JDeveloper i.e. SOA Composite Editor

9. Update JDeveloper with the BPM extension (bpm-jdev-extension.zip). This is required for BPM design time in JDeveloper i.e. BPM Studio

Note:

This lab guide assumes that there are no previous installations of the above on the machine you are

installing on.


Detailed Instructions

Install OracleXE Database

1. Run the OracleXE installation program which can be found: \Workshop\installer\OracleXEUniv.exe

2. Click Next and accept the agreement.

3. Select Oracle Database 10g Express Edition and the location to install to, in

this lab, we will use C:\oraclexe

4. In the next screen enter the password for system administrator account. Lets use welcome1 for all the administrator accounts to simplify this lab exercise.

5. Accept the default settings and do next to install Oracle XE. The port used will be 1521

and listener name will be XE by default.

6. Open a command window to set the processes parameter to >=300 as follows:

sqlplus sys/welcome1@XE as sysdba

SQL> alter system reset sessions scope=spfile sid='*';

SQL> alter system set processes=300 scope=spfile;

Restart the OraceServiceXE service in the Control Panel/Administrative

Tools/Services dialog after setting your parameters.

Install JDK

7. Run the JDK installation program which can be found: \Workshop\installer\jdk-6u35-windows-x64.exe


8. At Welcome dialog, Click Next.

9. Click Change


10. Set the location (i.e. C:\Java\jdk1.6.0_35) to install your JDK and Click OK

11. Click Next


12. Installation started

13. Click Change and Select C:\Java\jre6


14. Click Next

15. Click Finish. You can skip the registration prompted by browser.


Install WebLogic Server + Coherence

16. Run the oracle weblogic server installation program which can be found: \Workshop\installer\wls1036_generic.jar

Open the command windows and go to \Workshop\installer\ directory and type java -D64 -jar wls1036_generic.jar

17. The extraction started.

18. At Welcome dialog, Click Next.


19. At Choose Middleware Home Directory dialog, select Create a new Middleware Home. The default will be C:\Oracle\Middleware. Specify the home directory as C:\Oracle\Middleware10_3_6. Click Next.


20. At Register for Security Updates, for the purpose of this workshop, do as follows

Click Next.

Click Yes to be uninformed of critical security issues in your configuration.

Click Yes to bypass initiation of the configuration manager.

Select I wish to remain uninformed of security issues in my configuration or this machine has no internet access check. Click Continue.


21. At Choose Install Type dialog, select Typical. Click Next.

22. Click Browse to select your JDK Home. It should be the same location as Step 10.


23. Click Next

24. At Choose Product Installation Directories dialog, keep the default directories and click Next.


25. Click Next

26. The installation of Oracle WebLogic Server 11gR1 (10.3.6) started.


27. Upon completion of the installation, uncheck Run Quickstart and click Done.

Setup the required database schema using the Repository Creation Utility

28. Unzip \Workshop\installer\ ofm_rcu_win_11.1.1.6.0_disk1_1of1.zip

to C:\stage.

29. Open a command window to set the RCU_JDBC_TRIM_BLOCKS environment variable to

TRUE as follows:

set RCU_JDBC_TRIM_BLOCKS=TRUE

30. In the same command window, enter the following:

cd c:\stage\rcuHome\bin

rcu.bat


31. On the welcome screen, click Next.

32. Select Create and click Next.


33. Enter the database information shown on the screen. The username and password is the system administrator account and password specified in step 4 when you installed OracleXE Database.

34. You will see one or two warnings when you install the schema that this version is too old and is using the wrong character set. For the purpose of this workshop, you can safely ignore these warnings for your development / evaluation installation. Click Ignore.


35. When completed, click OK.

36. Select Create a new Prefix and specify DEV6. Select the component SOA and BPM Infrastructure. Dependent schemas are selected automatically. Click Next.


37. The pre-requisites for this step are checked. When completed, click OK.

38. For the purpose of this workshop, select the radio button to Use the same password for all schemas and specify welcome1 as the password. Click Next.


39. Review the tablespaces and schema owners for the components. For the purpose of this workshop, accept the defaults and click Next. Click OK to create the tablespaces. When completed, click OK again.

40. Click Create to create the tables. This takes a few minutes.


41. When completed, click Close.

Install BPM Suite

42. Unzip \Workshop\installer\

ofm_soa_generic_11.1.1.6.0_disk1_1of2.zip to C:\stage\SOA.

43. Unzip \Workshop\installer\

ofm_soa_generic_11.1.1.6.0_disk1_2of2.zip to C:\stage\SOA.

44. Open a command window and enter the following:

cd c:\stage\SOA\Disk1

setup -jreLoc C:\Java\jdk1.6.0_35


45. When the install wizard welcome screen comes up, click Next

46. Select Skip Software Updates and click Next.


47. When the pre-requisite checks complete, click Next.

48. Make sure the Middleware Home is as below. Leave Oracle home directory as default. Click Next.


49. Accept the defaults and click Next.

50. Review the summary and click Install.


51. Wait for the install to complete it takes a few minutes.

52. When completed, click Next.


53. Installation completed. Click Finish.

Setup and configure a domain for BPM Suite

54. Select Start > All Programs > Oracle WebLogic > WebLogic Server 11gR1 > Tools > Configuration Wizard

55. In the Configuration Wizard dialog, select Create a new WebLogic domain. Click Next.


56. At Select Domain Source dialog, select the following:

Oracle BPM Suite for developers

Oracle SOA Suite for developers

Oracle Enterprise Manager

Oracle Business Activity Monitoring

Dependant items are selected automatically. Click Next.


57. At Specify Domain Name and Location dialog, leave domain name as bpm_domain. \user_projects\domains for domain location and

\user_projects\applications for application location.

Click Next.

58. At Configure Administrator Username and Password dialog, enter weblogic for User name field and welcome1 for User password and Confirm user password fields. Click Next.


59. At Configure Server Start Mode and JDK dialog, keep the default selection and click Next.

60. At Configure JDBC Component Schema dialog, select the checkboxes and specify the values as shown. The Schema Password is welcome1. Click Next.


61. At Test Component Schema dialog, wait for the testing to complete. Click Next.

62. At Select Optional Configuration dialog, click Next.


63. At Configuration Summary dialog, click Create.

64. When completed, click Done.


Install JDeveloper

65. Run the JDeveloper installation program which can be found: \Workshop\installer\jdevstudio11116install.jar

Open the command windows and go to \Workshop\installer\ directory and type java -D64 -jar jdevstudio11116install.jar

66. Click Next.


67. Select and specify the values as shown. Click Next.

68. Select Complete and click Next.


69. Click Browse to select your JDK Home. It should be the same location as Step 10.

70. Click Next.


71. Click Next.

72. Wait for the install to complete it takes a few minutes.


73. When completed, uncheck Run Quickstart and click Done.

Setup and configure a domain for SOA Suite and Service Bus

74. Select Start > All Programs > Oracle Fusion Middleware 11.1.1.5.0 > JDeveloper Studio 11.1.1.5.0

75. Select Default Role, uncheck Always prompt for role selection on startup and click OK.


76. Click No.

77. Within JDeveloper, select Help > Check for Updates


78. Click Next.

79. Select Install From Local File, click Browse and choose \ Workshop\installer\ soa-jdev-extension.zip. Click Next.


80. Select as below and Click Next

81. Download started


82. Click Finish.

83. Click Yes.

84. Repeat step 77 to 83 for \Workshop\installer\ bpm-jdev-extension.zip

85. Close Jdeveloper.

86. Edit jdev.conf at C:\Oracle\Middleware10_3_6_Jdev\jdeveloper\jdev\bin to change

the parameter

From AddVMOption -XX:MaxPermSize=256M

To AddVMOption -XX:MaxPermSize=1024M

Restart JDeveloper

Install Apache James Mail Server

87. Unzip \Workshop\installer\apache-james-2.3.2.zip into c:\

88. Open command window and cd \james-2.3.2\bin. Type run.bat


89. Open another command window and type telnet localhost 4555

Login as root and password is root

Type adduser sender password

Type adduser weblogic password

The above commands will add the 2 users to this mail server.

90. Close the command window. This mail server will be used in Lab 9 and 11.

Setting Memory Limits

Open for editing the SOA domain environment file C:\Oracle\Middleware10_3_6\user_projects\domains\bpm_domain\bin\

setSOADomainEnv.cmd

Edit the following line:

set PORT_MEM_ARGS=-Xms2048m -Xmx2048m

set PORT_MEM_ARGS=%PORT_MEM_ARGS% -XX:PermSize=512m -

XX:MaxPermSize=1024m

These values are dependent on your machine resources and may need to be adjusted for your machine.

These values are appropriate for a 8GB memory 64bit machine.

Starting Servers

Before starting the servers for the first time, exit all unnecessary programs on your machine including

JDeveloper. After the first time, the server startup memory requirements are slightly lower.

Open a command window and enter the following:

cd C:\Oracle\ Middleware10_3_6\user_projects\domains\bpm_domain\bin

startWebLogic.cmd

Wait for the Admin Server to finish starting up. It takes a few minutes watch for status RUNNING in log console window and for the message that the SOA Platform is running and accepting requests. Once running, the BPM Suite are ready for use.

When needed, start the BAM Managed Server in a second command window as follows:

cd C:\Oracle\ Middleware10_3_6\user_projects\domains\bpm_domain\bin

startManagedWebLogic.cmd bam_server1

When prompted, enter the user name weblogic and password welcome1.


After the first time you start the managed server, create a file called boot.properties with the following content:

password=welcome1

username=weblogic

Store boot.properties to the following directory: C:\Oracle\ Middleware10_3_6\user_projects\domains\bpm_domain\servers\bam_server

1\security

This folder does not exist until you have started the server the first time (you have to create the

security folder). This file allows your managed server to startup without prompting for a password.

The file is encrypted the first time it is accessed. If you set the boot.properties as described above,

you are no longer prompted during startup.

Watch for the RUNNING status.

Console URLs

WebLogic console: http://localhost:7001/console

Enterprise Manager console: http://localhost:7001/em

BAM: http://localhost:9001/OracleBAM

Login with weblogic/welcome1 for all consoles

Stopping Servers

Whenever you need to stop the server complete the following:

Stop the managed servers first by entering CTRL-C in the command window. Wait until stopped.

After the managed server stops, stop the admin server by entering CTRL-C in the window.

EM Settings for Development

The Enterprise Manager Fusion Middleware Control (EM) can provide different levels of information

about composite runtime instances based on a property setting. During development it is helpful to have a

higher setting to get more information. These settings are not used on production machines except when

specifically needed for debugging purposes.

Start your servers if they are not already running.

Login to the EM console at http://localhost:7001/em


Expand the SOA folder and then right-click on the soa-infra (AdminServer) in the left

navigation bar to open the SOA menu and select SOA Administration > Common Properties

Select Audit Level: Development and select the checkbox for Capture Composite Instance State

Click Apply and click Yes


Create DB schema and tables

Login Oracle DB Express Editor as system. Upload /Lab/Material/sql/create_user.sql and run the script.

QuoteDemo user is created with password as welcome1

Login Oracle DB Express Editor as QuoteDemo. Upload / Lab/Material/sql/quote.sql and run the script.

Click on Object Browser to check if the tables are created.


Configure Database Datasource

Login Web Logic Server console (http://localhost:7001/console) using weblogic/welcome1.

On the left navigation bar, click Services -> Data Sources.

At the top of the data source table, click Generic Data Source.

Enter the data source information

Name: quoteDS

JNDI Name: jdbc/quoteDS

Database Type: Oracle

Click Next, click Next twice more

Enter the database information.

Database Name: XE (your database SID)

Host name: localhost (host where your database is running)

Port: 1521 (set according to your configuration)

Database user name: quotedemo (created in previous section)

Database user password: welcome1

Click Next


Click Test Configuration. Confirm success message at top of page

Click Next

Select the Target server where your BPM component is running: AdminServer

Click Finish

Configure Database Adapter

If logout, login Web Logic Server console (http://localhost:7001/console) using weblogic/welcome1.

On the left navigation bar, click deployments

Click DbAdapter

Click Configuration -> Outbound Connections Pools tab.

Click New

Select javax.resource.cci.ConnectionFactory and click Next.


Specify name as eis/DB/QuoteDemoConn and click Finish. This name will be used by the DB Adapter in Lab 4.

Click OK

Go back to DB Adapter and click Configuration -> Outbound Connections Pools tab.

Select eis/DB/QuoteDemoConn and set xaDataSourceName as jdbc/quoteDS

Restart server.

Summary

Congratulations! You have now installed, setup and configured all the software required for a BPM

development environment. You are now ready to carry out the hands-on exercises in the subsequent labs

in this workshop.

lab 1 - installation and setup

Documents

oracle database

oracle bpm suite

oracle xe

oracle bpm workshop

oracle soa suite setup

setup lab guide

bpm extension

oraclexe installation