Installing the Google Search Appliance virtual edition

Google Search Appliance virtual edition
Posted Dec 2008

This guide contains the information you need to install the Google Search Appliance virtual edition software.

Contents

  1. Before You Install
  2. Prerequisites
  3. Installation Steps
    1. Verify Requirements
    2. Download, Install, and Configure the VMware Software
    3. Download and Uncompress the Google Search Appliance virtual edition
    4. Start the VMware Software and Run Google Search Appliance virtual edition
    5. Access the Google Search Appliance virtual edition
  4. Tips
  5. For More Information

Before You Install

The Google Search Appliance virtual edition is a free software version of the Google Search Appliance. With this free software, you can try out the search capabilities of the Google Search Appliance. You can also use this software to write and test programs that integrate with the search appliance.

Prerequisites

The following system resources are required:

The following system resources are recommended:

Installation Steps

Follow the steps in this section to install and set up the Google Search Appliance virtual edition.

Verify Requirements

Ensure that your system meets the requirements for running the software, as listed under Prerequisites.

Download, Install, and Configure the VMware Software

  1. If you have not yet set up VMware Server 1.0 or later, or VMware Player 1.0 or later, install now:  http://www.vmware.com/products/player/ or http://www.vmware.com/products/server/
  2. To ensure the download was not corrupted, match the MD5 key at the Google distribution site to your download value. You can get a freeware MD5 checker (md5sum) from etree.org.
  3. If you installed VMware Server, the VMware installer prompts for networking parameters. Click Yes to both "NAT" and "host-to-host" networking.

Download and Uncompress the Google Search Appliance virtual edition

  1. Download the Google Search Appliance virtual edition and save it to disk.
  2. Uncompress the download to a directory on the local system. Do not place the download on a shared network system. If you're using Windows or Linux, use the 7zip utility. Note that this file is approximately 40 GB when uncompressed.
  3. Check that the uncompression operation created a directory named vgsa_{date} where {date} is the release date.

Start the VMware Software and Run Google Search Appliance virtual edition

  1. Start VMware Player or Server.
  2. From the Commands section of the player screen, click Open and browse to the vgsa.vmx image.
  3. Run vgsa.vmx to start the Google Search Appliance.
  4. Wait for 5 to 10 minutes, until you see the networking configuration dialog that states that status is active.
  5. On that screen you will also find the IP address of the virtual appliance. Note down the IP address.

Access the Google Search Appliance virtual edition

You can now access the Google Search Appliance virtual edition from a browser.

For development information about Google Search Appliance, see:

Tips

Adjust the internal clock for GSAve as follows:

For best performance, DO NOT use VMware Server 2.0.

For More Information

To ask questions or exchange information about the Google Search Appliance virtual edition, visit the Google Search Appliance Group.

The Google Search Appliance virtual edition is not supported by the Google or by Google Support.

This document complies with all copyright statements described in the About link of the Admin Console for the Google Search Appliance virtual edition.