Oracleas provider for Jive forums configuration process

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:

• View topics posted on their favorite forums
• Create a new topic or post a reply to one
• Search the Forums
• View the hot topics internal SS 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

• Setup and configure a standalone Solaris (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, withinOracleasproviderforjiveforums.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 locking 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 productname 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 inserting ing PDK-Java on different combinations of productname 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 Solaris instance ):

<Oc4j_instance>
|-> Applications
|-> Jive3	The application archive (optional)
|-> Jive3	The Web Archive (the directory to extract)
|-> 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 ). indexing ing the oracleas provider for Jive forumsin 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 shoshould be able to access the provider page, at http: // NOTE: If your jive home URL looks like http://my.company.com/jive3 then your provider URL wocould be http://my.company.com/jive3/providers/forumPublishing the oracleas provider for Jive forumsin 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 productname 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 using ing 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 productname instance or jive forums Professional Edition

If your jive forums application is deployed on a stand alone productname 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 creating ing jive forums as an external application.

The details about processing ing jive Forum Enterprise Edition with oracleas identity management and processing ing jive forums as an external application will be talked in the following articles. The picture below show the test result.