24.4 Separate Lucene Index Server Upgrade

IMPORTANT:If your Lucene search index is running on the same server as the Vibe software, you do not need to upgrade it separately. Skip to Preserving Self-Signed Certificates During the Upgrade.

You have the following options when upgrading your Lucene search index to Vibe 4.0.5 or later:

  • Create a new search index

    Because a full re-index is required after upgrading to Vibe 4.0.5 or later, creating a new search index is less time-consuming than upgrading your existing search index. The benefit to creating a new Lucene search index is that you are able to maintain the original search index in the unlikely case of an emergency rollback.

  • Upgrade your existing Lucene search index

    If you choose to upgrade your existing Lucene search index, you must perform a re-index after the upgrade, as described in Resetting the Search Index.

These options are described in the following sections:

24.4.1 Creating a New Search Index

  1. Stop Vibe.

    Linux:

    On the Vibe server, specify the following command:

    /etc/init.d/teaming stop

    Windows:

    See Stopping Vibe as an Application.

  2. Stop the Lucene search index.

    On the Lucene index server, specify the following command:

    Linux:

    /etc/init.d/indexserver stop

    Windows:

    c:\Program Files\Novell\Teaming\luceneserver\indexserver\bin\indexserver-shutdown.bat                                                   

  3. Ensure that no application (such as a command prompt or Windows Explorer) is running on the Vibe 4.0 system.

  4. On a different server than where your original search index was running, create a new search index, as described in Installing the Lucene Software.

24.4.2 Upgrading an Existing Search Index

The Vibe installation program cannot upgrade the Lucene search index when it is running on a separate server. To upgrade your search index from Novell Vibe 4.x to OpenText Vibe 4.0.5 or later, you need to run the Separate Lucene Server installation program:

  1. Stop Vibe.

    Linux:

    On the Vibe server, specify the following command:

    /etc/init.d/teaming stop

    Windows:

    See Stopping Vibe as an Application.

  2. Stop the Lucene search index.

    On the Lucene index server, specify the following command:

    Linux:

    /etc/init.d/indexserver stop

    Windows:

    c:\Program Files\Novell\Teaming\luceneserver\indexserver\bin\indexserver-shutdown.bat                                                   

  3. Ensure that no application (such as a command prompt or Windows Explorer) is running on the Vibe 4.x system.

  4. Copy the new Vibe Lucene Server Installation program to a convenient directory on the server where the Lucene search index is located.

    The name of the Lucene Server Installation program varies by platform:

    Linux:

    lucene-installer.linux

    Windows:

    lucene-installer.exe

  5. Start the Vibe Lucene Server installation program.

  6. Accept the License Agreement, then click Next.

  7. Select Update software and settings.

  8. Click Next to continue.

  9. Click Next to accept the installation location.

  10. Click Next to accept the Java JDK location.

  11. In the Host field, specify the hostname where you are installing the Lucene Index Server.

  12. Change Lucene configuration settings as needed, then click Next.

    For information about Lucene configuration settings, see Changing Lucene Configuration Settings.

  13. Click Install to install the upgraded Lucene search index software.

  14. Click Finish when the upgrade is complete.

  15. (Conditional) If memcached is running on the Lucene search index server, reboot the server where it is running to ensure that the 4 cache is cleared.

  16. Start the Lucene Index Server.

    On the Lucene index server, specify the following command:

    Linux:

    systemctl start indexserver.service

    Windows:

    c:\Program Files\Novell\Teaming\luceneserver\indexserver\bin\indexserver-startup.bat                                                   

  17. Ensure that the index server is running.

    /etc/init.d/indexserver status

  18. Now that all Vibe components have been upgraded, follow the instructions in Upgrading the Vibe Software.