Seahorse Deployment

Table of Contents

Overview

You can install and run Seahorse on your local computer or set it up in a server mode (for details see Server Mode section).

Seahorse * works with self-contained local Spark; * can connect to any external Spark cluster (YARN, Mesos or Spark Standalone); * works on multiple platforms, including Windows Windows, OS X OS X and Linux Linux.

If you want to install Seahorse on Linux Linux you should use Dockerized Seahorse.

If you want to install Seahorse on OS X OS X or Windows Windows you should use Seahorse as a Vagrant Image.

You can also build Seahorse from source code. Follow instructions at Seahorse github repo .

Dockerized Seahorse

Works on: Linux Linux

Installation

This method of deployment uses a set of Docker containers and Docker Compose to connect them with each other. Docker is a lightweight, secure containerization tool that allows installing a complex application along with its dependencies without cluttering your OS.

Prerequisites

Running Seahorse

  1. Download the docker-compose.yml file, which serves as a config for Docker Compose (this may take a few minutes).
  2. Run docker-compose up in the directory containing the downloaded file.
  3. When Seahorse is ready, open it in your browser. It is accessible at http://localhost:33321.

Troubleshooting

Conflicting Ports

Seahorse, by default listens on port 33321. In rare cases this configuration may conflict with services running on your computer. This can be easily remedied by replacing 33321 with a port of your choosing in docker-compose.yml file. After restarting Seahorse, it will be available under the address with the new port.


Seahorse as a Vagrant Image

Works on: OS X OS X, Windows Windows, Linux Linux

Installation

On some operating systems Docker is not supported natively. That’s why we also distribute Seahorse as a Vagrant image.

Prerequisites

Running Seahorse

  1. Download the Vagrantfile that will allow you to spin up Seahorse’s virtual machine.
  2. Run vagrant up in the directory containing Vagrantfile. This may take a few minutes.
  3. When Seahorse is ready, go to http://localhost:33321 in your browser.

Troubleshooting

Conflicting Ports

Seahorse, by default listens on port 33321. In rare cases this configuration may conflict with services running on your computer. This can be easily remedied by replacing 33321 with a port of your choosing in Vagrantfile. After restarting Seahorse, it will be available under the address with the new port.

Notes for Windows Users

Problem with Special Characters in HOMEPATH Environment Variable

By default, Vagrant keeps boxes and configuration in %HOMEPATH%/.vagrant.d, but cannot access it when a %HOMEPATH% includes non-ASCII characters. It is a well known Vagrant bug and results in:

> vagrant up
...
Failed writing body (0 != 16383)

There are at least two ways to overcome the problem:


Problem with Downloading Vagrant Box

Vagrant fails to download Seahorse Box file, but does not print any specific error message.

An error occurred while downloading the remote file. The error
message, if any, is reproduced below. Please fix this error and try
again.

To overcome this issue, install Microsoft Visual C++ 2010 SP1 Redistributable Package (x86).

Seahorse in Production Environment

To learn more about scaling up and using Seahorse in production, please contact us for details.

Learn more about Seahorse enterprise-scale deployments - includes customized set-up, security, integration and 24/7 support.