This chapter describes how to configure external services for WebCenter Portal applications using Fusion Middleware Control or WLST commands. For most external services, you must set up a connection between the WebCenter Portal application and the backend server.
This chapter contains the following sections:
Section 12.2, "Configuring the Discussions Server Connection"
Section 12.3, "Configuring the Instant Messaging and Presence (IMP) Server Connection"
Section 12.4, "Configuring a BPEL Server Connection for Worklists and Workflows"
Section 12.8, "Configuring the Mail Server for Notifications"
After installing WebCenter Portal you must attach the default Oracle Web Services Manager (OWSM) security policy to the following:
Spaces application (webcenter)
Discussions application (owc_discussions)
WebCenter Services Portlet Producer (services-producer)
WSRP Tools Producer (wsrp-tools)
These steps are required because security policies for these Web service end points are not configured out-of-the-box.
To attach the default Web service security policy:
Ensure that WC_Spaces1, WC_Spaces2, WC_Collaboration1, WC_Collaboration2, WC_Portlet1, and WC_Portlet2 managed servers are up and running.
Start the WebLogic Scripting Tool:
WCPHOST1> MW_HOME/wc/common/bin/wlst.sh
Connect to the Administration Server as an administrator.
For example:
connect("weblogic","admin password","ADMINVHN:7001")
For information, see the section "Running Oracle WebLogic Scripting Tool (WLST) Commands" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
Run WLST commands to attach the default OWSM security policy (oracle/wss10_saml_token_service_policy) to each of the following:
Spaces application (webcenter)
Discussions application (owc_discussions)
WebCenter Services Portlet Producer (services-producer)
WSRP Tools Producer (wsrp-tools)
To attach the default OWSM security policy to the Spaces Web service on each server in the cluster (WC_Spaces1 and WC_Spaces2), run the following WLST commands:
attachWebServicePolicy(application='/wcedg/WC_Spaces1/webcenter', moduleName='webcenter', moduleType='web', serviceName='SpacesWebService', subjectName='SpacesWebServiceSoapHttpPort', policyURI='oracle/wss10_saml_token_service_policy') attachWebServicePolicy(application='/wcedg/WC_Spaces2/webcenter', moduleName='webcenter', moduleType='web', serviceName='SpacesWebService', subjectName='SpacesWebServiceSoapHttpPort', policyURI='oracle/wss10_saml_token_service_policy')
To attach the default OWSM security policy to the discussions Web service on each server in the cluster (WC_Collaboration1 and WC_Collaboration2), run the following WLST commands:
attachWebServicePolicy(application='/wcedg/WC_Collaboration1/owc_discussions', moduleName='owc_discussions', moduleType='web', serviceName='OWCDiscussionsServiceAuthenticated', subjectName='OWCDiscussionsServiceAuthenticated', policyURI='oracle/wss10_saml_token_service_policy') attachWebServicePolicy(application='/wcedg/WC_Collaboration2/owc_discussions', moduleName='owc_discussions', moduleType='web', serviceName='OWCDiscussionsServiceAuthenticated', subjectName='OWCDiscussionsServiceAuthenticated', policyURI='oracle/wss10_saml_token_service_policy')
To attach the default OWSM security policy to the Services Producer's Web service end point on each server in the cluster (WC_Portlet1 and WC_Portlet2), run the following WLST commands:
attachWebServicePolicy(application='/wcedg/WC_Portlet1/services-producer#11.1.1.6.0', moduleName='services-producer', moduleType='web', serviceName='WSRP_v2_Service', subjectName='WSRP_v2_Markup_Service', policyURI='oracle/wss10_saml_token_service_policy') attachWebServicePolicy(application='/wcedg/WC_Portlet2/services-producer#11.1.1.6.0', moduleName='services-producer', moduleType='web', serviceName='WSRP_v2_Service', subjectName='WSRP_v2_Markup_Service', policyURI='oracle/wss10_saml_token_service_policy')
Run the following WLST commands to attach the default OWSM security policy to the WSRP Tools Producer's Web service end point on each server in the cluster (WC_Portlet1 and WC_Portlet2):
attachWebServicePolicy(application='/wcedg/WC_Portlet1/wsrp-tools#11.1.1.4.0', moduleName='wsrp-tools', moduleType='web', serviceName='WSRP_v2_Service', subjectName='WSRP_v2_Markup_Service', policyURI='oracle/wss10_saml_token_service_policy') attachWebServicePolicy(application='/wcedg/WC_Portlet2/wsrp-tools#11.1.1.4.0', moduleName='wsrp-tools', moduleType='web', serviceName='WSRP_v2_Service', subjectName='WSRP_v2_Markup_Service', policyURI='oracle/wss10_saml_token_service_policy')
Restart the WC_Spaces1, WC_Spaces2, WC_Collaboration1, WC_Collaboration2, WC_Portlet1, and WC_Portlet2 managed servers.
If you want to provide Discussions or Announcement services in a WebCenter Portal application you must connect the application to a discussions server. To configure a connection for the WebCenter Portal Enterprise Deployment, the following values are required:
Discussions Server URL: http://wcpinternal.mycompany.com/owc_discussions
Discussions Admin User: discussions server admin user name
Discussions Admin Password: discussions server admin password
Authenticated User Web Service Policy URI: WSS 1.0 SAML Token Client Policy
You can connect to a discussions server using Fusion Middleware Control or WLST commands:
Section 12.2.1, "Creating a Discussions Server Connection Using Fusion Middleware Control"
Section 12.2.2, "Creating a Discussions Server Connection using WLST"
For more information, see "Managing the Announcements and Discussions Services" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
Note:
If you want to provide Discussions or Announcement services you must also configure a security policy for the discussions Web service. For details, see Section 12.1, "Configuring Default Web Service Policies for Spaces, Discussions, and Portlet Producers".
To connect your WebCenter Portal application to a discussions server using Fusion Middleware Control:
Ensure that at least one of the managed server on which your application is deployed is up and running.
For example, for the Spaces application, one of the WC_Spaces managed servers.
Log on to the Enterprise Manager Fusion Middleware Control Console at http://SOAHOST1:7001/em.
Navigate to the home page for your WebCenter Portal application.
For example, to navigate to the home page for the Spaces application, select Farm_wcpedg_domain, WebCenter > Portal > Spaces, and then webcenter (WC_Spaces1).
From the WebCenter Portal drop-down menu, select Settings, and then Service Configuration.
Click Discussions and Announcements, and then Add.
In the Add Discussion and Announcement Connection screen:
Connection Name: DFConnection
Active Connection: Select this check box to enable the connection
Server URL: http://wcpinternal.mycompany.com/owc_discussions
Administrator User Name: Name of a discussions server user with admin permissions
Authenticated User Web Service Policy URI: Select WSS 1.0 SAML Token Client Policy (oracle/wss10_saml_token_client_policy)
Click OK to save the settings.
Restart the managed servers on which the application is deployed.
For the Spaces application, restart all the managed servers in the Spaces_Cluster.
To connect your WebCenter Portal application to a discussions server using the WebLogic Scripting Tool:
Start the WebLogic Scripting Tool:
WCPHOST1> MW_HOME/wc/common/bin/wlst.sh
In WLST, connect as the administrator.
For example:
connect("weblogic","admin password","ADMINVHN:7001")
Use the createDiscussionForumConnection command to connect to the discussions server.
For example:
createDiscussionForumConnection(appName="webcenter",name="DFConnection", url="http://wcpinternal.mycompany.com/owc_discussions", adminUser="weblogic_wc",default=1,policyURIForAuthAccess="oracle/wss10_saml_token_client_policy",server="WC_Spaces1")
Where webcenter is the name of the Spaces application deployed on WC_Spaces1 and weblogic_wc is the name of the discussions server admin user.
See also, "createDiscussionForumConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.
Restart the managed servers on which the application is deployed.
For the Spaces application, restart all the managed servers in the Spaces_Cluster.
For instructions how to configure Instant Messaging and Presence servers, see "Registering Instant Messaging and Presence Servers" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal
The Worklist service and workflows, such as Spaces membership workflows, require a connection to a BPEL server. To configure a connection for the WebCenter Portal Enterprise Deployment, the following value is required:
SOAP Server URL: http://wcpinternal.mycompany.com
You can connect to a BPEL server using Fusion Middleware Control or WLST commands:
Section 12.4.2, "Configuring Worklists and Workflow using Fusion Middleware Control"
Section 12.4.3, "Configuring Worklist and Workflow using WLST"
Before you connect your WebCenter Portal application to the BPEL server that will host the Worklist and Workflow application:
Complete prerequisites steps for the Worklist service.
For details, see "Back-End Requirements for the Worklist Service" in the Oracle Fusion Middleware Installation Guide for Oracle WebCenter Portal.
(Spaces application only) Complete prerequisites steps for the Spaces workflows.
For details, see "Back-End Requirements for WebCenter Portal: Spaces Workflows" in the Oracle Fusion Middleware Installation Guide for Oracle WebCenter Portal.
To connect your WebCenter Portal application to a BPEL server using Fusion Middleware Control:
Ensure that at least one of the managed server on which your application is deployed is up and running.
For example, for the Spaces application, one of the WC_Spaces managed servers.
Log on to the Enterprise Manager Fusion Middleware Control Console at http://SOAHOST1:7001/em.
Navigate to the home page for your WebCenter Portal application.
For example, to navigate to the home page for the Spaces application, select Farm_wcpedg_domain, WebCenter > Portal > Spaces, and then webcenter (WC_Spaces1).
Configure a Worklist connection:
From the WebCenter Portal drop-down menu, select Settings, and then Service Configuration.
Click Worklist, and then Add.
In the Add Worklist Connection screen:
Connection Name: WorklistConnection
Active Connection: Select check box to enable the connection for the Worklist service
BPEL SOAP URL: http://wcpinternal.mycompany.com
Click OK to save the settings.
(Spaces application only) Specify the BPEL server that is hosting the Spaces workflows:
From the WebCenter Portal drop-down menu, select Settings, and then Application Configuration.
From the Connection Name dropdown, choose the BPEL server connection where the workflows are deployed.
If the BPEL server connection you want is not listed, follow step 4 to set up the connection.
Click Apply to save the settings.
Restart the managed servers on which the application is deployed.
For the Spaces application, restart all the managed servers in the Spaces_Cluster.
To connect your WebCenter Portal application to a BPEL server, and specify a BPEL server for the Worklist service and Spaces workflows using WLST:
Start the WebLogic Scripting Tool:
WCPHOST1> MW_HOME/wc/common/bin/wlst.sh
In WLST, connect as the administrator.
For example:
connect("weblogic","admin password","ADMINVHN:7001")
Configure a BPEL server connection:
For example:
createBPELConnection(appName="webcenter", name="WorklistConnection", url="http://wcpinternal.mycompany.com",server="WC_Spaces1")
Where webcenter is the name of the Spaces application deployed on WC_Spaces1.
See also, "createBPELConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.
Configure the Worklist service to use the BPEL connection:
For example:
addWorklistConnection(appName="webcenter", name="WorklistConnection", verbose=1,server="WC_Spaces1")
See also, "addWorklistConnection" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.
(Spaces application only) Specify the connection that points to the BPEL server on which Spaces workflows are deployed.
For example:
setSpacesWorkflowConnectionName(appName="webcenter", name="WorklistConnection",server="WC_Spaces1") getSpacesWorkflowConnectionName(appName="webcenter",server="WC_Spaces1")
See also, "setSpacesWorklfowConnectionName" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.
Restart the managed servers on which the application is deployed.
For the Spaces application, restart all the managed servers in the Spaces_Cluster.
Several out-of-the-box portlet producers can be registered with WebCenter Portal applications. In the WebCenter Portal Enterprise Deployment, the required producer URLs are as follows:
WSRP Producer URL: http://wcpinternal.mycompany.com/wsrp-tools/portlets/wsrp2?WSDL
WebClipping Producer URL: http://wcpinternal.mycompany.com/portalTools/webClipping/providers
OmniPortlet Producer URL: http://wcpinternal.mycompany.com/portalTools/omniPortlet/providers
You can register portlet producers using Fusion Middleware Control or WLST commands:
Section 12.5.1, "Registering Out-of-the-Box Portlet Producers using Fusion Middleware Control"
Section 12.5.2, "Registering Out-of-the-Box Portlet Producers Using WLST"
For details on how to register portlet producers using Fusion Middleware Control, see "Managing Portlet Producers" in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
To register out-of-the-box portlet producers using WLST:
Start the WebLogic Scripting Tool:
WCPHOST1> MW_HOME/wc/common/bin/wlst.sh
In WLST, connect as the administrator.
For example:
connect("weblogic","admin password","ADMINVHN:7001",server="WC_Spaces1")
Register all three out-of-the-box WSRP and PDK-Java producers.
For example:
registerOOTBProducers(producerHost='wcpinternal.mycompany.com',producerPort=80, appName='webcenter', server='WC_Spaces1')
Where webcenter is the name of the Spaces application deployed on WC_Spaces1.
See also, "registerOOTBProducers" in Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.
If you want to expose WSRP and Oracle JPDK portlets and OpenSocial gadgets as pagelets in WebCenter Portal applications, you must register the Pagelet Producer. In the WebCenter Portal Enterprise Deployment, the required Pagelet Producer URL is:
http://wcpinternal.mycompany.com/pagelets
You can register the Pagelet Producer using Fusion Middleware Control or WLST commands Refer to the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal for detailed steps:
You can configure Oracle Secure Enterprise Search (Oracle SES) services and crawlers using procedures in "Managing Oracle SES Search in WebCenter Portal" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
Ensure that:
Oracle Secure Enterprise Search is registered with Oracle Internet Directory and the WebCenter Portal application is configured as an Oracle SES trusted entity, as described in "Oracle SES - Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
Connection exists between the WebCenter Portal application and Oracle Secure Enterprise Search, as described "Setting Up Oracle SES Connections" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
Ensure that any new URLs are added for both WEBHOST Oracle HTTP Server configurations as follows:
<Location /rsscrawl> WebLogicCluster WCPHOST1:9000,WCPHOST2:9000 SetHandler weblogic-handler </Location> <Location /sesUserAuth> WebLogicCluster WCPHOST1:9000,WCPHOST2:9000 SetHandler weblogic-handler </Location>
For details on how to set up the Notifications service for WebCenter Portal applications, refer to "Setting Up Notifications" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
In a WebCenter Portal Enterprise Deployment, if you choose to send notifications using mail you must set an additional property on the mail server connection named 'mail.user.emailAddress' which overrides any Sender Mail Address that is configured for mail notifications (that is, the 'From' field). If you do not set this additional property, one of the server names in the cluster appends to the Sender Mail Address, for example sender_mail_address@server1.
You can set additional properties for mail server connections using Fusion Middleware Control or WLST. For details, see:
For example, using WLST:
setMailConnectionProperty(appName='webcenter', name='myMail_Server_Connection_Name', key='mail.user.emailAddress', value='myShared_User_Email_Address')
Where:
myMail_Server_Connection_Name - Name of the mail server connection used by the Notification service.
myShared_User_Email_Address - The SHARED mail address. This is the mail address associated with the user specified in the external application's shared credentials. Ensure you can login with this mail address to your mail server.