OracleAS Provider For Jive Forums 配置流程

Installation Instructions for the OracleAS
Provider for Jive Forums

Introduction

The Oracle Application Server (OracleAS) Provider for Jive Forums (http://www.jivesoftware.com/products/forums/) contains five portlets that expose Jive Forums Application content within OracleAS Portal.  The portlets provide OracleAS Portal users with seamless, high-level interaction between the two applications. The portlets allow users to:

• View topics posted on their favorite forums
• Create a new topic or post a reply to one
• Search the forums
• View the hot topics across all forums
• View all topics, forums, categories and users being watched by the user
• View top reward points earners
• Administer the Jive Forums Application (Only admin users)

The following portlets are bundled in with the distribution:

• Forum Viewer
• Hot Topics
• Watched Items
• Rewards
• Admin

This document serves as an installation and configuration guide for the OracleAS Provider for Jive Forums. It explains how to

• Setup and configure a standalone OC4J (Oracle Containers for J2EE) instance to run the OracleAS Provider for Jive Forums
• Deploy and register the OracleAS Provider for Jive Forums (included in this download) with OracleAS Portal

The portlets.zip file, within the OracleASProviderForJiveForums.zip (as shown in the above table), contains the provider and portlets details, which needs to be deployed to the Jive Forum Application's web-archive.  It conforms to the following directory structure:

portlets.zip

|-> htdocs

|-> images

|-> WEB-INF

|-> deployment

|-> lib

|-> providers

|-> forum

Installing the OracleAS Provider for Jive Forums

Installation of the OracleAS Provider for Jive Forums involves deploying the provider, then configuring it to work with your portal, and then registering the provider with your Portal.   Before beginning the installation of the OracleAS Provider for Jive Forums please ensure you have completed the PDK-Java installation and configuration. You can verify that PDK-Java is configured within the same instance of a standalone OC4J as the Jive Forums application by running the Provider test page URL, for example http://{server}:{port}/jpdk/providers/sample. If this URL shows up the list of all sample portlets, your PDK-Java setup is fine. If not, please see the article above that explains configuring PDK-Java on different combinations of OC4J instances.

Deploying the OracleAS Provider for Jive Forums

The portlets.zip file contains the files required for deploying the OracleAS Provider for Jive Forums onto your Oracle Application Server. This zip file needs to be extracted in to the Jive web-archive, so that the provider can leverage the Jive Forums functionality. Thus, if your Jive Forum application deployment structure is as follows (OC4J_Instance either within OracleAS or a Standalone OC4J instance):

<OC4J_Instance>
|-> applications
|->jive3	the application archive (optional)
|-> jive3	the web archive (the directory to extract to)
|->admin/ |->help/ |->images/ etc.	all the jive specific directories

Extract the content of the portlets.zip file to the jive3 web archive directory (marked in bold red in the above table).

Configuring the OracleAS Provider For Jive Forums

In order to enable the provider, the web.xml file located under <OC4J_Instance>/applications/jive3/jive3/WEB-INF/ needs to be modified to add the following entries.

<servlet>
    <servlet-name>SOAPServlet</servlet-name>
    <servlet-class>oracle.webdb.provider.v2.adapter.SOAPServlet</servlet-class>
</servlet>
<servlet>
    <servlet-name>JiveLogin</servlet-name>
    <servlet-class>oracle.webdb.ohs.forum.portlet.ExternalAppLoginServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>JiveLogin</servlet-name>
    <url-pattern>/extAppLogin</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>SOAPServlet</servlet-name>
    <url-pattern>/providers</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>SOAPServlet</servlet-name>
    <url-pattern>/providers/*</url-pattern>
</servlet-mapping>

Restart your <OC4J_Instance>after modifying the web.xml file.  

Testing the Deployment

If the deployment and configuration went through successfully, then you should be able to access the provider page, at http://<host>:<port>/<jiveContext>/providers/forum, which would give you a list of all the available portlets.  If any errors occur, then check your JPDK installation again and retry the install.

Note: If your Jive Home url looks like http://my.company.com/jive3 then your provider url would be http://my.company.com/jive3/providers/forum

Publishing the OracleAS Provider For Jive Forums

In order to provide seamless integration between Jive Forums and OracleAS Portal, a single entry point needs to be provided, so that users do not need to authenticate against the Jive Forums application once he has authenticated against OracleAS Portal. The steps involved depend upon whether your Jive Forums are deployed on an OracleAS instance, whether it is deployed on a standalone OC4J instance, or whether it is the Professional Edition.

• Jive Forums Deployed on an OracleAS Instance (Jive Forum Enterprise Editions only)

If your Jive Forums Application is deployed on the OracleAS instance, then it is possible to leverage Single Sign-On features by delegating the authentication function to the mod_osso module (an authentication module on the Oracle HTTP server). In order to leverage this functionality you will also need to configure Jive Forums to leverage Oracle Identity Management for maintaining the user credentials. For further details, see Configuring Jive Forums using Oracle Application Server Identity Management.

Note: Jive Forum Professional Editions need to be configured as External Applications, since they do not support LDAP based authentication.

• Jive Forums Deployed on a standalone OC4J Instance or Jive Forums Professional Edition

If your Jive Forums Application is deployed on a stand alone OC4J instance or you are using Jive Forums Professional Edition, then Single Sign-On can be achieved by registering Jive Forums as an External Application with OracleAS Portal. For further details, see Configuring Jive Forums as an External Application.

The details about Configuring Jive Forum Enterprise Edition with OracleAS Identity Management and Configuring Jive Forums as an External Application will be talked in the following articles. The picture below show the test result.