I have just upgraded my 22.214.171.124 BPM to 126.96.36.199 (PS 6). There has been a lot of talk about this release as it provides lots of functionality on the BPM Composer. I was keen to have a loom at the new features such as web forms so I implemented a simple BPM process which utilises the web form. I got as far as creating the human task but when I wanted to add a Web Form the green + was disabled.
I'm not sure if this is an issue as part of the upgrade or it was something I did wrong. After a bit of investigation comparing another instance that was working I realised that the frevvo application was not deployed in the Weblogic Console. Once I manually deployed the frevvo application the web form was enabled. The location of the frevvo app is the following:
Oracle Process Accelerators help organizations reach process excellence faster. Process Accelerators are business process solutions developed with Oracle Business Process Management (BPM) Suite 11g. Process Accelerators can be deployed as-is, or extended to meet customer-specific requirements. In addition to expediting time-to-value for BPM deployments, Process Accelerators embody best practices and serve as blueprints for organizations that are developing process driven solutions with Oracle BPM Suite. Organizations adopting Process Accelerators not only improve the business process targeted by the Accelerators they deploy, but also have a unique opportunity to reach maturity in their process management initiative faster and with lower risk by applying Process Accelerator Best Practices and Patterns.
This blog post is to document the install procedures for Process Accelerators 188.8.131.52.3. In this release the following process are delivered:
Oracle Travel Request Management (TRM) - streamlines the travel request process
Oracle Document Routing and Approval (DRA) - streamlines the document approval process
Internal Service Request (ISR) - streamlines the service request process
Public Section Incident Reporting (PSIR) - streamlines the incident reporting process
Financial Services Loan Origination (FSLO) - streamlines the loan application approval process
There are also 2 process that have been released in preview mode:
Oracle Employee Onboarding (EOB)
Oracle Business Account Opening (BAO)
This post is to show the install steps for the Process Accelerators. Before you can start the install you must have the following environment installed.
Java Development Kit 1.6.0 and later
Oracle Database 11g
Oracle Weblogic Server 11g
Oracle SOA Suite 11g
Oracle Business Process Management (BPM) Studio 11g Release 1 (184.108.40.206.0)
Oracle Business Activity Monitoring (BAM) 11g
Oracle Webcenter Content Release 1 (220.127.116.11.0) - Required for Document Routing and Approval accelerator.
There are lots of sites out there that document how to install these products, for the purpose of this post it is assumed that these products are installed and have been configured. My configuration I installed Webcenter and SOA / BPM on separate machines. Here is a screenshot of the domain configuration.
I have OSB installed here, this is not required for the PAs so you can ignore.
Login to the Enterprise Manager control for Webcenter domain
Navigate to WC_Domain -> Webcenter -> Content -> Content Server
From the menu select Configuration and make the following changes
If you have separate domains for WC and BPM login to Enterprise Manager Control for the SOA / BPM Domain. Expand SOA then select soa-infra
From the SOA Infrastructure menu, select SOA Administration -> Workflow Config, then select the More Workflow Notification Configuration Properties... link
In the System MBean Browser tree, expand WorkflowConfig, then select human-workflow
On the Attributes tab, in the UcmIdcUrl Value field, enter idc://ucmhost:4444 (4444 was the port I entered in step 2).
Navigate to Farm_soa_domain -> Weblogic Domain -> soa_domain. Right-click the soa_domain and select Security -> Credentials
Select WF-ADMIN-USER, then click Create Key
On the Create Key dialog box:
Ensure that Select Map field is set to WF-ADMIN-USER
In the Key field, enter WF-ADMIN-CREDENTIAL
In the User Name field, enter a user name with administrative privileges on the OWC server
In the Password and Confirm Password fields, enter a password for a user with administrative privileges on the OWC server
Restart All Servers to make sure that all these changes have taken place.
You should now be in a position to install the Process Accelerators. The documentation that comes with the process accelerators is pretty good. To save myself lost of documentation I will point to certain steps within the document to execute.
Download the documents zip file for the process accelerators OraclePADocumentation111163.zip
Open the file paaig.pdf
Skip all steps till you get to 2.1.2 Configure Oracle Business Activity Monitoring for Reports. Execute all steps for 2.1.2 so your BAM environment is configured.
Execute all steps in the 2.2 Installing Oracle Process Accelerators and Oracle BAM Reports. The install gets to 97% fairly quickly, it will sit at running post install scripts for up to 90 or so minutes. If you want to see what is happening you can tail the install script. Please note my process accelerator home is: $MW_HOME/PAHome
If you get a BUILD FAILED then you will need to install manually. Go to Step 2.4 provides the steps to do this. I undeploy the process accelerators before I resinstall, here are the steps I take.
Run the commands cd $MW_HOME/PAHome/bin . env.sh ant uninstall-pa
start a database session as sys sqlpuls / sysdba SQL>drop user accelerators cascade; SQL>exit
Restart all environments - this is required to clear some of the external applications from Weblogic
cd $MW_HOME/PAHome/bin . env_sh ant install-pa
Once you have a build successful you can complete the post install steps.
Starting at Section 3, complete all steps in 3.1. Here is an example of the users I assigned to each role in the BPM workspace. If the users don't exist in your environment follow this link.
In Section 3.2 there are some tricks that will impact on what will and what won't display. This is what I did. In the Weblogic console create the following Groups under Security Realms -> myrealm -> Users and Groups
Add the appropriate users to the following groups:
BPMExternalApp = Any user you want to add to have access to the External Apps
Now you need to add access to the Applications in EM. Here is the list of applications that require security attached:
To attach security to these applications login to the Enterprise Manager Control for SOA and navigate to Farm_soa_domain -> Application Deployments. Select one of the applications mentioned above. From the Application Deployment menu select Security -> Application Roles.
To add users / groups to the Application click the search button this will display the role. Select the Role and add a User / Group by clicking the Edit button.
In all instances I added the group BPMExternalApp to the Application roles with the exception of the IncidentReportingAdminUI(V2.0) and IncidentReportingTaskUI(V2.0) applications, for these applications I assign the groups created in step 9 matching the role to the group.
It is important that you don't assign the same role / user to all the roles as some roles will overwrite another giving unpredictable results.
This completes section 3 in the Install document
There are a number of steps in section 4 that have already been performed as part of the prerequisites. These do not need to be done again. The following steps can be skipped:
Section 4.3, "Adding New Application Roles in Oracle BPM Workspace"
In Section 4.6, "Packaging FOP for PDF Generation" there is a bug when you run the ant script. the first thing it tries to do is undeploy. As you haven't installed it the process fails. You need to make a minor change to the ant build file.
Open the following file with vi
Go to the line 195 with the command
There you will see that there is the parameter for undeploy when it errors it will stop the process change this to false, e.g. before:
This issue is caused by the ADF worklist projects in your BPM process. Therefore for each ADF project in your BPM process you need to modify the weblogic.xml file to add the oracle.soa.worklist.webapp library which seems to be a requirement in the new release of 18.104.22.168. In JDeveloper 22.214.171.124 it adds it automatically so you don't need to worry about it for new projects.
The weblogic.xml is found in the ADF worklist project:
Web Content > WEB-INF > weblogic.xml
Open the weblogic.xml in source mode and add the following code at the bottom just before the </weblogic-web-app> tag.