Jive Forums is a powerful online discussion tool for websites. This
document will guide you through installing the application. For a full
list of features and more information, please visit the Jive Software
website: http://www.jivesoftware.com
In order to install Jive Forums, you'll need a server environment that meets the following requirements:
- A servlet engine with JSP 1.2 and Servlet 2.3 support.
- JDK 1.4.x or later (JDK
1.5 or newer highly recommended).
- A supported database with a robust JDBC 2.0 compliant driver.
Supported databases and recommended JDBC drivers are detailed in the
database documentation below.
Installation Overview
To complete the installation of Jive Forums, you'll need to perform each of the following steps:
- Application Server - Set up your application server by installing the application files and JDBC driver. Be sure to read the Known Issues section of this document.
- Database - Prepare your database for Jive Forums.
- Setup and Admin Tools - Use the web-based
setup tool to establish a database connection and to setup the
administrator account. You'll then use the admin tool to create and
manage forums.
! If you're upgrading from a previous release of Jive Forums, please see the upgrade instructions.
Files in the Distribution
The files in your distribution should be as follows (some sub-directories omitted for brevity):
jive/
|- database/
|- documentation/
|- jiveHome/
|- changelog.html
|- EditWAR.jar
|- issues.html
|- jiveforums.war
|- README.html
The jiveforums.war file is a standard Web Application Archive (WAR) that contains the Jive Forums application.
The database directory contains SQL scripts to create new Jive Forums databases, as well as upgrade scripts for existing installations.
The jiveHome directory is where Jive Forums stores
configuration files and additional resources. You'll copy it to a
permanent location on your server as part of the install process.
Application Server Setup
First, setup your jiveHome directory, which contains
configuration files and additional resources used by Jive Forums. Copy
the jiveHome directory from the distribution to where you'd like for
the directory to permanently reside. The directory must be readable and
writable by your application server, but should not be in the document
path of your webserver (such that someone could access the directory
from a URL such as http://www.yourserver.com/jiveHome). Windows users
might pick a directory such as c:\jiveHome while Unix users might install jiveHome to /opt/jiveHome.
Now that your jiveHome directory is setup, the Jive Forums application
will need to know its location. There are several ways to do this. Choosing one of the
following options depends largely on how you want to register your value in your environment.
- (Option 1) Don't manually set the location of the jiveHome
directory -- use the Jive Forums setup tool to do it for you
(recommended). Afer you deploy the web application (detailed below) and
start the setup tool you'll be prompted for the jiveHome location.
-
(Option 2) Set the location of the jiveHome directory using the EditWAR tool. The EditWAR tool is a small application which will modify the packaged web application (jiveforums.war) to point to the jiveHome directory. The jiveforums.war file is also in the base directory of this distribution.
To invoke the EditWAR tool, open a command prompt in the base directory of this distribution and execute this command: java -jar EditWAR.jar jiveforums.war. The tool will then lead you through the process of updating the WAR (see image below).
- (Option 3) Set the location of the jiveHome directory via JNDI (advanced). You can set a JNDI value in your appserver of java:comp/env/jiveHome with a String value of the path to your jiveHome directory.
- (Option 4) Set the location of the jiveHome directory manually by
passing in a Java system property to your appserver (advanced). Set a
property with the name of "jiveHome". Most appservers allow you to pass
in an environment variable in the startup script. That might look like
this:
java -DjiveHome=/usr/foo/jiveHome -cp . com.myappserver.Server
Next, the jiveforums.war file should be installed as a web
application in an application server which supports the Servlet 2.3 and
JSP 1.2 specifications. Please consult your server documentation if you
are not familiar with setting up web applications. Most servers give
you a choice between deploying a web-application by copying a WAR file
into a web-application directory (typically "webapps"), or by using a
deploy tool. Use the method that you are most familiar with.
Finally, make sure that you copy your license file jive.license to the jiveHome directory. If you are evaluating Jive Forums, you can get an evaluation license at http://www.jivesoftware.com/downloads/.
The Jive Forums web application should now be properly configured.
Restart your application server and then proceed to the next
installation step.
Setting Up the Database
Jive Forums uses a database to store forum content. To setup your
database you must load the appropriate database schema. You can find
schemas in the database directory of this distribution. View the database setup documentation to learn how to install the schemas and JDBC drivers. Note:
Jive Forums also includes an embedded database that is suitable for
evaluation and testing (although we do not recommend using the embedded
database for deployment). If you would like to use the embedded
database, you can skip to the next step.
Complete the database steps outlined in the database setup documentation before proceeding further.
Setup and Admin Tools
After completing the above steps, you should be ready to run the
setup tool. Point your web browser to the location on your webserver
where you installed the admin skin. For example:
http://www.[yourserver].com/jiveforums/admin/setup
The setup tool will guide you through the final steps of getting
Jive Forums up and running. Once setup is complete, you will be
redirected to the admin tool, which can be found at something similar
to http://www.[yourserver].com/jiveforums/admin. Use the admin tool to
create and manage forums, users, and groups.
Known Issues and Application Server Specific Tasks
Tomcat 4.1.x:
-
You'll need to remove the older versions of the JavaMail and Java Activation Framework from the
common/lib directory of Tomcat. Replace these jars from the ones from the WEB-INF/lib of the
Jive Forums application.
Tomcat 5.0.x:
- Tomcat 5.5 ships with its own xercesImpl.jar and xml-apis.jar, these conflict with the same jars included in
Jive Forums. Prior to deployment, remove xercesImpl.jar and xml-apis.jar from the common/endorsed directory of your Tomcat install.
Tomcat 5.5.x:
Tomcat 6.0.10 (or later):
- JDK 1.4 is not supported; JDK 1.5 is required for Tomcat 6. From
the Tomcat README: Tomcat 6.0 is designed to run on JSE 5.0 and later, and
requires configuration to run on JSE 5.0.
Jetty6
- It is recommended that you set the jiveHome using the Editwar tool or as a system property at startup.
- Editwar tool (via command line client): java -jar Editwar.jar jiveforums.jar
- System property (via command line client): Append -DjiveHome=/path/to/jive/home to your application server start command.
- Jetty 6 ships with its own xerces.jar that conflicts with the
xerces.jar in Jive Forums. Jive Forums will fail to load without this
workaround: Delete jetty/lib/jsp-2.0/xercesImplx-x-x.jar
- JDK 1.4 is not supported, JDK 1.5 is required for Jetty6.
Jetty5
- JDK 1.5: Jetty 6 ships with its own xercesImple.jar, this conflicts with the
xerces.jar in Jive Forums. Prio to deployment, remove jetty/lib/jsp-2.0/xercesImplx-x-x.jar.
- JDK 1.4: In order to resolve the conflicts with Jetty's XML parser JAR files, you
will need to remove WEB-INF/lib/xercesImpl.jar and WEB-INF/lib/xalan.jar from jiveforums.war and rebuild the WAR.
In your command line cient:
- mkdir temp
- cd temp
- jar xvf path_to_deployed_war/jiveforums.war
- rm WEB-INF/lib/xalanImpl.jar
- rm WEB-INF/lib/xerces.jar
- jar cvf jiveforums.war *
- Deploy new WAR you just created.
Orion 2.0.7
NOTE: Orion 2.0.7 is not currently supported for Forums 5.5
- Delete the following jars from <orion-install>/ crimson.jar, xerces.jar, xalan.jar, jaxp.jar
- Copy tools.jar from <jdk-install>/lib/tools.jar to <orion-install>/
- Unzip jiveforums.war in <orion-install>/applications/jiveforums
- unzip -d <orion-install>/applications/jiveforums jiveforums.war
- Remove jiveforums/WEB-INF/orion-web.xml.
- Remove jiveforums.war from <orion-install>/applications
- Edit <orion-install>/config/default-web-site.xml
- Add the following line: <web-app application="default" name="jiveforums" root="/jiveforums"/>
- Edit <orion-install>/config/application.xml
- Add the following line: <web-module id="jiveforums" path="../applications/jiveforums" />
Resin 3.1
- JDK 1.4 is not supported by Resin 3.1, if you require JDK 1.4 you must run Resin 3.0.23.
- Webservices are currently not supported. Use Resin 3.0.XX (the most recent).
Weblogic 8.1
- Unzip WAR prior to deploying, unzip -d jiveforums jiveforums.war deploy the directory rather than the WAR file.
- Webservices are currenly not supported.
- Weblogic 8.1 is only supported on JDK 1.4, however there still exist XML parser issues.
In order to resolve these issues you will need to copy some jars from the jiveforums.war
and copy them to your JDK's endorsed libraries directory as follows:
- Unpack the jiveforums.war to a temp directory: jar xvf path_to_deployed_war/jiveforums.war
- Copy from WEB-INF/lib: xalan.jar xerces.jar, serializer.jar, resolver.jar and xml-apis.jar to your
JDK endorsed libraries directory: <JDK>/jre/lib/endorsed
Weblogic 9.2
- Unzip WAR prior to deploying, unzip -d jiveforums jiveforums.war deploy the directory rather than the WAR file.
- Weblogic 9.2 does not support JDK 1.4, you must your JDK 1.5 or higher.
Glassfish v2
- JDK 1.4 is not supported by Glassfish version 2.
Sun Application Server 7 and 8
-
Sun Application Server 7 and 8 ship with a security policy which conflicts with the
requirements of cache software (Tangosol Coherence) that Jive ships with. To correct this
edit the config/server.policy file for the server in question (default is
[app server]/domains/domain1/server1/config/server.policy for version 7 and
[app server]/domains/domain1/config/server.policy for version 8) and change the
section starting with:
// Basic set of required permissions granted to all remaining code
grant {
... [a bunch of permissions here] ...
};
to
// Basic set of required permissions granted to all remaining code
grant {
permission java.security.AllPermission;
};
Save the changes and restart the application server.
OC4J 10.1.3.2.0
- When deploying jiveforums.war, on the 3rd step of the
process, you must 'Configure Class Loading' and check the box to 'Search Local Classes First'.