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

For details on configuring discussions via 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> ORACLE_BASE/product/fmw/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 discussion forum connection:

    > createDiscussionForumConnection(appName='webcenter', name='Discussions-1', url='http://wcinternal.mycompany.com/owc_discussions', adminUser='<admin user>', default=true, server='WLS_Spaces1')
    > listDiscussionForumConnections(appName='webcenter',verbose=false)
    

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

For details on configuring Instant Messaging and Presence via WebCenter Spaces, see section 12.2.3 of the WebCenter Administration Guide. 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> ORACLE_BASE/product/fmw/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> ORACLE_BASE/product/fmw/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> ORACLE_BASE/product/fmw/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> ORACLE_BASE/product/fmw/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')