How to Install Studio 3T

If you’re looking for a MongoDB GUI, client, or IDE, we’re happy you’ve found Studio 3T.

Prerequisites

MongoDB for Windows

Install the latest MongoDB community edition on your Windows machine following these steps.

MongoDB for macOS

Follow MongoDB’s tutorial to install MongoDB on OSX through either the MongoDB Download Center or Homebrew.

sudo chown -R `id -un` /data/db
# Enter your password

MongoDB for Linux

MongoDB provides various packages for popular Linux distributions. View the full list here.

Install Studio 3T

Studio 3T for Windows

Studio 3T is available for Windows 64- and 32-bit systems, with or without a bundled shell.

An .msi installer for 64-bit systems is also available for Studio 3T Enterprise users, also with or without the bundled shell.

1. Download the latest Studio 3T version.
2. Start the installer by opening the file.
3. Follow the directions on the screen.

Studio 3T for Mac

OS X users can download Studio 3T with or without the bundled shell.

1. Download the latest Studio 3T .dmg file.
2. Open the .dmg file on your machine.
3. Drag and drop the Studio 3T .app file into your Applications folder when prompted.

Studio 3T for Linux (e.g. Ubuntu, Debian)

Studio 3T is available for 64- and 32-bit Linux systems.

It is distributed as a gzipped tarball (.tar.gz), which can be unpacked at the command line or using system utilities such as Archive Manager.

The tarball contains a runnable .sh file that launches the installer for Studio 3T. Using this, you can install Studio 3T to your desired location and create a desktop shortcut to launch Studio 3T.

For example, to install from the command line:

1. Open your shell.
2. cd to the directory where the gzipped tarball (.tar.gz) was downloaded.
3. Unpack and run the Studio 3T installer.

For the 64-bit version of Studio 3T:

$ tar -xvzf studio-3t-linux-x64.tar.gz
$ sh ./studio-3t-linux-x64.sh

For the 32-bit version of Studio 3T:

$ tar -xvzf studio-3t-linux-x86.tar.gz
$ sh ./studio-3t-linux-x86.sh

Make sure to have the following libraries installed:

• libswt-gtk-4919.so
• libswt-pi-gtk-4919.so
• libswt-pi3-gtk-4919.so
• libgtk-3.so

Running Studio 3T on CentOS

When trying to run Studio 3T on CentOS, you may experience the following issue:

java: cairo-misc.c:380: _cairo_operator_bounded_by_source: Assertion `NOT_REACHED' failed.
./mongochef.sh: line 11: 28030 Aborted (core dumped) $DIR/../jre/bin/java -jar $DIR/../lib/data-man-mongodb-pro-*.jar

This is a general issue for all SWT-based applications on CentOS and is related to the Cairo 2D graphics library on CentOS.

The work-around is to pass ‘-Dorg.eclipse.swt.internal.gtk.cairoGraphics=false‘ to the application. In order to do that, open mongochef.sh in the bin directory of your Studio 3T installation and add the (highlighted) parameter to the last line of the script.

#!/bin/bash

SOURCE=”${BASH_SOURCE[0]}”
while [ -h “$SOURCE” ]; do # resolve $SOURCE until the file is no longer a symlink
DIR=”$( cd -P “$( dirname “$SOURCE” )” && pwd )”
SOURCE=”$(readlink “$SOURCE”)”
[[ $SOURCE != /* ]] && SOURCE=”$DIR/$SOURCE” # if $SOURCE was a relative symlink, we need to resolve it relative to the path where the symlink file was located
done
DIR=”$( cd -P “$( dirname “$SOURCE” )” && pwd )”

$DIR/../jre/bin/java -Dorg.eclipse.swt.internal.gtk.cairoGraphics=false -jar $DIR/../lib/data-man-mongodb-pro-*.jar

Save your script and you are good to go.