Skip to content
This repository has been archived by the owner on Jan 9, 2023. It is now read-only.

Install Fusion or Earth Server

tst-mswartz edited this page Jul 2, 2020 · 27 revisions

Supported Operating Systems

The installer has been successfully tested on Ubuntu 16.04, Red Hat Enterprise Linux 6, Red Hat Enterprise Linux 7, CentOS 6, and CentOS 7.

Enable Additional Repositories for CentOS & RHEL

For CentOS and RHEL, specific yum repositories need to be enabled to install the required development tools. Note: this section is also contained in the Build instructions.

CentOS 7

sudo yum install epel-release

RHEL 7

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

CentOS 6

sudo wget http://people.centos.org/tru/devtools-2/devtools-2.repo -O /etc/yum.repos.d/devtools-2.repo
sudo yum install -y epel-release

RHEL 6

NOTE: The EPEL URL below assumes that your RHEL 6 installation has the latest updates.

# For RHEL 6 Workstation:
sudo subscription-manager repos --enable=rhel-x86_64-workstation-dts-2

# For RHEL 6 Server:
sudo subscription-manager repos --enable=rhel-server-dts2-6-rpms

# For all RHEL 6 Editions:
sudo subscription-manager repos --enable=rhel-6-server-optional-rpms
sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm

Building Open GEE

Note: if you have pre-built RPMs, then you can skip this section.

To install Fusion or Earth Server, you must prepare the install package from a successful build of the source (which contains Fusion and Earth Server source code) and Third Party packages. For more information on building Fusion, please review the following link:

Building Earth Enterprise Fusion and Server

Uninstalling Previous Versions

If you have version 5.1.2 or earlier of GEE installed, we recommend that you uninstall the previous version before installing Open GEE.

Building the Install Package

You will need to build the install package using scons. Please note that the default temporary staging area for the install package is /tmp/fusion_os_install. This can be changed by specifying a different installdir parameter. Please note that all steps must use the same directory location.

In the commands below, you may need to change "release=1" to "optimize=1", depending on which type you used when building the source code. You should use the same flag for both the build and install commands.

  1. (Optional) Prepare the tutorial files

    cd earthenterprise/earth_enterprise/tutorial/FusionTutorial
    sudo ./download_tutorial.sh
    
  2. (Mandatory) Create the install package

    cd earthenterprise/earth_enterprise
    python2.7 /usr/bin/scons -j8 release=1 stage_install
    

At this point, you have fully built the install package. The Fusion and Earth Server installers use this package to install their respective components.

Installing Fusion

To install Fusion run the following command:

cd earth_enterprise/src/installer
sudo ./install_fusion.sh

The installer can use the default install directory of /tmp/fusion_os_install. If you placed the install package in a different location, you can pass that location as a parameter to the installer.

Run the following to get an explanation of all available customizations:

sudo ./install_fusion.sh -h

Note: The installer adds /opt/google/bin to your path by adding a file to /etc/profile.d. However, these files are only read when you first log in, so you will not be able to run any Open GEE commands until you log out and back in or reboot your machine. If you do not want to log out and back in, you can temporarily add the bin directory to your path by executing the following command in each bash shell you wish to run Fusion from:

export PATH=$PATH:/opt/google/bin

You can also add /opt/google/bin/ to the front of all Open GEE commands that you run; e.g. /opt/google/bin/geserveradmin <args>.

Installing Earth Server

To install GEE Server run the following command:

cd earth_enterprise/src/installer
sudo ./install_server.sh

The installer can use the default install directory of /tmp/fusion_os_install. If you placed the install package in a different location, you can pass that location as a parameter to the installer.

Run the following to get an explanation of all available customizations:

sudo ./install_server.sh -h

Upgrade Asset Root

If you are upgrading or reinstalling from a previous version of OpenGEE, run the following command to upgrade your asset root (note that default asset root location is /gevol/assets):

sudo /opt/google/bin/geupgradeassetroot --assetroot /path/to/asset/root

Install Run-time Requirements

Install the Python PIL.Image module. On Ubuntu you can run sudo apt-get install python-pil; on Red Hat platforms, run sudo yum install python-imaging.

Installing Tutorial Data

To install Tutorial Data after installing Fusion, run the following command:

sudo /opt/google/share/tutorials/fusion/download_tutorial.sh

Uninstalling GEE fusion and server

Run uninstall scripts from src/installer

sudo earth_enterprise/src/installer/uninstall_fusion.sh
sudo earth_enterprise/src/installer/uninstall_server.sh