4.2 Windows: Installing and Setting Up a Basic Vibe Site

You should already have reviewed Section 3.0, Planning a Basic Vibe Installation and filled out the Basic Vibe Installation Summary Sheet. The following sections step you through the process of installing and starting Kablink Vibe on Windows.

4.2.1 Performing Pre-Installation Tasks on Windows

Verifying System Requirements

Make sure that the Windows server where you plan to install Vibe meets the system requirements listed in Section 2.1, Vibe Server Requirements.

Stopping an Existing Web Server

If a Web server is currently running on the Vibe server, stop it, and preferably disable it.

For example, to stop and disable the Internet Information Services (IIS) Web server:

  1. On the Windows desktop, click Start > Administrative Tools > Services.

  2. Right-click World Wide Web Publishing Service, then click Properties.

  3. In the Startup type drop-down list, select Disabled.

  4. Click Stop, then click OK.

Setting Environment Variables

Make sure that the JAVA_HOME environment variable is set to the path where you installed the JDK and that the Windows PATH environment variable includes the path to your database server.

  1. Right-click My Computer, then click Properties.

  2. On the Advanced tab, click Environment Variables.

  3. Set the JAVA_HOME environment variable:

    1. In the System variables box, click New.

    2. In the Variable name field, specify JAVA_HOME.

    3. In the Variable value field, specify the path where you installed the JDK.

    4. Click OK to add the JAVA_HOME environment variable to the list of system variables, then click OK again to save the setting and return to the Advanced tab.

  4. Check the PATH environment variable:

    1. On the Advanced tab, click Environment Variables.

    2. In the System variables list, locate the PATH environment variable.

    3. If the path includes your database server software directory, click Cancel.

      or

      If the path does not include your database server software directory, add the directory, then click OK.

4.2.2 Running the Windows Vibe Installation Program

  1. Log in to the Windows server as a user with Administrator rights.

  2. In Windows Explorer, browse to the directory where you downloaded and extracted the Vibe software.

  3. Double-click the installer-teaming.exe file to start the Vibe installation program.

  4. Accept the License Agreement, then click Next.

    Windows Teaming Installation program Welcome page
  5. Click Next to accept the default of New installation.

    Installation Type page
  6. Click Next to accept the default of Basic.

  7. Use the information that you have gathered on the Basic Vibe Installation Summary Sheet to provide the information that the Vibe installation program prompts you for:

    The installation program stores the information it gathers in the installer.xml file in the same directory where you started the installation program.

  8. After you have provided all the requested information, click Install to begin the Vibe installation.

  9. When the installation is completed, click Finish to exit the Vibe installation program.

    Information about the installation process is written to the installer.log file in the same directory where you ran the Installation program. If a problem arises during the installation, the installer.log file provides information that can help you resolve the problem.

  10. Continue with one of the following sections, depending on how you want to run the Vibe software:

4.2.3 Checking for Available Hot Patches

After you install Vibe, make sure that you check on the Vibe download site where you downloaded the Vibe software for any hot patches that might be available.

4.2.4 Running Vibe as a Windows Service

Configuring Vibe as a Windows Service

The Vibe installation program created a service.bat file for configuring Vibe to run as a Windows service.

  1. In a Command Prompt window, change to the following directory:

    c:\Program Files\Novell\Teaming\apache-tomcat\bin\windows

  2. In the windows directory, copy the files from the appropriate subdirectory.

    The following subdirectories exist: x86, x64, ia64.

    If you are unsure which subdirectory is appropriate for your server, use the readme.txt file located in the c:\Program Files\Novell\Teaming\apache-tomcat\bin\windows directory as a reference.

  3. Paste the files into the c:\Program Files\Novell\Teaming\apache-tomcat\bin directory.

  4. (Conditional) If Vibe is running on a supported 64-bit Windows operating system and you have a 64-bit JDK, complete the following steps:

    1. Change to the c:\Program Files\Novell\Teaming\apache-tomcat\bin\windows\x64 directory.

    2. Copy any 64-bit .exe files and paste them into the c:\Program Files\Novell\Teaming\apache-tomcat\bin directory, overwriting any existing files.

  5. Use the following command to configure Vibe as a Windows service:

    service.bat install Teaming

    This creates a service named Apache Tomcat Teaming.

Starting Vibe as a Windows Service

  1. On the Windows desktop, click Start > Administrative Tools > Services.

  2. Right-click Apache Tomcat Teaming, then click Start.

Configuring the Vibe Service to Start Automatically on Reboot

When you run Vibe as a Windows service, you can configure Vibe to start automatically each time you reboot the Windows server.

  1. On the Windows desktop, click Start > Administrative Tools > Services.

  2. Right-click Apache Tomcat Teaming, then click Properties.

  3. In the Startup type drop-down list, select Automatic, then click OK.

Restarting the Vibe Service

You need to restart Vibe whenever you use the Vibe installation program to make configuration changes, as described in Section 9.0, Performing an Advanced Vibe Installation.

  1. On the Windows desktop, click Start > Administrative Tools > Services.

  2. Right-click Apache Tomcat Teaming, then click Restart.

  3. Close the Services window.

Stopping the Vibe Service

  1. On the Windows desktop, click Start > Administrative Tools > Services.

  2. Right-click Apache Tomcat Teaming, then click Stop.

  3. Close the Services window.

4.2.5 Running Vibe as a Windows Application

Starting Vibe as an Application

The Vibe installation program created a startup.bat file for starting Vibe.

  1. In a Command Prompt window, change to the following directory:

    c:\Program Files\Novell\Teaming\apache-tomcat\bin

  2. Run the startup.bat file to start Vibe as an application.

Stopping Vibe as an Application

  1. In a Command Prompt window, change to the following directory:

    c:\Program Files\Novell\Teaming\apache-tomcat\bin

  2. Run the shutdown.bat file to stop the Vibe application.

4.2.6 Configuring the Document Converter on Windows

Kablink Vibe uses OpenOffice.org converters to prepare documents for indexing by the Lucene Index Server. The OpenOffice.org converters are also used on the Vibe site for converting documents to HTML for viewing.

Installing OpenOffice.org as the Document Converter for Vibe

  1. Download the OpenOffice.org software for Linux from OpenOffice.org to a convenient temporary location on the Vibe server.

  2. Run the downloaded executable, then click Next. to unpack the OpenOffice.org software.

  3. Browse to or select the destination directory for the unpacked files, then click Unpack.

    This starts the OpenOffice.org Installation program.

  4. Click Next to begin the installation.

  5. Provide your customer information, then click Next.

  6. Select Custom, then click Next.

  7. In the Optional Components drop-down list, select This feature, and all subfeatures, will be installed on local hard drive, then click Next.

    This includes the OpenOffice.org Java Runtime Environment (JRE) and other components required for document conversion.

  8. Click Install Now.

    The OpenOffice.org software is installed to:

    c:\Program Files\OpenOffice.org3

  9. Click Finish.

  10. Continue with Configuring OpenOffice.org for Proper HTML Conversion.

Configuring OpenOffice.org for Proper HTML Conversion

  1. Start OpenOffice.org from the desktop.

  2. Proceed through the Welcome pages.

  3. Click Tools > Options.

  4. Expand Load/Save, then click HTML Compatibility.

  5. In the Character Set field, select Unicode (UTF-8).

  6. Click OK to save the character set setting, then exit OpenOffice.org.

  7. Continue with Running OpenOffice.org as the Document Converter for Vibe.

Running OpenOffice.org as the Document Converter for Vibe

OpenOffice.org must be running as a background process on the Vibe server in order for indexing and viewing to take place for Vibe users.

  1. Edit the properties of the OpenOffice.org desktop icon so that the Target field includes the following additional options:

    "c:\Program Files\OpenOffice.org 3\program\soffice.exe"
          -accept="socket,host=localhost,port-8100;urp;
           StarOffice.Service"
          -nologo -headless
    
  2. Double-click the OpenOffice.org desktop icon to start OpenOffice.org as a background process.

    IMPORTANT:Run OpenOffice.org as a user that has full rights to the Vibe file repository.

  3. Use Windows Task Manager to observe that the soffice.exe and soffice.bin processes are running.

  4. Test HTML conversion on your Vibe site by viewing a document that has been added as a File Entry in your Vibe site.

  5. Configure the Vibe server so that OpenOffice.org is always running as a background process whenever Vibe is running.

Excluding File Types from Being Indexed and Displayed

After Vibe is installed and running, if OpenOffice is crashing with certain file types during either of the conversion processes, you can restrict the problematic file types from being converted.

For more information, see Understanding and Configuring Document Conversions with OpenOffice in the Kablink Vibe 3.2 Administration Guide.

4.2.7 Uninstalling Vibe

If you move the Vibe site to a different server, you can delete the Vibe files from the original server to reclaim disk space. The default Vibe file locations are:

Vibe Software

c:\Program Files\Novell\Teaming

Vibe File Repository and Lucene Index

c:\Novell\Teaming

MS SQL Database

c:\Program Files\Microsoft SQL Server\MSSQL\Data

For a complete list of your Vibe files, check the installer.xml file in the directory where you originally ran the Vibe Installation program.