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 Novell 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. Make sure that there is a license-key.xml file in the directory.

    The Vibe installation program does not start without a license file, and it has a different name when you download it.

    For more information about licensing, see Section 6.0, Updating Your Vibe License.

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

  5. Accept the License Agreement, then click Next.

    Windows Teaming Installation program Welcome page

  6. Click Next to accept the default of New installation.

    Installation Type page

  7. Click Next to accept the default of Basic.

  8. 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.

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

  10. 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.

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

4.2.3 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

    where version is the version number of Tomcat that was installed along with Vibe (for example, 6.0.18).

  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:

    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 10.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.4 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

    where version is the version number of Tomcat that was installed along with Vibe (for example, 6.0.18).

  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

    where version is the version number of Tomcat that was installed along with Vibe (for example, 6.0.18).

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

4.2.5 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.