Using the pre-built installers

The easiest and recommended way to install Hypertable for Windows is to use the pre-built installers, either the x86 or the x64 package. The Hypertable x86 package runs on both, 32-bit and 64-bit versions of Windows. The Hypertable x64 package requires a 64-bit version of Windows. For desktop or small databases the x86 package might be the preferable solution. The x64 package is recommended for pure server, large and distributed installations.

Download and run the appropriate installer. The installer copies the required components to the selected installation directory and creates the default configuration in %ProgramData%\Hypertable\hypertable.cfg. During the installation process the wizard offers the following options:


  • Install Hypertable as a Windows service

    If checked the installation creates and starts a Hypertable instance as a Windows service, or else it just copies the binaries and creates the default configuration. The following commands can be used to manually manage the Hypertable service:
    Hypertable.Service [--install-service|--uninstall-service]
    Hypertable.Service [--start-service|--stop-service]


  • Create firewall rules for the Hypertable servers

    If checked the installation creates the required firewall rules (TCP and UDP protocol) in order to grant access to the Hypertable servers, or else the installation leaves the firewall untouched.


Using the pre-built archive

Download and unpack the archive, either the x86 or the x64 package, into the preferred installation directory. If unpacked the default configuration will be located at <unpack dir>\conf\hypertable.cfg and can optionally be moved to its preferable location at %ProgramData%\Hypertable\hypertable.cfg. Make sure the Microsoft Visual C++ 2010 redistributable package (x86/x64) has been installed before. The following commands can be used to manually manage the Hypertable service:

Hypertable.Service [--install-service|--uninstall-service]
Hypertable.Service [--start-service|--stop-service]


Alternatively, run the Hypertable instance in the logged-on user account:

Hypertable.Service [--start-servers|--stop-servers]
Hypertable.Service --join-servers


Installed components

  • Hypertable.LocalBroker.exe - The Local Broker is a local file system broker.
  • Hyperspace.Master.exe - Hyperspace is a service that provides a file system for storing small amounts of metadata.
  • Hypertable.Master.exe - The Master handles all meta operations such as creating and deleting tables.
  • Hypertable.RangeServer.exe - The Range Server handles all reading and writing of table data in the ranges for which it is responsible.
  • Hypertable.Service.exe - Manages the database servers and the Hypertable Windows service.
  • Hypertable.ThriftBroker.exe - The Thrift Broker serves the Thrift API services.
  • Hypertable.exe - This is the Hypertable shell.

Visit Hypertable documentation to learn more about the system components.
For more information about Thrift visit the Apache Thrift project homepage.