Installation Instructions for the Oracleas Provider for Jive Forum
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 Intertion 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 Uses)
The Following Portlets Are Bundled in with the distribution:
Forum Viewer Hot Topics Watch 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 ForumsInstallation 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 examplehttp:. // {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 Forum
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 With Oracleas OR A Standalone 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 Forum
In Order to Enable The Provider, The PROVIDER
Web.xml file located under
Restart Your
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: //
NOTE: IF YOUR JIVE HOME URL LOOKS LIKE
Http://my.company.com/jive3 the your provider URL Would Be
http://my.company.com/jive3/providers/forum
Publishing the Oracleas Provider for Jive Forum
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 Forum Using Oracle Applic ATION 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 EditionIf 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.
