Installing / Building Genome Workbench

Windows 7 (64-bit)

The Windows 7 package is a native Windows installer. Once you have downloaded the installer executable, simply double-click it in Windows Explorer to launch this. The installation wizard will then walk you through the steps of installing the main executable and registering its components.

Once Genome Workbench is installed, you should have an icon on your desktop and an item in your start menu to launch Genome Workbench.

MacOS X

The MacOS X package is an executable disk image. Once you have downloaded this image, you should be able to launch the application by double-clicking on it in the Finder.

We provide only one package for MacOS X, and that package is designed to work on MacOS X 10.8 and later (Mountain Lion, Mavericks, Yosemite).  MacOS X 10.7 and earlier are no longer supported.

Linux

The Linux package is provided for 64-bit Intel platforms in a variety of packaging formats, including binary RPM and DEB packages. We compile and test at NCBI using Fedora and OpenSUSE (rpm packages) and Ubuntu (deb packages). The provided .rpm and .deb packages should work according to your distribution's installation procedures.

On Ubuntu Genome Workbench application entry is added to Other group of the applications menu.

Installing RPM key

Use the following command as root on your PC to have non-problem installation:

"rpm --import ftp://ftp.ncbi.nlm.nih.gov/toolbox/gbench/GBENCH-GPG-KEY"

This will import public key with which RPM is signed.

Source Installations

Genome Workbench is also provided in source form. The source package is placed in the public domain, and is freely available for anyone to modify and redistribute, in either binary or source form. Details of the NCBI Public Domain License can be found here.

Genome Workbench makes use of the NCBI C++ Toolkit. A subset of the public toolkit source code is included in the Genome Workbench source package. While the latest versions of Genome Workbench can be found here, Genome Workbench is also available as part of the NCBI C++ Toolkit's public releases.

The essentials of the build process are documented as part of the NCBI C++ Toolkit. There are a couple of specific details that should be remembered when building Genome Workbench:

  • For Unix/Linux, a build script (build-linux-distro.sh) is provided in the root directory of the source tarball. This script is the script we use for building distributions in-house, and will automatically ensure that the wxWidgets libraries are built and installed side-by-side with the application. This dual installation ensures that the application will maintain binary compatibility through system upgrades. Please, check README.LINUX for more information for the Linux/Unix builds.
  • The build for MacOS X supports two versions of the build system: the command-line 'configure'-based solution, as described for Unix builds; and a build system for xCode (in compilers/xCode).
  • Genome Workbench requires a multithreaded environment.
  • In Unix / Linux, you should supply the --with-mt flag to 'configure'. This is implied by --with-gbench.

Support Center

Last updated: 2017-11-04T03:25:26Z