Installing ActiveGo on Linux

Before you begin

Before you start the installation, you need to ensure that your system meets the prerequisites, and that you do not have other Go distributions that are going to conflict with ActiveGo.

Prerequisites

• Linux 64-bit
• 1 GB hard disk space

Existing Go installations

ActiveGo can usually co-exist with other Go installations, but only one Go can be first on your PATH environment variable at a time. This determines which Go installation is run when you type go at the command prompt. The ActiveGo installation places the path to ActiveGo at the start of your path, making it the default Go installation on your system.

By default, the installer will install the ActiveGo distribution in /opt/ActiveGo- and set your PATH and GOPATH environment variables in your $HOME/.profile file.

Interactive installation

You can install ActiveGo on Linux by extracting a standard tarball (*.tar.gz) file and running an installation script. You must have write access to the installation folder, but you do not need *root* (Administrator) privileges to complete the installation unless the directory you are installing to requires these rights.

You can use either the standard interactive installation, or you can specify all of the required information on the command line so that the installation runs automatically.

To install ActiveGo interactively, download the package to a temporary directory, extract the files, and run the install.sh install script without any arguments.

For example, use this sequence of commands to extact and install ActiveGo.

% tar xzf ActiveGo-<version>.tar.gz
% cd ActiveGo-<version>
% sudo ./install.sh

**NOTE: The sudo command is used because the default install location (*/opt/ActiveGo-*) does require root privileges.

The install script will verify that you accept the terms in the license agreement and allow you to specify the installation directory for ActiveGo.

You need to configure envronment variables to complete the installation.

Non-interactive install

By default the install script will prompt you for an install directory. You can avoid this interaction by specifying the install directory with the --prefix <installdir> option.

The following example installs ActiveGo in the default directory and accepts the end user license agreement, but does not check for updates.

sudo ./install.sh --prefix /opt/ActiveGo-1.8.3 --license-accepted --no-update-check

Enter ./install.sh -h to view complete usage information.

Configuring environment variables for ActiveGo

After you complete the installation, you need to configure your PATH and GOPATH environment variables.

Enter the following at the bottom of either /etc/profile file (for a system-wide installation) or the $HOME/.profile file (for your account only) to specify the location of your GOPATH, which points to your Go workspace.

MY_GOPATH= && source /opt/ActiveGo-1.8.3/ActiveGo-Environment.sh

Example:

MY_GOPATH=$HOME/go && source /opt/ActiveGo-1.8.3/ActiveGo-Environment.sh

Open a new terminal window, or source the shell configuration file (i.e. source /etc/profile) to enable the configuration changes. To verify that ActiveGo is installed and configured, enter: godoc -play -http=:6060 to test your ActiveGo installation. Once the godoc server starts you can access a local instance of the ActiveGo help at http://localhost:6060.

After installing and configuring ActiveGo, read the Getting Started pages in this guide for a general introduction to ActiveGo on your platform and pointers to documentation that will be most useful to you.

ActiveGo supports integration with TensorFlow, an open-source software library for Machine Intelligence, with the TensorFlow for Go package. For information on configuring ActiveGo to work with TensorFlow, see Configuring TensorFlow for ActiveGo.

Uninstalling ActiveGo

If you need to uninstall ActiveGo, you can do so by removing the directory where you installed ActiveGo and removing any associated environment variables you configured.