BPM UCM and Webcenter PS5

Configuring UCM , BPM and Webcenter Spaces PS5

for PS6 Updated Blog Content Click Here.

Introduction : This section focuses on Integrating Webcenter with UCM , then Patching up Process Spaces on Webcenter Spaces, Enabling Document management capability to BPM Tasks where one can attach documents from BPM Taskflow that gets checked into UCM

Cleaning Up the Repository RCU , if you had done lots of domain creation , install , uninstall etc your repository RCU might need a clean up before we start anything , so drop the current RCU Schema and create a new one as shown, But this is not advisable if you want to retain any of the current setup or configuration , so be careful on this decision.

I would be assuming that Oracle Database is already installed on your linux OS such as fedora . you can follow this link to know more about Oracle Database Installation Procedure or Linux, You can aswell use Windows OS with XE database , that should also work

re-run the rcu script again

[james@james bin]$ pwd
/home/james/Oracle/PS5Installers/RCU/rcuHome/bin

[jamesjames bin]$ export RCU_JDBC_TRIM_BLOCKS=TRUE
[jamesjames bin]$ ./rcu

Cleaning up current Domains : Once again you need to be careful with this decision , i am deleting my “user_projects” directory, so that i can recreate domain from scratch.

Check Your Host File

[root@james database]# sudo gedit /etc/hosts

your host file should should look something like this with the machine name added

127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4 your-machine-hostname
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
192.X.Y.Z your-machine-hostname

all the above in 3 lines

Creating FMW Domain

Lets create new FMW Domain to Include SOA , BPM , BAM, Webcenter Content and Webcenter Portal ( Spaces and UCM ) , Use Sun JDK 1.6.0_30


/home/james/Oracle/Middleware/Oracle_SOA1/common/bin
[james@james bin]$ ./config.sh

Test Database Connection to RCU Schemas

Patching the Process Spaces Template

Now Extend the “fmw_domain” , in the extension template , go to following directory and select oracle.bpm.spaces_template_11.1.1.jar template file

/home/james/Oracle/Middleware/Oracle_WC1/common/templates/
applications/oracle.bpm.spaces_template_11.1.1.jar


Click Next -> Next and Done.

“Out of Memory” Exceptions

In order to improve the performance and avoid “Out of Memory” Exceptions we need to edit setSOADomainEnv.sh file under /fmw_domain/bin directory

make replacement as shown below.

DEFAULT_MEM_ARGS="-Xms768m -Xmx1536m"
PORT_MEM_ARGS="-Xms768m -Xmx1536m"

...

..


if [ "${JAVA_VENDOR}" != "Oracle" ] ; then
DEFAULT_MEM_ARGS="${DEFAULT_MEM_ARGS} -XX:PermSize=768m -XX:MaxPermSize=1536m"
PORT_MEM_ARGS="${PORT_MEM_ARGS} -XX:PermSize=768m -XX:MaxPermSize=1536m"
fi

Edit process-portal-install.properties

go to /home/james/Oracle/Middleware/Oracle_SOA1/bpm/process_spaces , Edit process-portal-install.properties file
as shown below

################################################
# BPM Process Portal installation properties   #
################################################ 

extendSoa=true 
promptForPasswords=false 
wcSetDomainRealmPassword=true 
wcDomainRealmPassword=welcome1
wc.server.port=8888 
bpmDBUser=DEV_SOAINFRA
bpmDBPassword=welcome1
bpmDBType=ORACLE
bpmDBDriver=oracle.jdbc.OracleDriver
bpmDBUrl=jdbc:oracle:thin:@localhost:1521:orcl
bpmMDSUser=DEV_MDS
bpmMDSPassword=welcome1 
bpmServerURL=t3://james:7001 
bpmAdminUser=weblogic
bpmAdminPassword=welcome1 
wcOracleHome=/home/james/Oracle/Middleware/Oracle_WC1 
wcDomainName=soainfra 
isWebcenterClusterConfig=false 
wcSpacesClusterName=
wcHost=james
wcAdminPort=7001
wcAdminUser=weblogic
wcAdminPwd=welcome1 
wcManagedServerName=WC_Spaces 
wcConfigServices=false 
wcContentServerName=james
wcContentServerPort=16200
wcContentSpacesRoot=/AcmeSpaces
wcContentAdminUser=sysadmin
#discussion server details
#wcDiscussionServerUrl=http://james:8890/owc_discussions
#wcDiscussionAdminUser=weblogic
BPM Process Spaces Portal – PS5

Now lets set up , Process Spaces ,

1) Start Admin Server. please note admin server has soa server in our case , that means once we start Admin Server , our SOA BPM Server gets started.

2) Start WC_Spaces for Webcenter Portal

3) Start SOA_Server1 for UCM

Run the Ant Script First Time install.xml

/home/james/Oracle/Middleware/modules/org.apache.ant_1.7.1/bin/ant -f install.xml

[james@james process_spaces]$ pwd
/home/james/Oracle/Middleware/Oracle_SOA1/bpm/process_spaces
/home/james/Oracle/Middleware/modules/org.apache.ant_1.7.1
/bin/ant -f install.xml
..
Buildfile: install.xml

readPasswords:

validate-env:
     [echo] Validating the environment.. 

post-install:
     [echo] This target can also be called by setting 'piArgs' 
property for fine grained operations.
     [echo] Possible values are:
     [echo] -importRCOnly -- Imports only resource catalogs and exits.
     [echo] -importGSOnly -- Imports only group spaces and exits.
     [echo] -configDSOnly -- Configures data sources when SOA domain 
is not extended
     [echo] -foreignJndiOnly -- Configures foreign JNDI links
     [echo] -deploySTCOnly -- deploys server test case ejb
     [echo] -all (default) -- Does all post install activies 
including all above
     [echo] Invoking post install script with args: -all
     [exec] 

     [exec] 
     [exec] Initializing WebLogic Scripting Tool (WLST) ...
     [exec] 
     [exec] 
     [exec] Welcome to WebLogic Server Administration Scripting Shell
     [exec] 
     [exec] Type help() for help on available commands
     [exec] 
     [exec] Connecting to t3://james:7001 with userid weblogic ...
     [exec] Successfully connected to Admin Server 'AdminServer' 
that belongs to domain 'fmw_domain'.
     [exec] 
     [exec] Warning: An insecure protocol was used to connect to the 
     [exec] server. To ensure on-the-wire security, the SSL port or 
     [exec] Admin port should be used instead.
     [exec] 
     ..
     [exec] 
     [exec] For more help, use help(edit)
     [exec] 

     ..
     [exec] 
     [exec] Imported /home/james/Oracle/Middleware/Oracle_WC1/bpm/
process_spaces/resourceCatalog/ProcessSpacesCatalog.ear
     [exec] 
     [exec] Skipping webcenter services configuration...
     [exec] Importing group spaces into webcenter...

    ..
     [exec] Error occurred while performing import

     [exec] Importing group space: /home/james/Oracle/Middleware/
Oracle_WC1/bpm/process_spaces/groupspaces/process-instance-gst.ear
     [exec] 
     [exec] Error occurred while performing import
     ...

install-spaces:
     [echo] process portal installation completed. 
Please start the managed server now.

install:

BUILD SUCCESSFUL
Total time: 2 minutes 11 seconds
[james@james process_spaces]$

Restart all Server

change extendSoa=true to extendSoa=false and restart all the Servers and rerun the Ant Script

Import Group Spaces

[james@james process_spaces]$ /home/james/Oracle/Middleware/modules
/org.apache.ant_1.7.1/bin/ant -f install.xml -DpiArgs="-importGSOnly"
....
stop-webcenter:
      
      Initializing WebLogic Scripting Tool (WLST) ...
      
      Welcome to WebLogic Server Administration Scripting Shell
      
      Type help() for help on available commands
      
      Connecting to t3://james:7001 with userid weblogic ...
      Successfully connected to Admin Server 'AdminServer' 
that belongs to domain 'fmw_domain'.
      
      Warning: An insecure protocol was used to connect to the 
      server. To ensure on-the-wire security, the SSL port or 
      Admin port should be used instead.
      
      Shutting down the server WC_Spaces with force=true while 
connected to AdminServer ...
      .............

install-spaces:
     [echo] process portal installation completed. 
Please start the managed server now.

install:

BUILD SUCCESSFUL
Total time: 1 minute 10 seconds

VERY Important : Restart all Server

Embedded LDAP Configuration at Console

Open Console http://localhost:7001/console

Select fmw_domain -> Security -> Embedded LDAP tab, and Set Embedded Weblogic password as welcome1 or any password that you have decided for weblogic user, click on SAVE button.

VERY Important : Restart all the servers after this ,

UCM Configuration – WebCenter Content Configuration

Go to Content Server http://localhost:16200/

Accept Default Settings

Incoming Socket Connection Address Security Filter: 127.0.0.1|0:0:0:0:0:0:0:1|*.*.*.*
Server Socket Port : 4444

VERY Important : Restart UCM after this

Go to Content Server http://localhost:16200/  

login as weblogic and welcome1, configure Embedded LDAP

Go to Administration -> Providers -> Add LDAP Provider

VERY Important : Restart UCM after this

you must see 5 out of 5 connections are good for EmbeddedLDAP when you see more info here are the settings

Enable folder_g

Open Advanced Component Manager

VERY Important : Restart UCM after this

Go to Component Manager

NOTE : the following

Checked : ZipRenditionManagement
Checked :InboundRefinerySupport
Checked BpelIntegration
Checked DynamicConverter
Checked WebCenterConfigure
Un-Checked: FrameworkFolders

VERY Important : Restart Admin, UCM, WC Spaces Servers after this

EM Configurations for UCM, BPM and Worklist Documents

On Documents Tab of Spaces we see “The Documents service is unavailable.”, we will now try to resolve that in EM Configuration

Go to EM http://localhost:7001/em , then go to farm_fmw_domain -> Webcenter -> Content -> Content Server -> Oracle Webcenter Content -> Configuration tab.

Under server configuration give

HTTP Address james:16200

IP Filter: 127.0.0.1|0:0:0:0:0:0:0:1|*.*.*.*

Intradoc Server Port: 4444

Go to EM http://localhost:7001/em , then go to farm_fmw_domain -> Webcenter -> Portal -> Spaces -> webcenter -> Settings -> Server Configuration.

Add Content Repository Connection

Configuring UCM to BPM Document Attachments

Go to EM  http://localhost:7001/em , farm_fmw_domain -> right click -> Security -> Credentials

Create Map by Name WF-ADMIN-USER , Under that key as WF-ADMIN-CREDENTIAL give password for weblogic as welcome1

please refer the below picture.

Go to farm_fmw_domain -> SOA -> soa_infra -> SOA Infrastructure -> SOA Administration workflow config ->

You will see SOA Infrastructure Home > Workflow Notification Properties

Click on Workflow Task Service Properties


On the  page click on
More Workflow Taskservice Configuration Properties…  at the bottom
On this page, select node select:
-> Application Defined MBeans -> oracle.as.soainfra.config
-> Server: AdminServer ->  WorkflowConfig -> human-workflow (Select this node)
then on the right panel, select  UcmIdcUr
Set value pointing to UCM server as idc://localhost:4444
( if its some other IP or Port – please change it as it suits your system)

WorklistApplicationURL http://james:7001/integration/worklistapp/TaskDetails?taskId=PC_HW_TASK_ID_TAG

this would allow us to Attach Documents from BPM worklist into UCM

Time for Reality Check

lets login to EM and Trigger a sample bpm process , that collects some input parameters and assigns it to a user jstein

lets login to webcenter http://localhost:8888/webcenter  as jstein , check his documents and workflow process portal

lets check tasks in the workflow

Now lets Attach a Document to the Task and Approve

lets view the process Dashboard

BAM and Database EM Configurations

DATABASE Adapter Configurations : I assume that with the schema available in the source you have already created University Database, lets make it talk with Weblogic Server,  login to WLS Console, go to Data sources, create Generic Datasource by Name UniversityDS JNDI Name jdbc/UniversityDS

Under Configuration -> Connection Pool tab, give required parameters and Test for DB Connection

go to Deployments , Under DB Adapter create a new Outbound connection Pool , this comes under Configuration -> Outbound connection pools, this name should match the one thats defined in SOA Database Connection eis/DB/University

set xADataSourceName to jdbc/UniversityDS our pre-configured JNDI Name

Update the Database DBAdapter Deployment, No need to restart, Most often people forget this step.

BAM  Adapter Configurations: Go to Oracle BAM Adapter, ensure that eis/bam/soap outbound connection is defined

check the ports, if changed update BAM Adapter deployment

Settting up BAM with BPM process

Login to EM, Edit BPMNConfig.bpm , Disable Action = blank, see the below figure as to how to Navigate to BPMN Config MBeans

Edit  BAMICommandConfig.xml

:~/Oracle/Middleware/Oracle_SOA1/bam/config$ gedit BAMICommandConfig.xml

Add

<ICommand_Default_User_Name>weblogic</ICommand_Default_User_Name><ICommand_Default_Password>welcome1</ICommand_Default_Password>

just above

</BAMICommand>

Save the file. Next Run Monitoring Express Sample Scripts, these creates out of box available BPM Reports on BAM Dashboard

Ensure that the BAM Server is started

james@james:~/Oracle/Middleware/Oracle_SOA1/bam/samples/bam/monitorexpress/bin$ ./setup.sh


[james@james ~]$ cd Oracle/Middleware/Oracle_SOA1/bam/samples/bam/monitorexpress/bin
[james@james bin]$ ls
demo_env.bat demo_env.sh setup.bat setup.sh
[james@james bin]$ ./setup.sh
BAM Home =/home/james/Oracle/Middleware/Oracle_SOA1/bam
Using JAVA_HOME=
Creating the Data Objects
Oracle BAM Command Utility [Build 16734, BAM Repository Version 2025] Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.
Importing from file "/home/james/Oracle/Middleware/Oracle_SOA1/bam/samples/bam/monitorexpress/data_objects/MonitorExpress_DataObjects.xml".
Folder /Samples/Monitor Express created.
Creating Data Object "COMPONENT" in Folder "/Samples/Monitor Express"...
Data Object "/Samples/Monitor Express/COMPONENT" created.
Index "INSTANCE_IDS" created.
Index "ECID" created.
No Contents section to import.
Data Object imported successfully (0 rows).
Creating Data Object "INTERVAL" in Folder "/Samples/Monitor Express"...
Data Object "/Samples/Monitor Express/INTERVAL" created.
Index "UPDATE_INDEX" created.
No Contents section to import.
Data Object imported successfully (0 rows).
Creating Data Object "COUNTER" in Folder "/Samples/Monitor Express"...
Data Object "/Samples/Monitor Express/COUNTER" created.
Index "UPDATE_INDEX" created.
No Contents section to import.
Data Object imported successfully (0 rows).
"3" items imported successfully.
Data Objects successfully created
Creating the Reports..
Oracle BAM Command Utility [Build 16734, BAM Repository Version 2025]
Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.
Importing from file "/home/james/Oracle/Middleware/Oracle_SOA1/bam
/samples/bam/monitorexpress/reports/FaultReport.xml".
Report "/public/Report/Samples/Monitor Express/Sub-reports
/Fault Report" imported successfully.
"1" items imported successfully.
..
Oracle BAM Command Utility [Build 16734, BAM Repository Version 2025]
Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.
Importing from file "/home/james/Oracle/Middleware/Oracle_SOA1/bam
/samples/bam/monitorexpress/reports/MonitorProcessDetails.xml".
Report "/public/Report/Samples/Monitor Express/Sub-reports
/Monitored Process Details" imported successfully.
Finished updating references for Report"/public/Report
/Samples/Monitor Express/Sub-reports/Monitored Process Details".
"1" items imported successfully.
..
Oracle BAM Command Utility [Build 16734, BAM Repository Version 2025]
Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.
Importing from file "/home/james/Oracle/Middleware/Oracle_SOA1/bam
/samples/bam/monitorexpress/reports/MonitorExpressSummary.xml".
Report "/public/Report/Samples/Monitor Express/Sub-reports
/Monitoring Express Summary" imported successfully.
Finished updating references for Report"/public/Report/Samples
/Monitor Express/Sub-reports/Monitoring Express Summary".
"1" items imported successfully.
..
Oracle BAM Command Utility [Build 16734, BAM Repository Version 2025]
Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.
Importing from file "/home/james/Oracle/Middleware/Oracle_SOA1
/bam/samples/bam/monitorexpress/reports/MonitorExpressDashboard.xml".
Report "/public/Report/Samples/Monitor Express/Monitor Express Dashboard"
imported successfully.
Finished updating references for Report"/public/Report/Samples/Monitor Express/Monitor Express Dashboard".
"1" items imported successfully.
Reports successfully created
Setup ends successfully

RESULT : Login to BAM, You can see out of Box BPM based BAM reports

I need to fireup windows VM to load IE , which i really dont like doing as i am already running couple of Servers and this adds overhead to the memory. I tried Installing IETabs and Different IE versions like IE for Linux on Ubuntu and run them on WIne, Unfortunately none of those IE things ever worked on Linux. I would be looking forward to a day when i can run BAM reports on my Linux Machine with the same level of performance that BAM offers as of today.

Keep an Eye on Memory Usage

Running Database 11gR1 , SOA BPM as Admin Server, BAM , UCM and Webcenter + JDeveloper PS5 + SQL Developer (Ignore Open Browser Tabs)

Picture of EM

What Next ?

Art of Webcenter Templating

Back to Comprehensive Oracle Fusion middleware Solutions 

About the Author

Author profile