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
[[email protected]james
bin]$ pwd
/home/james
/Oracle/PS5Installers/RCU/rcuHome/bin
[
RCU_JDBC_TRIM_BLOCKS=TRUEjames
james bin]$ export
[james
james 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 |
[[email protected] 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
[[email protected] 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
[[email protected] 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 [[email protected] process_spaces]$
Restart all Server
change extendSoa=true to extendSoa=false and restart all the Servers and rerun the Ant Script
Import Group Spaces
[[email protected] process_spaces]$ /home/james/Oracle/Middleware/modules /org.apache.ant_1.7.1/bin/ant -f install.xml -DpiArgs="-importGSOnly" .... stop-webcenter: [java] [java] Initializing WebLogic Scripting Tool (WLST) ... [java] [java] Welcome to WebLogic Server Administration Scripting Shell [java] [java] Type help() for help on available commands [java] [java] Connecting to t3://james:7001 with userid weblogic ... [java] Successfully connected to Admin Server 'AdminServer' that belongs to domain 'fmw_domain'. [java] [java] Warning: An insecure protocol was used to connect to the [java] server. To ensure on-the-wire security, the SSL port or [java] Admin port should be used instead. [java] [java] Shutting down the server WC_Spaces with force=true while connected to AdminServer ... [java] ............. 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
[email protected]:~/Oracle/Middleware/Oracle_SOA1/bam/samples/bam/monitorexpress/bin$ ./setup.sh
[[email protected] ~]$ cd Oracle/Middleware/Oracle_SOA1/bam/samples/bam/monitorexpress/bin
[[email protected] bin]$ ls
demo_env.bat demo_env.sh setup.bat setup.sh
[[email protected] 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