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 details on configuring discussions using WebCenter Spaces, see section 12.1.3 of the WebCenter Administration Guide. The required values for the WebCenter EDG configuration are as follows:

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

  • Admin User: the discussion server admin user name

  • Admin Password: the discussion server admin password

8.1.2 Configuring Discussions via 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>','SOAHOST1VHN1:7001')
    
  3. At the WebCenter App side, create the forum connection as follows, using WLST.

    Note:

    Note that the alias and passwords are those that were used in Section 6.16, "Configuring WS-Security for Discussion Server," when generating the keystore.
    createDiscussionForumConnection(appName='webcenter',name='Jive-DiscussionForu
    m',url=DF_URL,adminUser=DF_USER,secured=true,default=true)
    
    setDiscussionForumConnectionProperty('webcenter','Jive-DiscussionForum',key='k
    eystore.location', value='/u01/app/oracle/keystores/jive_client_certs.keystore')
    
    setDiscussionForumConnectionProperty('webcenter','Jive-DiscussionForum',key='k
    eystore.password', value='clientKeyStorePassword')
    
    setDiscussionForumConnectionProperty('webcenter','Jive-DiscussionForum',key='k
    eystore.type', value='jks')
    
    setDiscussionForumConnectionProperty('webcenter','Jive-DiscussionForum',key='e
    ncryption.key.alias', value='jive')
    
    setDiscussionForumConnectionProperty('webcenter','Jive-DiscussionForum',key='e
    ncryption.key.password',value='jive_password' 
    

8.1.3 Creating a Discussions Server Connection for WebCenter From EM

Create a Discussions Server connection for WebCenter from the EM:

  1. Log on to an EM instance, register your WebCenter domain.

  2. Log on to this WebCenter domain.

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

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

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

  6. Click OK to save the settings.

  7. Restart the WLS_Spaces managed server.

Once you log in to WebCenter, you are be SSO'ed to the Discussion server as well.

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 via the WebLogic Scripting Tool (WLST):

8.2.1 Configuring IMP using WebCenter Spaces

For details on configuring Instant Messaging and Presence using WebCenter Spaces, see section 11.2.3, Registering Instant Messaging and Presence Servers, 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>','SOAHOST1VHN1: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):

    > createIMPConnection(appName='webcenter', name='IMPService-OCMS', url='http://LBR_SVC:8011/', adapter='OCMS', domain='mydomain.com', default=true, server='WLS_Spaces1')
    > listIMPConnections(appName='webcenter',verbose=false)
    

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 the Oracle WebCenter Installation and Configuration Guide.

  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 the Oracle WebCenter Installation and Configuration Guide.

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 via WebCenter Spaces

For details on configuring Worklist via 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://soainternal.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 via WLST

To configure Worklist 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>','SOAHOST1VHN1:7001')
    
  3. Run the following commands in WLST to configure the worklist server connection:

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

    > setSpacesWorkflowConnectionName('webcenter','WebCenter-Worklist')
    > getSpacesWorkflowConnectionName('webcenter')
    

8.4 Configuring the Document Library Connection

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

Note:

This section assumes that Oracle Content Server has been installed in accordance with the instructions in Chapter 9, "Installing and Configuring Oracle Content Server."

8.4.1 Configuring the Document Library via WebCenter Spaces

For details on configuring the document library via WebCenter Spaces, see Section 11.3 of the WebCenter Administration Guide. The required values for the WebCenter EDG configuration are as follows:

  • Repository Type: Oracle Content Server

  • CIS Type: Socket

  • Server Host: wcinternal.mycompany.com

  • Server Port: 9054

8.4.2 Configuring the Document Library via WLST

To configure the document library 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>','SOAHOST1VHN1:7001')
    
  3. Run the following commands in WLST to configure the document library server connection:

    > createJCRContentServerConnection('webcenter', 'ucminstall', socketType='socket', serverHost='ucm.mycompany.com', serverPort='9054', isPrimary='true')
    > setDocumentsSpacesProperties('webcenter', spacesRoot='/<SPACES_ROOT>', applicationName='<APPNAME>', adminUserName='sysadmin')
    > listJCRContentServerConnections('webcenter',false)
    

8.5 Registering the Portlet Producers

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

8.5.1 Configuring the Portlet Producers via WebCenter Spaces

For details on configuring the portlet producers via WebCenter Spaces, see sections 13.2 and 13.3 of the WebCenter Administration Guide. 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.5.2 Configuring the Portlet Producers via WLST

To configure the portlet producers 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>','SOAHOST1VHN1: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)
    > listPDKJavaProducers('webcenter','wc-WebClipping1')
    > registerPDKJavaProducer('webcenter', 'wc-OmniPortlet1', 'http://wcinternal.mycompany.com/portalTools/omniPortlet/providers', serviceId='omniPortlet', timeout=500, establishSession=true)
    > listPDKJavaProducers('webcenter',name='wc-OmniPortlet1')
    > registerWSRPProducer('webcenter', 'wc-WSRPTools1', 'http://wcinternal.mycompany.com/wsrp-tools/portlets/wsrp2?WSDL', timeout=500)
    > listWSRPProducers('webcenter', 'wc-WSRPTools1')