Skip Headers
Oracle® Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter
11g Release 1 (11.1.1)

Part Number E12037-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

8 Configuring External Services

Configuring external services involves establishing a connection from the WebLogic domain to the location of the external service. This chapter describes how to configure the services using WebCenter Spaces or the WebLogic scripting tool (WLST).

This chapter contains the following sections:

8.1 Configuring the Discussion Forum Connection

The discussion forum connection can be configured using either WebCenter Spaces or via the WebLogic Scripting Tool (WLST):

8.1.1 Configuring Discussions using WebCenter Spaces

For additional information on configuring Discussions Server connections, see Chapter 12 "Managing the Announcements and Discussions Services" of the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

The required values for the WebCenter EDG configuration are as follows:

  • Server URL: http://wcinternal.mycompany.com/owc_discussions

  • Admin User: the discussions server admin user name

  • Admin Password: the discussions server admin password

8.1.2 Configuring Discussions using WLST

To configure discussions via the WebLogic Scripting Tool, complete these steps:

  1. Start the WebLogic Scripting Tool:

    WCHOST1> MW_HOME/wc/common/bin/wlst.sh
    
  2. In WLST, connect as the administrator:

    > connect('weblogic','admin password','ADMINVHN:7001',server='wc_spaces1')
    
  3. Create the forum connection as follows, using WLST.

    > createDiscussionForumConnection(appName='webcenter',name='Jive-DiscussionForum',url=DF_URL,adminUser=DF_USER,default=true,server='wc_spaces1')
    

8.1.3 Creating a Discussions Server Connection for WebCenter From EM

To create a Discussions Server connection for WebCenter from Enterprise Manager:

  1. Ensure that at least one of the WebCenter Spaces Managed Servers is running.

  2. Log on to the Enterprise Manager Fusion Middleware Control Console at http://SOAHOST1:7001/em.

  3. From the menu on the left, select Farm_wcedg_domain, WebCenter, WebCenter Spaces, and then webcenter(11.1.1.4.0) (wc_spaces1)to go to the WebCenter Spaces page.

  4. From the WebCenter Spaces WebCenter drop-down menu, select Settings, and then Service Configuration.

  5. Click Discussions and Announcements, and then on Add.

  6. In the Add Discussion and Announcement Connection screen, enter the name (DFConnection), service URL (http://<host>:<port>/owc_discussions) and administrator user name.

  7. Click OK to save the settings.

  8. Restart the WC_Spaces managed servers.

8.2 Configuring the Instant Messaging and Presence (IMP) Server Connection

The Instant Messaging and Presence (IMP) connection can be configured using either WebCenter Spaces or using the WebLogic Scripting Tool (WLST):

Note:

This section assumed that a Messaging and Presence Server has been installed and configured. The procedures for Messaging and Presence Server installation and configuration are not documented in this guide.

8.2.1 Configuring IMP using WebCenter Spaces

For details on configuring Instant Messaging and Presence using WebCenter Spaces, see Chapter 15 "Managing the Mail Service" of the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. The required values for the WebCenter EDG configuration are as follows:

  • Connection Type: OWLSC

  • Domain: the domain of the presence server configured when installed

  • Server URL: http://LBR_SVC:8011/

8.2.2 Configuring IMP via WLST

To configure IMP via the WebLogic Scripting Tool, complete these steps:

  1. Start the WebLogic Scripting Tool:

    WCHOST1> MW_HOME/wc/common/bin/wlst.sh
    
  2. In WLST, connect as the administrator:

    > connect('weblogic','admin password','ADMINVHN:7001')
    
  3. Run the following commands in WLST to configure the IMP connection (please note that the URLs and domains are examples; you should substitute them with values appropriate to your Presence Server installation):

    > createExtAppConnection(appName='webcenter',name='OCS_xApp',displayName='OCS',authMethod='POST',server='wc_spaces1')
    > addExtAppField(appName='webcenter',name='OCS_xApp',fieldName='Account',displayToUser=true,server='wc_spaces1')
    > createIMPConnection(appName='webcenter',name='myOCSPresenceServer',adapter='OCS2007', url='http://LBR_SVC:8011/',appId='OCS_xApp',userDomain='OCS',poolName='POOL_HOST', timeout=60, default=true,server='wc_spaces1') 
    
    > listIMPConnections(appName='webcenter',verbose=false,server='wc_spaces1')
    

8.3 Configuring the Worklist and Workflow Server Connection

Before configuring the connection to the BPEL Server which will host the Worklist and Workflow application, there are several prerequisites that need to be met:

  1. The backend requirements for WebCenter Spaces workflows must be completed. This includes the deployment of WebCenter Spaces workflows. These steps can be found in Chapter 22 "Managing External Applications" of the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

  2. The keystores for the WebCenter and SOA servers must be generated. In particular, the steps for configurations when SOA and WebCenter are installed in the same domain must be followed. These steps can be found in Chapter 27 "Securing WebCenter Applications and Components with SSL" of the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

The Worklist Server connection can be configured using either WebCenter Spaces or via the WebLogic Scripting Tool (WLST):

8.3.1 Configuring Worklist and Workflow using WebCenter Spaces

For details on configuring Worklist using WebCenter Spaces, see section 12.5.2.2 of the WebCenter Administration Guide. The required values for the WebCenter EDG configuration are as follows:

  • SOAP Server URL: http://wcinternal.mycompany.com

For details on configuring Workflow, please ensure the prerequisites have been met according to section 4.7 of the Oracle Fusion Middleware Installation Guide for Oracle WebCenter 11g Release 1 (11.1.1). In particular, ensure that WebCenter Spaces Workflow has been deployed on the SOA Server.

8.3.2 Configuring Worklist and Workflow using WLST

To configure Worklist using the WebLogic Scripting Tool, complete these steps:

  1. Start the WebLogic Scripting Tool:

    WCHOST1> MW_HOME/wc/common/bin/wlst.sh
    
  2. In WLST, connect as the administrator.

    > connect('weblogic','admin password','ADMINVHN:7001')
    
  3. Run the following commands in WLST to configure the worklist server connection:

    > createBPELConnection('webcenter', 'WebCenter-Worklist', 'http://wcinternal.mycompany.com',server='wc_spaces1')
    > addWorklistConnection('webcenter','WebCenter-Worklist',true,server='wc_spaces1')
    > listWorklistConnections('webcenter',false,server='wc_spaces1')
    
  4. Run the following commands in WLST to configure this same connection as the workflow connection:

    > setSpacesWorkflowConnectionName('webcenter','WebCenter-Worklist',server='wc_spaces1')
    > getSpacesWorkflowConnectionName('webcenter',server='wc_spaces1')
    

8.4 Registering the Portlet Producers

The portlet producers can be configured using either WebCenter Spaces or using the WebLogic Scripting Tool (WLST):

8.4.1 Configuring the Portlet Producers using WebCenter Spaces

For details on configuring the portlet producers using WebCenter Spaces, see sections 13.2 and 13.3 of the WebCenter Administration Guide Chapter 23 "Managing Security" of the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. The required values for the WebCenter EDG configuration are as follows:

  • WSRP WSDL URL: http://wcinternal.mycompany.com/wsrp-tools/portlets/wsrp2?WSDL

  • WebClipping URL: http://wcinternal.mycompany.com/portalTools/webClipping/providers

  • OmniPortlet URL: http://wcinternal.mycompany.com/portalTools/omniPortlet/providers

8.4.2 Configuring the Portlet Producers Using WLST

To configure the portlet producers using the WebLogic Scripting Tool, complete these steps:

  1. Start the WebLogic Scripting Tool:

    WCHOST1> MW_HOME/wc/common/bin/wlst.sh
    
  2. In WLST, connect as the administrator.

    > connect('weblogic','admin password','ADMINVHN:7001')
    
  3. Run the following commands in WLST to configure the portlet producers:

    > registerPDKJavaProducer('webcenter', 'wc-WebClipping1', 'http://wcinternal.mycompany.com/portalTools/webClipping/providers', serviceId='webClipping', timeout=500, establishSession=true),server='wc_spaces1')
    > listPDKJavaProducers('webcenter','wc-WebClipping1',server='wc_spaces1')
    > registerPDKJavaProducer('webcenter', 'wc-OmniPortlet1', 'http://wcinternal.mycompany.com/portalTools/omniPortlet/providers', serviceId='omniPortlet', timeout=500, establishSession=true,server='wc_spaces1')
    > listPDKJavaProducers('webcenter',name='wc-OmniPortlet1')
    > registerWSRPProducer('webcenter', 'wc-WSRPTools1', 'http://wcinternal.mycompany.com/wsrp-tools/portlets/wsrp2?WSDL', timeout=500,server='wc_spaces1')
    > listWSRPProducers('webcenter', 'wc-WSRPTools1',server='wc_spaces1')
    

8.5 Configuring WebCenter for Analytics

To configure Oracle WebCenter to send events to the Analytics Collector cluster:

  1. Start WLST:

    ORACLE_HOME/common/bin/wlst.sh
    
  2. Connect to the Administration Server:

    connect('Admin_username', 'Admin_password', 'ADMINVHM:7001')
    
  3. Create the Analytics Collector Connection and make it the default connection:

    > createAnalyticsCollectorConnection('webcenter', connectionName='local-collector1', isUnicast=0, , clusterName='EDGCluster', collectorPort=31313, isEnabled=1, timeout=30, default=1,server='wc_spaces1')
    
  4. List and verify the changes made:

    listDefaultAnalyticsCollectorConnection('webcenter',server='wc_spaces1')
    
  5. Exit WLST shell

    exit()
    
  6. Restart the Spaces Managed Servers.

  7. Restart the Utilities Managed Servers.

8.6 Configuring Search Services

You can configure Search Services and crawlers using the procedures in Chapter 21 of the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

Ensure that:

Ensure that any new URLs are added to both the WEBHOST HTTP Server configurations as follows:

<Location /rsscrawl>
 WebLogicCluster WCHOST1:9000,WCHOST2:9000
 SetHandler weblogic-handler
</Location>

<Location /sesUserAuth>
 WebLogicCluster WCHOST1:9000,WCHOST2:9000
 SetHandler weblogic-handler
</Location>