installation instructions for jdeveloper and bpm 11g on...

Last updated: Feb 5, 2010 13:50

-1- Oracle Confidential. For authorized use only.

Do not distribute to third parties.

Installation instructions for

JDeveloper and BPM 11g on Windows

These instructions are for BPM 11g installation using version 11gR1 Beta (February 2010). These instructions are Windows based. Adjust for Linux accordingly.

Pre-requisites before you begin installation ............................................................................................ 2

A Memory Requirements ..................................................................................................................... 2

B Download files ................................................................................................................................... 2

C Check your database ......................................................................................................................... 2

D Check your browser ........................................................................................................................... 4

E Check your JDK .................................................................................................................................. 4

Install admin server and managed servers .............................................................................................. 4

F Install WebLogic server ..................................................................................................................... 4

G Drop existing schema ........................................................................................................................ 6

H Configure Schema .............................................................................................................................. 9

I Install SOA ........................................................................................................................................ 13

J Create Domain ................................................................................................................................. 15

Install JDeveloper ................................................................................................................................... 20

K Install and start JDeveloper ............................................................................................................. 20

L Update JDev with latest SOA ........................................................................................................... 23

Additional actions .................................................................................................................................. 24

M Setting memory limits ..................................................................................................................... 24

N Starting and stopping ...................................................................................................................... 24

O WebLogic Server console settings ................................................................................................... 26

P EM settings for development .......................................................................................................... 27

Q If you need to uninstall JDeveloper and Servers ............................................................................. 28

Troubleshooting ........................................................................................ Error! Bookmark not defined.

R Networking errors during deployment............................................... Error! Bookmark not defined.

Installation BPM 11gR1 Beta (February 2010)

- 2 - Oracle Confidential. For authorized use only.


Pre-requisites before you begin installation A Memory Requirements

This install requires 3 GB or more available memory. If you have less, try separating the installation of the database, the servers, and JDeveloper onto different machines.

B Download files

1. Create c:\stageBPM and save all files downloaded in next steps there. This document assumes that path. If you save them somewhere else then make sure there are no spaces in your path and adjust accordingly when c:\stageBPM is referenced in this document.

2. Download the following to c:\stageBPM :

• wls1032_win32.exe • rcuHomeWin.zip • soa.zip • bpm.zip • jdevstudio11112install.jar • soa-jdev-extension.zip • bpm-jdev-extension.zip

4. Unzip soa.zip to c:\stageBPM.

5. Unzip bpm.zip to c:\stageBPM.

6. Unzip rcuHomeWin.zip to c:\stageBPM.

C Check your database

• You need XE Universal database version 10.2.0.1 or 10g database version 10.2.0.4+ or 11g database version 11.1.0.7+.

• We have seen problems with installing XE when you already have 10g installed. The Windows registry sometimes gets the database files confused.

• If you need to uninstall XE, be sure to follow these instructions Oracle Database Express Edition Installation Guide 10g Release 2 (10.2) for Microsoft Windows Part Number B25143-03, Section 7 Deinstalling Oracle Database XE

Oracle internal location: http://st-doc.us.oracle.com/xe/doc/install.102/b25143/toc.htm#CIHDDHJD




OTN location: http://download.oracle.com/docs/cd/B25329_01/doc/install.102/b25143/toc.htm#CIHDDHJD

• If you need to uninstall 10.2, be sure to follow these instructions Oracle Database Installation Guide 10g Release 2 (10.2) for Microsoft Windows (32-Bit) Part Number B14316-04, Section 6 Removing Oracle Database Software

Oracle internal location: http://st-doc.us.oracle.com/10/102/install.102/b14316/deinstall.htm

OTN location: http://download.oracle.com/docs/cd/B19306_01/install.102/b14316/deinstall.htm#CIHDGGJJ

7. If needed, install OracleXEUniv.exe Recommended for small footprint database. Oracle internal location: http://bpel.us.oracle.com/11/downloads/ SOA11gR1/INSTALL/EXTRAS/ OTN location: http://www.oracle.com/technology/products/database/xe/index.html

• When you are using XE, you will see a warning when you run the RCU that this database version is too old. You can safely ignore this warning as it applies only to production environments.

8. If needed, configure Oracle XE Universal Before using Oracle XE for the first time, you must update database parameters. You only have to do this once after installing. Set the processes parameter to >=300. NOTE: The shutdown command can take a few minutes. Sometimes the shutdown/startup command fails. In that case, simply restart the XE service in the Control Panel/Administrative Tools/Services dialog after setting your parameters.

sqlplus sys/welcome1@XE as sysdba SQL> show parameter session SQL> show parameter processes SQL> alter system reset sessions scope=spfile sid=' *'; SQL> alter system set processes=300 scope=spfile; SQL> shutdown immediate SQL> startup SQL> show parameter session SQL> show parameter processes




D Check your browser

9. Enterprise Manager requires Firefox 3 or IE 7.

• Firefox 3 - get it from http://portableapps.comif you want it to co-exist peacefully with your Firefox 2 installation (Keep Firefox 2 if you use Rules Author in 10gR3.)

• Firefox 2 and IE 6 do not work in 11g.

10. BAM requires IE 7

• IE 7 without special plug-ins (there’s a Pro-search plug-in that causes problems). • IE 8 does not work. IE 6 has a few UI issues. Firefox does not work.

E Check your JDK

11. If you are going to install WebLogic server and JDeveloper on the same machine you will use the JDK from WebLogic for JDeveloper too. However if you are going to install on two machines, you need Java 1.6 update 14 JDK for JDeveloper.

• JDK 1.6 update 14 – from the Sun downloads page. Get the JDK not the JRE: http://java.sun.com/products/archive/

• You must use Java 1.6 update 14.

Install admin server and managed servers F Install WebLogic server

1. Install WebLogic server

a) Open a command window and enter

b) When the install wizard comes up, click Next

c) Select Create a new Middleware Home and enter C:\Oracle\Middleware\home_11gbeta This document assumes that path. If you use a different middleware home then adjust accordingly when C:\Oracle\Middleware\home_11gbeta is referenced throughout this document.

cd c:\stageBPM wls1032_win32.exe




d) Click Next e) Enter email to register for security alerts or deselect the checkbox and decline –

whichever you prefer, click Next f) Select Typical, click Next g) Review installation directories




h) Click Next i) Select “A ll Users” Start Menu folder, click Next j) Review Summary

k) Click Next to start the installation process. Install takes about 3 minutes. l) When the install is complete, deselect Run Quickstart checkbox and click Done.

G Drop existing schema

2. If this is the first time you are installing, jump ahead to the Configure Schema step. Otherwise, if you are reinstalling, you must drop your existing schema first. Copy the following into a command window. The bat command returns to the prompt immediately and after a few seconds, the Repository Creation Utility opens.

3. Click Next 4. Select Drop

cd c:\stageBPM\rcuHomeWin\bin rcu.bat




5. Click Next 6. Complete the database information

7. Click Next 8. The pre-requisites are reviewed. When completed, click OK . The utility moves to the

next page – with a slight delay, just wait for it. 9. The utility finds the existing schema and offers the dropdown list of all Prefixes. Check

that the prefix is correct and review the schema.




10. In this example, we are dropping the schema with the SH prefix. Click Next. 11. On the drop schema warning, click OK . 12. The pre-requisites for this step are reviewed. When completed, click OK to move to the

next page – with a slight delay, just wait for it.

13. Click Drop to drop the schema. This takes a few minutes. 14. When it is finished, Click Close.




H Configure Schema

15. Now create the new schema. Open a command window and enter the following.

The bat command returns to the prompt immediately and after a few seconds, the Repository Creation Utility opens (if you just ran the utility to drop the schema, it opens the second time much more quickly).

16. On the welcome screen, click Next

17. Select Create and click Next 18. Enter the database information

cd c:\stageBPM\rcuHomeWin\bin rcu.bat




19. Click Next

If you are using XE, you will see a warning when you install the schema that this version is too old. You can safely ignore this warning as it applies only to production environments.

20. The pre-requisites are reviewed. When complete, click OK . The utility moves to the next page – with a slight delay, just wait for it.

21. On the Select Components screen, enter DEV in the field for creating a new prefix. 22. Select the component SOA and BPM Infrastruture. Dependent schemas are selected

automatically.

o If you choose to select other components, these install instructions may not match your experience. Also, you may have to increase processes in XE (you will get a message telling you what is required).




23. Click Next 24. The pre-requisites for this step are checked. When completed, click OK . 25. Select the radio button to Use the same password for all schemas. Enter a schema

password. The password, welcome1, is assumed in this document but you should choose your own secure password or a different one for each schema and be sure to record your passwords as you will need them later.

26. Click Next 27. Review the tablespaces and schema owners for the components




28. Accepting the defaults, click Next and then click OK to create the tablespaces. 29. When the pre-requisites for this step are completed, click OK

30. Click Create to create the tablespaces. This takes about 2 minutes. 31. When completed, click Close.




I Install SOA

32. Locate the JDK directory path within the installed middleware home. You use this path in the next command. In this example, the JDK location is shown as jdk160_14.

In a command window enter

m) When the install wizard welcome screen comes up, click Next

a) Wait for the pre-requisite check to complete (it’s quick!)

b) Click Next c) On the Specify Installation Location screen, select the Middleware home:

C:\Oracle\Middleware\home_11gbeta d) Enter Oracle home: Oracle_SOA1

If you use a different Oracle home then adjust accordingly when Oracle_SOA1 is referenced throughout this document.

cd c:\stageBPM\soa\Disk1 setup -jreLoc C:\Oracle\Middleware\home_11gbeta\jdk 160_14




e) Click Next f) Review summary

g) Click Install h) Wait for the install to complete – takes a few minutes. i) When install reaches 100%, click Next and then click Finish




J Install BPM

This step is exactly the same as the previous step for SOA but you run setup from the BPM directory.

33. In a command window enter

34. Complete the remaining screens in the wizard as described for installing SOA, section I above. Be sure to use the same Oracle home location, e.g., Oracle_SOA1 when you get to step 3 of the wizard (step (d) above).

K Create Domain

35. In a command window enter

a) When the configuration wizard welcome screen comes up, select Create a new WebLogic domain, click Next

b) Select Generate a domain and select SOA Suite, Enterprise Manager, and Business Activity Monitoring. Dependent products are selected automatically

cd C:\Oracle\Middleware\home_11gbeta\Oracle_SOA1\co mmon\bin config.cmd

cd c:\stageBPM\bpm\Disk1 setup -jreLoc C:\Oracle\Middleware\home_11gbeta\jdk 160_14




c) Click Next

d) Enter the domain name: domain1

e) Click Next f) Enter user name weblogic and a password. The password, welcome1, is assumed

in this document but you should choose your own secure password and remember it for later in the document when the password is referenced.




g) Click Next

h) Select the Sun SDK 1.6_14 and leave Development Mode checked

i) Click Next j) On the Configure JDBC Component Schema screen, you select the components

that you want to change, and then enter the property value for those components. First, select all of the components and enter welcome1 for the password in the Schema Password field.




k) With all of the checkboxes selected, enter the Service, Host, and Port values.

l) Now, look at the table. Review the Schema Owner column and confirm that the values are the same as what you configured in the Configure Schema section when you ran the RCU. Go back and review the screen shots in that section of this document for the schema owners if you do not remember them.

m) Complete the following if the schema owners need to be updated, e.g, BAM: 1. Deselect all the component checkboxes 2. Select BAM Schema only. 3. Enter the Schema Owner, DEV_ORABAM 4. Next, deselect BAM Schema and select the next one. 5. Enter the schema owners one-by-one by pre-pending DEV_ to the

defaulted value. DEV is the prefix specified in the RCU step. 6. Continue until all schema owners are entered.

n) Click Next. o) The data source connections are all tested.




p) If all are successful, click Next, otherwise click Previous and correct any errors. q) Click Next once more, accepting defaults (no optional configurations), and you

reach the Configuration Summary screen.

r) Click Create. s) Wait for the create to finish – takes just a minute t) Click Done.




Install JDeveloper L Install and start JDeveloper

If you are installing JDeveloper on a machine that is not the same as your WebLogic server installation, you must have installed the JDK 6 update 14 first. See Pre-requisites section for download location.

36. Open command window and enter (if you copy/paste, make sure there is no space after the = sign and eliminate trailing spaces). You will see a message that the jar is extracting: >%JAVA_HOME%\bin\java.exe -jar jdevstudio11113install.jar Extracting 0%..........................

When it reaches 100% the installation wizard will open. This takes a few minutes.

If you see the splash screen briefly but then you do not see the Extracting message and the installation wizard does not open, it's probably because the java is the wrong version. Enter %JAVA_HOME%\bin\java.exe –version to see the version. It must be version 1.6_14.

37. Complete the installation wizard as follows. Note that this does install an embedded WebLogic Server that you can use for testing java applications. You may not ever use it if you are creating only SOA applications. Although you can deselect the WebLogic Server using the custom install option, most of the subcomponents are still required by JDeveloper anyway. It’s your choice.

a) Welcome Screen – Click Next b) Choose Middleware Home Directory: select Create a new Middleware Home

and enter C:\Oracle\Middleware\jdev_11gbeta. This document assumes that path. If you enter something else then adjust accordingly when c:\Oracle\Middleware\jdev_11gbeta is referenced.

set JAVA_HOME=C:\Oracle\Middleware\home_11gbeta\jdk 160_14_R27.6.5-32 cd c:\stageBPM %JAVA_HOME%\bin\java.exe -jar jdevstudio11113instal l.jar




c) Click Next d) Choose Install Type: Complete, click Next e) JDK Selection: you will see your JAVA_HOME

f) Click Next g) Confirm Product Installation Directories. You should see:

Middleware Home Directory: C:\Oracle\Middleware\jdev_11gbeta JDeveloper and ADF:




C:\Oracle\Middleware\jdev_ 11gbeta \jdeveloper WebLogic Server: C:\Oracle\Middleware\jdev_ 11gbeta \wlserver_10.3

h) Click Next i) Choose Shortcut location: "All Users" and click Next j) Review Installation Summary

k) Click Next and the installation starts. l) Wait for the installation to complete – a few minutes. m) When installation completes, deselect Run Quickstart and click Done.




38. Start JDeveloper Studio 11.1.1.3.0 from the Windows Programs menu: Oracle Fusion Middleware 11.1.1.3.0 or run C:\Oracle\Middleware\jdev_ 11gbeta \jdeveloper\jdeveloper.exe . During startup, select the following when prompted:

a) Select Default Role, de-select Show this dialog every time, and click OK b) If you see the "Confirm Import Preferences" dialog Click Yes or No as desired

If you are prompted to select file extensions to associate with JDeveloper, deselect everything or select whichever ones you would like for your machine and continue.

M Update JDev with latest SOA

SOA design time in JDeveloper requires a JDeveloper extension called SOA Composite Editor. While this is normally updated over the network when using release level software, you can perform the update manually if you have the extension file.

39. Start JDeveloper as described in the previous step 40. Select Help/Check For Updates, Click Next 41. Select Install from Local File , Browse to c:\stageBPM\soa-jdev-extension.zip 42. Click Open, click Next

43. Confirm that the version matches the version shown in the image above 44. Click Finish




45. Restart JDeveloper when prompted. You will say Yes or No again to the import preferences question.

46. When JDeveloper is running again, go to Help/About 47. Select Version tab, confirm the SOA Composite Editor version: 11.1.1.3.0.23.00

N Update JDev with latest BPM

Likewise, BPM design time in JDeveloper requires a JDeveloper extension called BPM Process Editor. While this is normally updated over the network when using release level software, you can perform the update manually if you have the extension file.

48. Start JDeveloper as described in the previous step 49. Select Help/Check For Updates, Click Next 50. Select Install from Local File , Browse to c:\stageBPM\bpm-jdev-extension.zip 51. Complete the remaining screens as described for the soa extension. 52. Confirm the BPM Process Editor version: 11.1.1.3.0.04.33

Additional actions O Setting memory limits

1. Edit the SOA domain environment file found here (make sure you have the SOA Domain environment file):

C:\Oracle\Middleware\home_11gbeta\user_projects\dom ains\ domain1\bin\setSOADomainEnv.cmd

2. Set memory values

set DEFAULT_MEM_ARGS=-Xms512m -Xmx512m

This value is dependent on your machine resources and may need to be adjusted for your machine. Allocating less memory will give you better performance on a machine with less memory available. This value is appropriate for a 3GB memory machine or less.

P Starting and stopping

Start

To start the servers: a) Open 3 command windows, one for the WebLogic admin server, one for the SOA

managed server, and one for the BAM managed server (only start BAM when you need it for a BAM lab).




b) Start the Admin Server first

c) Wait for the Admin Server to finish starting up. It takes a few minutes – watch

for status “RUNNING” in log console window

d) Start the SOA Managed Server in the second command window. This start script is in the bin directory. You can choose to cd to the bin directory instead.

e) When prompted, enter the user name weblogic and password welcome1. If you did step (a) and set the boot.properties, you will not be prompted. The server is started when you see the message, “INFO: FabricProviderServlet.stateChanged SOA Platform is running and accepting requests”

cd C:\Oracle\Middleware\home_ 11gbeta\user_projects \domains\domain1 startWebLogic.cmd

cd C:\Oracle\Middleware\home_11gbeta\user_projects\ domains\domain1 bin\startManagedWebLogic.cmd soa_server1




f) Start the BAM Managed Server in the third command window – do this only when needed for the BAM labs

g) When prompted, enter the user name weblogic and password welcome1. If you did step (a) and set the boot.properties, you will not be prompted. Watch for the “RUNNING” status.

Console URLS - Login with weblogic/ welcome1 for all consoles:

The link for the Weblogic console http://localhost:7001/console The link for the Enterprise Manager console http://localhost:7001/em

The link for the SOA worklist app (used with Human Task) http://localhost:8001/integration/worklistapp

The link for B2B http://localhost:8001/b2b

The link for BAM (must use IE browser) http://localhost:9001/OracleBAM

Stopping Servers

Whenever you need to stop the server complete the following: a) Stop the managed servers first by entering CTRL-C in the command window.

Wait until stopped. b) Stop the admin server by entering CTRL-C in the command window.

Q WebLogic Server console settings

1. You will be viewing the application deployments often using the WebLogic server console. This is a lot more convenient if you change the settings not to show libraries as this makes the list a lot shorter.

a) Start the WebLogic Admin Server (WLS) if it is not already running. b) Login to the WLS console http://localhost:7001/console c) Click Deployments in the left navigation bar d) Click Customize this table at the top of the Deployments table. e) Change the number of rows per page to 100 (there are only about 30)

cd C:\Oracle\Middleware\home_11gbeta\user_projects\ domains\domain1 bin\startManagedWebLogic.cmd bam_server1




f) Select the checkbox to exclude libraries and click Apply

2. When the server is started, internal applications like the WLS console are not deployed completely and you see a slight delay when you first access the console. You can change this to deploy internal applications at startup instead. This is convenient for demos (if you want to show the console) and also if you tend to use the console each time you startup the server.

a) Click on domain1 in the left navigation bar in the WLS console. b) Click Configuration -> General tab. c) De-select Enable on-demand deployment of internal applications check box. d) Click the Save button

R EM settings for development

The Enterprise Manager 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. These settings are not used on production machines except when specifically needed for debugging purposes as there is a performance cost.

1. Start your servers if they are not already running. 2. Login to the EM console: http://localhost:7001/em 3. Right-click on the soa-infra (soa_server1) in the left navigation bar to open the SOA

menu and select SOA Administration > Common Properties




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

5. Click Apply and click Yes

S If you need to uninstall JDeveloper and Servers

If you need to uninstall everything, complete the following.

1. First save anything you want to keep from here C:\Oracle\Middleware\jdev_11gbeta\jdeveloper\mywork

2. Run Uninstall from program menu to completion for both JDev and WLS. 3. Delete C:\Oracle\Middleware\jdev_11gbeta and

C:\Oracle\Middleware\home_11gbeta . 4. Delete program groups from C:\Documents and Settings\All

Users\Start Menu\Programs\

a) Oracle Fusion Middleware 11.1.1.3.0 b) Oracle SOA 11g c) Oracle WebLogic

5. Complete the Drop existing schema section to clean up the database.