2.2 Installing a Standalone Lucene Index Server

This section covers how to install the Lucene Index Server as a standalone server.

NOTE:You need to install JDK (Sun JDK 1.5.0_011 or higher) before installing the Lucene Index Server. Linux systems need to have a minimum open file limit of 4096.

2.2.1 Installing Lucene for a New Teaming Site

To install a Standalone Lucene Index Server for a new Novell Teaming application:

  1. Copy the Lucene installer to the system on which you want to install the standalone Lucene Index Server.

    The Lucene installers are in the Novell Teaming kit you unzipped:

    • lucene-installer.exe

    • lucene-installer.linux

  2. Run the Lucene installer.

  3. In the Welcome window, select the procedure you want to perform, then click Next:

    Installer Welcome window options

    New installation: Use this option to perform an initial installation of the Standalone Lucene Index Server.

    Upgrade: Use this option to perform an upgrade of an existing Standalone Lucene Index Server.

    Reconfigure: Use this option to reconfigure an existing Standalone Lucene Index Server.

  4. Read the license agreement, select the I accept the license agreement option to indicate your acceptance of the agreement, then click Next.

    Installer License agreement window options

  5. (Windows only) In the Install location window, if you need to change the default Install location for the luceneserver directory, click Browse and select the new location, then click Next.

  6. In the Lucene configuration window, edit the fields to configure the Lucene index, then click Next.

    If the default port cannot be used, specify the Host and edit the RMI Port value.

    You can run the Lucene as a server from the same system as Novell Teaming or from a remote system. You need to install the Standalone Lucene Index Server before running Novell Teaming. See Installing a Standalone Lucene Index Server.

  7. In the Ready to install window, click Next to begin the installation, or use Back to review the current configuration of the installer.

2.2.2 Installing Lucene for an Existing Teaming Site

  1. Shut down Novell Teaming on the Novell Teaming server (see Stopping Novell Teaming).

  2. Run the Lucene installer (see Section 2.2.2, Installing Lucene for an Existing Teaming Site).

  3. On the standalone server, look at the lucene-server.properties file and find the setting for index.root.dir.

    You can edit this setting to change the location of the root directory.

  4. Create a liferay.com subdirectory in the index.root.dir directory.

  5. On the Novell Teaming server, look at the ssf.properties file and find the data.root.dir setting.

  6. Copy all the files from the data.root.dir/lucene/liferay.com directory on the Novell Teaming server to the index.root.dir/liferay.com directory you just created on the standalone machine.

    IMPORTANT:If you are using FTP, make sure to copy in binary mode.

  7. For UNIX systems, make sure permissions are set so that the Novell Teaming user has full access to these files and the liferay.com directory.

  8. Start the server at the end of the installation if it is not already started:

    1. Change directories to lucene-server-installation-dir

    2. Run the rmiregistry-startup script in the bin directory

    3. Run the indexserver-startup script in the bin directory

  9. Restart Novell Teaming (see Starting and Stopping Novell Teaming).