Support for Genome Workbench will end on March 31 2024. You may still use the application, but supporting documentation will not be available after this date. Read more.
Running Genome Workbench over X Window System
- Introduction
- Installing on CentOs 7
- Installing on Ubuntu 18.04
- Installing on OpenSUSE 15.1
- Installing on Fedora 29
- Installing on Debian 9
- Enabling editing package
- Connecting from a Windows PC
- Connecting from a Mac
- VNC and X2Go
- Troubleshooting
Introduction
Why run Genome Workbench on the cloud? In addition to the usual benefits of being able to connect to the software from anywhere without the need to maintain your own server there are multiple other reasons. If your data processing pipeline already exists on the cloud it might be faster and more convenient to add Genome Workbench to your toolbox there instead of installing it on your desktop PC or Mac. Genome data sets can reach tens and hundreds of gigabytes in size. It may frequently be a non-trivial expense to move such amounts of data between the cloud storage and a desktop computer. A more cost effective approach would be to bring the software to the cloud instead of copying the data in the other direction. This guide gives step by step instructions on how to install Genome Workbench on Linux hosts running in the Amazon EC2 Cloud. This tutorial may also be useful if you are trying to install Genome Workbench on a Linux host running elsewhere.
See “connecting from a Windows PC” or “connecting from a Mac” directions to connect to the Linux host from Windows or Mac and display the Genome Workbench GUI. You also need to be familiar with the procedure to connect to the EC2 instances using ssh. Please see the Connecting to Your Linux Instance from Windows Using PuTTY notes if you are not already conversant with ssh.
Please note that configuration and launching of instances in AWS EC2 as well as the detailed tutorial on Genome Workbench usage for specific tasks is beyond the scope of this document.
The steps below assume Genome Workbench version 3.0.0. You can always find and download the latest release. As updated versions are made available, you may have to adjust the download URLs in the steps below. At the moment, the only supported architecture is x86_64. If your Linux host or AWS instance is running on an ARM CPU, you will have to build the software from source.
We used t2.large instance (8Gb RAM) for testing. You may select an instance with more or less RAM available, depending on your computational needs. The version of Linux running on an AWS instance needs to have some minimal set of tools installed (yum for CentOs, dnf for Fedora, zypper for OpenSUSE, apt for Ubuntu and Debian) as well as have sshd running. Some AWS images may not have even these tools available - CoreOs or AtomicHost versions of Fedora for example.
After launching and logging in to your instance via ssh, please issue each command from the command line exactly as written. Be aware of the accidental line-breaks – each step should constitute exactly one command – with the obvious exception of the instructions to the user, e.g. “log out and log back in…”
Installing on CentOs 7
- sudo yum -y install epel-release
- sudo yum -y install https://ftp.ncbi.nlm.nih.gov/toolbox/gbench/ver-3.0.0/gbench-linux-centos7-x86_64-3.0.0.rpm
- sudo yum -y install xorg-x11-xauth
- logout and log back in to enable xauth, see notes for connecting from Windows or Mac.
- /opt/ncbi/gbench-3.0.0/bin/gbench
Installing on Ubuntu Server 18.04 LTS
- wget https://ftp.ncbi.nlm.nih.gov/toolbox/gbench/ver-3.0.0/gbench-linux-Ubuntu-bionic_amd64-3.0.0.deb
- sudo apt-get update
- sudo apt install -y ./gbench-linux-Ubuntu-bionic_amd64-3.0.0.deb
- /opt/ncbi/gbench-3.0.0/bin/gbench
Installing on OpenSUSE Leap 15.1
- sudo zypper install -y Mesa-libglapi0
- sudo rpm --import https://ftp.ncbi.nlm.nih.gov/toolbox/gbench/GBENCH-GPG-KEY
- sudo zypper install -y https://ftp.ncbi.nlm.nih.gov/toolbox/gbench/ver-3.0.0/gbench-linux-openSUSE151-x86_64-3.0.0.rpm
- sudo zypper install -y xauth
- Log out and log back in to enable xauth, see notes for connecting from Windows or Mac.
- /opt/ncbi/gbench-3.0.0/bin/gbench
Installing on Fedora 29
- sudo dnf -y install https://ftp.ncbi.nlm.nih.gov/toolbox/gbench/ver-3.0.0/gbench-linux-fedora29-x86_64-3.0.0.rpm
- sudo dnf -y install xorg-x11-xauth
- logout and log back in to enable xauth, see notes for connecting from Windows or Mac.
- /opt/ncbi/gbench-3.0.0/bin/gbench
Installing on Debian 9
- wget https://ftp.ncbi.nlm.nih.gov/toolbox/gbench/ver-3.0.0/gbench-linux-debian9-amd64-3.0.0.deb
- sudo apt-get update
- sudo apt install -y ./gbench-linux-debian9-amd64-3.0.0.deb
- sudo apt-get install -y xauth
- Log out and log back in to enable xauth, see notes for connecting from Windows or Mac.
- /opt/ncbi/gbench-3.0.0/bin/gbench
Genome Workbench GUI before the editing package is enabled.
Enabling editing package
After Genome Workbench is running and the GUI is displayed you may want to enable the editing package:
- Invoke the Packages item in the Tools menu.
- Select Sequence Editing.
- If the Enable checkbox is not checked, please check it, click OK, and restart Genome Workbench (see screenshot).
Connecting from a Windows PC
To connect from a Windows PC you will need an ssh client (e.g. Putty or SecureCRT and an X-server for Windows (e.g. Xming or X-Win32).
- Install X-server for Windows, for example Xming or X-Win32
-
Enable X-forwarding in your ssh client.
-
Connect to your Linux computer and start Genome Workbench from the command line. Make sure Xming or X-Win32 is running before connecting to the remote Linux system.
Connecting from Mac
- Install X11 server for Mac - you will have to log out and login back after the installation.
- Open Terminal and connect to the remote Linux system via ssh (do not forget -X command line option for X forwarding):
ssh -X <remote hostname> - XQuartz server should start automatically. Launch Genome Workbench from the command line.
VNC and X2Go
Other approaches to use Genome Workbench GUI remotely without X-forwarding include VNC and X2Go. Both protocols allow for the full remote desktop experience similar to Windows Remote Desktop instead of a single application display. You will have to install a server component on the remote Linux host, as well as a complete desktop environment such as XFCE in addition to the client installed on your local Windows PC or Mac. You can find detailed instructions at the respective websites:
Troubleshooting
If you are experiencing problems running Genome Workbench on Linux and displaying the GUI on a Windows PC via X server such as X-Win32 please read the following instructions.
-
Are you unable to start Genome Workbench? The error in the terminal could be “Application terminated”. What to do: Verify that X-forwarding is enabled in your ssh client and that X-server is running on your local PC (XMing or X-Win32 for Windows). Also make sure that xauth utility is installed on the remote Linux host (typically found in /usr/bin/xauth) and that running “echo $DISPLAY” on Linux prints out something like: localhost:10.0
-
Are the colors wrong, or are the fonts corrupted?
This is what a few of our users reported seeing when running Genome Workbench.
What to do: Adjust the preferences in your X-Server emulator on the Windows PC (we used X-Win32):
Make sure “PseudoColor” drop-down selection is set to “Emulation”.
Current Version is 3.8.2 (released December 12, 2022)
General
Help
Tutorials
- Basic Operation
- Using Active Objects Inspector
- Configure tracks and track display settings
- Working with Non-Public Data
- Viewing Multiple Alignments and Trees
- Broadcasting
- Genes and Variation
- Generating and Viewing Sequence Overlap Alignment
- Working with BAM Files
- Loading Tabular Data
- Working with VCF Files
- Sequence View Markers
- Opening Projects in Genome Workbench
- Publication quality graphics (PDF/SVG image export)
- Editing in Genome Workbench
- Create Protein Alignments using ProSplign
- GFF-CIGAR export for alignments
- Exporting Tree Nodes to CSV
- Generic Table View
- Running BLAST search against custom BLAST databases
- Using Phylogenetic Tree
- Coloring methods in Multiple Alignment View
- Displaying translation discrepancies
- Searching in Genome Workbench
- Graphical View Navigation and Manipulation
- Using the Text View to Review and Edit a Submission
- BAM haplotype filtering
- Displaying new non-NCBI molecules with annotations
- Creating phylogenetic tree from precalculated multiple alignment
- Creating phylogenetic tree starting from search
- Video Tutorials
General use Manuals
- Tree Viewer Formatting
- Tree Viewer Broadcasting
- Genome Workbench Macro
- Query Syntax in Genome Workbench and Tree Viewer
- Multiple Sequence Aligners
- Running Genome Workbench over X Window System
NCBI GenBank Submissions Manuals
- Table of Contents
- Introduction
- Genome Submission Wizard
- Save Submission File
- Reports
- Import
- Sequences
- Add Features
- Add Publication
- Comments
- Editing Tools