Cookbook: SES and UCM setup
- by George Maggessy
The purpose of this post is to guide you setting up the integration between UCM and SES. On my next post I’ll show different approaches to integrate WebCenter Portal, UCM and SES based on some common scenarios. Let’s get started.
WebCenter Content Configuration
WebCenter Content has a component that adds functionality to the content server to allow it to be searched via the Oracle SES. To enable the component installation, go to Administration -> Admin Server and select SESCrawlerExport. Click the update button and restart UCM_server1 managed server.
Once the managed server is back, we’ll configure the component. In the menu, under Administration you should see SESCrawlerExport. Click on the link.
You’ll see the window below. Click on Configure SESCrawlerExport.
Configure the values below:
Hostname: SES hostname.
Feed Location: Directory where data feeds will be saved.
Metadata List: List of metadata that will be searchable by SES.
After updating the values click on the Update button. Come back to the SESCrawlerExport Administration UI and click on Take Snapshot button. It will create the data feeds in the specified Feed Location.
To check if the correct configuration was done, please access the following URL http://<ucm_server>:<port>/cs/idcplg?IdcService=SES_CRAWLER_DOWLOAD_CONFIG&source=default.
It should download config file in the format below:
<?xml version="1.0" encoding="UTF-8"?>
<rsscrawler xmlns="http://xmlns.oracle.com/search/rsscrawlerconfig">
<feedLocation><![CDATA[http://adc6160699.us.oracle.com:16200/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONTROL&source=default]]></feedLocation>
<errorFileLocation><![CDATA[http://adc6160699.us.oracle.com:16200/cs/idcplg?IdcService=SES_CRAWLER_STATUS&IsJava=1&source=default&StatusFeed=]]></errorFileLocation>
<feedType>controlFeed</feedType>
<sourceName>default</sourceName>
<securityType>attributeBased</securityType>
<securityAttribute name="Account" grant="true"/>
<securityAttribute name="DocSecurityGroup" grant="true"/>
<securityAttribute name="Collab" grant="true"/>
</rsscrawler>
Make sure Account and DocSecurityGroup values are true.
SES Configuration
Let’s start by configuring the Identity Plug-ins in SES. Go to Global Settings -> System -> Identity Management Setup. Select Oracle Content Server and click the Activate button.
We’ll populate the following values:
HTTP endpoint for authentication: URL to WebCenter Content. Notice that /cs/idcplg was added at the end of the URL.
Admin User: UCM Admin user. This user must have access to all CPOE content.
Password: Password to Admin user.
Authentication Type: NATIVE.
Go back to the Home tab and click on Sources on the top left. Select Oracle Content Server on the right and click the Create button.
Configuration URL: URL that point to the configuration file. Example: http://<ucm_hostname>:<port>/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default.
User ID: UCM Admin user.
Password: Password to Admin user.
Click on the Authorization tab and add the appropriate values to the fields below. Make sure you see the ACCOUNT and DOCSECURITYGROUP security attributes at the end of the page.
HTTP endpoint for authorization: http://<ucm_hostname>:<port>/cs/idcplg.
Display URL prefix: http://<ucm_hostname>:<port>/cs.
Administrator user: UCM Admin user.
Administrator password.
On the Document Types tab, add the documents that should be indexed by SES.
As our last step, we’ll configure the Federation Trusted Entities under Global Settings.
Entity Name: The user must be present in both the identity management server configured for your WebCenter application and the identity management server configured for Oracle SES. For instance, I used weblogic in my sample.
Password: Entity user password.\
Now you are ready to test the integration on the SES UI: http://<ses hostname>:<port>/search/query/.