14.1 Installing the Lucene Software

  1. Make sure that a supported Java Developer Kit (JDK) is installed on the remote server where you want to install the Lucene Index Server.

    For instructions, see Section A.0, Vibe System Requirements Assistance.

  2. Make sure that there is no firewall between the Vibe server and the Lucene Index Server.

  3. Copy the Lucene installation program from its original location in the same directory with the Vibe installation program to a convenient temporary directory on the remote server.

    The filename for the Lucene Installation program varies by platform:

    Linux:

    lucene-installer.linux

    Windows:

    lucene-installer.exe

  4. Change to the directory where you copied the Lucene installation program, then start it.

  5. Accept the License Agreement, then click Next.

  6. Select New installation, then click Next.

  7. Browse to and select the directory where you want to install the Lucene Index Server, then click Next.

    The default location varies by platform:

    Linux:

    /opt/novell/teaming/luceneserver

    Windows:

    c:\Program Files\Novell\Teaming\luceneserver

  8. Browse to and select the directory where you installed the JDK, then click Next.

  9. Adjust the configuration of the Lucene Index Server, as described in Section 9.5, Changing Your Lucene Index Server Configuration, then click Next.

  10. Click Install to install the Lucene software.

  11. (Conditional) On Linux, deselect Start Lucene server.

    You must edit the Lucene Index Server startup script before you start the Lucene Index Server. Instructions are provided later in this procedure.

  12. (Conditional) On Windows, if you do not want to start the Lucene Index Server immediately, deselect Start Lucene server.

    For instructions for starting and stopping the Lucene Index Server manually, see Section 14.3, Managing a Remote Lucene Index Server.

  13. Click Finish.

  14. (Conditional) On Linux:

    1. Change to the following directory:

      /opt/novell/teaming/luceneserver/indexserver/bin
      
    2. Open the indexserver-startup.sh file in a text editor.

    3. Add the following switch to the java launch command at the end of the script:

      -Djava.rmi.server.hostname=ip_address
      

      Rename ip_address with the IP address of the server where you installed the Lucene Index Server.

    4. Save the indexserver-startup.sh file, then exit the text editor.

    5. Start the Lucene Index Server.

      For instructions for starting and stopping the Lucene Index Server manually, see Section 14.3, Managing a Remote Lucene Index Server.

Moving the Lucene Index Server from the Vibe server to a remote server increases the scalability of your Vibe system because the workload is distributed between two different physical servers. However, in this configuration, the Lucene Index Server still runs on a single server. Your Vibe site depends on the Lucene Index Server for full functionality. If that server goes down for some reason, the Vibe site becomes inaccessible until access to the Lucene Index Server is restored. You can further expand your Vibe system by setting up multiple Lucene Index Servers to provide high availability, as described in Section 16.0, Running Multiple Lucene Index Servers.