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.
Make sure that the Windows server where you plan to install Vibe meets the system requirements listed in Section 2.1, Vibe Server Requirements.
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:
On the Windows desktop, click
.Right-click
, then click .In the
drop-down list, select .Click
, then click .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.
Right-click
, then click .On the
tab, click .Set the JAVA_HOME environment variable:
In the
box, click .In the
field, specify JAVA_HOME.In the
field, specify the path where you installed the JDK.Click
to add the JAVA_HOME environment variable to the list of system variables, then click again to save the setting and return to the tab.Check the PATH environment variable:
On the
tab, click .In the
list, locate the PATH environment variable.If the path includes your database server software directory, click
.or
If the path does not include your database server software directory, add the directory, then click
.Log in to the Windows server as a user with Administrator rights.
In Windows Explorer, browse to the directory where you downloaded and extracted the Vibe software.
Double-click the installer-teaming.exe file to start the Vibe installation program.
Accept the License Agreement, then click
.Click
to accept the default of .Click
to accept the default of .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.
After you have provided all the requested information, click
to begin the Vibe installation.When the installation is completed, click
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.
Continue with one of the following sections, depending on how you want to run the Vibe software:
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 viewing documents (by converting them to HTML).
Download the OpenOffice.org software for Windows from OpenOffice.org to a convenient temporary location on the Vibe server.
Run the downloaded executable, then click
to unpack the OpenOffice.org software.Browse to or select the destination directory for the unpacked files, then click
.This starts the OpenOffice.org Installation program.
Click
to begin the installation.Provide your customer information, then click
.Select
, then click .In the
drop-down list, select , then click .This includes the OpenOffice.org Java Runtime Environment (JRE) and other components required for document conversion.
Click
.The OpenOffice.org software is installed to:
c:\Program Files\OpenOffice.org 3
Click
.Continue with Configuring OpenOffice.org for Proper HTML Conversion.
Start OpenOffice.org from the desktop.
Proceed through the Welcome pages.
Click
.Expand
, then click .In the
field, select ).Click
to save the character set setting, then exit OpenOffice.org.Continue with 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.
Edit the properties of the OpenOffice.org desktop icon so that the
field includes the following additional options:"C:\Program Files\OPenOffice.org 3\program\soffice.exe" "-accept=socket,host=localhost,port=8100;urp; StarOffice.ServiceManager" -nologo -headless
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.
Use Windows Task Manager to observe that the soffice.exe and soffice.bin processes are running.
Test HTML conversion on your Vibe site by viewing a document that has been added as a File Entry in your Vibe site.
Configure the Vibe server so that OpenOffice.org is always running as a background process whenever Vibe is running.
The Vibe installation program created a service.bat file for configuring Vibe to run as a Windows service.
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).
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.
Paste the files into the c:\Program Files\Novell\Teaming\apache-tomcat\bin directory.
(Conditional) If Vibe is running on a supported 64-bit Windows operating system and you have a 64-bit JDK, complete the following:
Change to the c:\Program Files\Novell\Teaming\apache-tomcat\bin\windows\x64 directory.
Copy any 64-bit .exe files and paste them into the c:\Program Files\Novell\Teaming\apache-tomcat\bin directory, overwriting any existing files.
Use the following command to configure Vibe as a Windows service:
service.bat install Teaming
This creates a service named Apache Tomcat Teaming.
On the Windows desktop, click
.Right-click
, then click .When you run Vibe as a Windows service, you can configure Vibe to start automatically each time you reboot the Windows server.
On the Windows desktop, click
.Right-click
, then click .In the
drop-down list, select , then click .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.
On the Windows desktop, click
.Right-click
, then click .Close the Services window.
On the Windows desktop, click
.Right-click
, then click .Close the Services window.
The Vibe installation program created a startup.bat file for starting Vibe.
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).
Run the startup.bat file to start Vibe as an application.
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).
Run the shutdown.bat file to stop the Vibe application.
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.