4 Integrating Your Portal with Autonomy Search

This chapter discusses how to integrate your portal enterprise application to use Autonomy search. To do so, you must configure your application to use the sample Autonomy integration code provided with the Oracle WebLogic Portal installation.

Note:

For more information on configuring full text search, see "Adding Full Text Search Capabilities to Oracle WebLogic Portal" in the Oracle Fusion Middleware Content Management Guide for Oracle WebLogic Portal

You can also configure Oracle WebLogic Portal to perform full-text searches against content in an Oracle WebCenter Content-based repository. WebCenter Content repositories include built-in support for full text search in Oracle WebLogic Portal. For more information on Oracle Universal Content Management, see Oracle WebLogic Portal UCM VCR Adapter Guide for Oracle WebLogic Portal.

If you would like to use Autonomy Enterprise Search, you must first purchase the required license and obtain the binaries from Autonomy Corporation at http://www.autonomy.com.

Note:

Before integrating the Autonomy sample implementation, you must configure your portal to use Autonomy search. For details, see Chapter 3, "Configuring Your Portal to Use Autonomy Search."

To configure your application to use the sample Autonomy integration code, you must perform the following procedures in the order listed:

Section 4.1, "Adding the Autonomy Sample Implementation to the Portal Enterprise Application"
Section 4.2, "Modifying the Oracle WebLogic Server Start Script to Start the Autonomy Search Engine"

4.1 Adding the Autonomy Sample Implementation to the Portal Enterprise Application

The Autonomy sample implementation is code that enables Oracle WebLogic Portal to use the Autonomy search engine for full-text search requests against an Oracle WebLogic Portal content repository.

To add the Autonomy sample implementation to the portal enterprise application:

Stop Oracle WebLogic Server, if it is currently running.
Copy the Autonomy sample implementation file—autonomy-impl.jar—and paste the it into your portal enterprise application's APP-INF/lib directory.

The autonomy-impl.jar file is located in the <WLPORTAL_HOME>/samples/lib directory on the machine on which Oracle WebLogic Portal is installed.

Note:

If you want to change the default behavior of the sample Autonomy implementation, you can modify the source code, compile it, then add the modified, compiled code—instead of the autonomy-impl.jar file—to the portal enterprise application.

The source code is located in the autonomy-impl-src.zip file, which is located in the <WLPORTAL_HOME>/samples/lib/ directory on the machine on which Oracle WebLogic Portal is installed.
Navigate to the content-config.xml file, located in the portal enterprise application's META-INF/ directory.
Edit the content-config.xml file.

Define one search engine manager repository property for each repository that will use Autonomy for full-text search, using the following example code (note that the name of the property must be cm_searchEngineManager). The AutonomyClient46Manager class is part of the Autonomy integration sample code.
```
<repository-property>
<description>Specify the search engine manager class.</description> 
<name>cm_searchEngineManager</name>
<value>com.bea.content.repo.server.logic.search.AutonomyClient46Manager</value>
</repository-property> 
```
Navigate to the p13n-config.xml file, located in the portal enterprise application's META-INF/ directory.
Edit the p13n-config.xml file to define an event service listener for the Autonomy integration code, using the following example code:
```
<event-service>
<listener>com.bea.content.repo.server.logic.search.ContentExporterListener</listener>
</event-service> 
```

4.2 Modifying the Oracle WebLogic Server Start Script to Start the Autonomy Search Engine

After adding the Autonomy sample implementation to the portal enterprise application, you have the option to modify the Oracle WebLogic Server start script so that it also starts the Autonomy search engine. To do so:

Navigate to the Oracle WebLogic Server start script in the portal enterprise application domain's bin directory. The Oracle WebLogic Server start script has the following file name:
- LINUX/UNIX: startWebLogic.sh
- Windows: startWebLogic.cmd
An example path to the Oracle WebLogic Server start script is: <DOMAIN_HOME>/bin/start/startWebLogic.sh
Edit the Oracle WebLogic Server start script by adding the command to stop the Autonomy search engine, using the following guidelines:
- The Autonomy search engine has the following file name:
  - LINUX/UNIX: autonomy.sh
  - Windows: autonomy.cmd
- Following is an example of the command used to stop the Autonomy search engine:
  - LINUX/UNIX:
```
${WLPORTAL_HOME}/content-mgmt/thirdparty/autonomy-wlp10/autonomy.sh stop 
```
  - Windows:
```
${WLPORTAL_HOME}/content-mgmt/thirdparty/autonomy-wlp10/autonomy.cmd stop 
```
  Note:
  
  The path in the example is based on an upgraded Oracle WebLogic Portal domain. If you performed a clean installation of Oracle WebLogic Portal and installed Autonomy separately from Oracle WebLogic Portal, the path in your environment might differ from the example. For this reason, you should change the path in your environment accordingly.
- Following is an example fragment of the Oracle WebLogic Server start script, including the command to stop the Autonomy search engine; this command appears in bold. Note that the code in your Oracle WebLogic Server start script might differ from the code included in the example. For this reason, ensure that you add the command to the appropriate line of code in your Oracle WebLogic Server start script.
```
${WLPORTAL_HOME}/content-mgmt/thirdparty/autonomy-wlp10/autonomy.sh stop
ALREADY_STOPPED="true"
# Restore IP configuration the node manager starts IP Migration
if [ "${SERVER_IP}" != "" ] ; then
${WL_HOME}/common/bin/wlsifconfig.sh -removeif "${IFNAME}" "${SERVER_IP}"
fi
```
Note:

The path in the example is based on an upgraded Oracle WebLogic Portal domain. If you performed a clean installation of Oracle WebLogic Portal and installed Autonomy separately from Oracle WebLogic Portal, the path in your environment might differ from the example. For this reason, you should change the path in your environment accordingly.
Edit the Oracle WebLogic Server start script by adding the command to start the Autonomy search engine, using the following guidelines:
- Following is an example of the command used to start the Autonomy search engine:
  - LINUX/UNIX:
```
${WLPORTAL_HOME}/content-mgmt/thirdparty/autonomy-wlp10/autonomy.sh start 
```
  - Windows:
```
${WLPORTAL_HOME}/content-mgmt/thirdparty/autonomy-wlp10/autonomy.cmd start 
```
  Note:
  
  The path in the example is based on an upgraded Oracle WebLogic Portal domain. If you performed a clean installation of Oracle WebLogic Portal and installed Autonomy separately from Oracle WebLogic Portal, the path in your environment might differ from the example. For this reason, you should change the path in your environment accordingly.
- Following is an example fragment of the Oracle WebLogic Server start script, including the command to start the Autonomy search engine; this command appears in bold. Note that the code in your Oracle WebLogic Server start script might differ from the code included in the example. For this reason, ensure that you add the command to the appropriate line of code in your Oracle WebLogic Server start script.
```
# Start Autonomy
${WLPORTAL_HOME}/content-mgmt/thirdparty/autonomy-wlp10/autonomy.sh start

JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"

SAVE_JAVA_OPTIONS=""

CLASSPATH="${SAVE_CLASSPATH}"

SAVE_CLASSPATH=""
```
Note:

The path in the example is based on an upgraded Oracle WebLogic Portal domain. If you performed a clean installation of Oracle WebLogic Portal and installed Autonomy separately from Oracle WebLogic Portal, the path in your environment might differ from the example. For this reason, you should change the path in your environment accordingly.
Start Oracle WebLogic Server using the updated Oracle WebLogic Server start script.

The Oracle WebLogic Server start script starts the Autonomy search engine in addition to Oracle WebLogic Server.