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

Build Instructions

Jump to bottom
Lee Savoie edited this page Jul 3, 2017 · 53 revisions

Table of Contents

  1. Building Earth Enterprise Fusion and Server
  2. Building Portable Server on Linux and Windows
    1. Portable on Linux
    2. Portable on Windows

Building Earth Enterprise Fusion and Server

Building is currently supported on 64-bit versions of Ubuntu 14.04 LTS, Ubuntu 16.04 LTS, RHEL 7, and CentOS 7. Warning: Open GEE is currently known to not work on versions of Ubuntu later than 16.04 or with versions of g++ later than 4.8.

  1. Install git

    1. On Ubuntu
      Install the system default version: 
      sudo apt-get install git
      Or install the latest version: 
      sudo add-apt-repository ppa:git-core/ppa
sudo apt-get update
sudo apt-get install git
    2. On RHEL/CentOS
      Install the system default version: 
      sudo yum install git
      Or install the latest version from the IUS repo (recommended) [More Info] : 
      sudo yum install -y wget
cd /tmp
wget https://rhel7.iuscommunity.org/ius-release.rpm
sudo yum install ius-release.rpm
sudo yum install git2u-all

  2. Install git-lfs according to the instructions specified at https://git-lfs.github.com

    In most cases:

    curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash

  3. Enable additional repos

    1. On Ubuntu
      This step is not required.
    2. On CentOS 
      sudo yum install epel-release
    3. On RHEL
      If the first command doesn't work, try the alternate methods listed here 
      sudo yum install epel-release
sudo subscription-manager repos --enable=rhel-7-server-optional-rpms
sudo subscription-manager repos --enable=rhel-7-server-optional-source-rpms

  4. Install required packages

    1. On Ubuntu 
      sudo apt-get install gcc g++ scons automake autoconf libperl4-corelibs-perl libtool xorg-dev doxygen python-dev alien swig libgtest-dev libstdc++6 libxml2-dev gettext libxinerama-dev libxft-dev libxrandr-dev libxcursor-dev libgdbm-dev libc6 libc6-dev libmng-dev zlib1g-dev libcap-dev libpng12-0 libpng12-dev freeglut3-dev flex libx11-dev bison++ bisonc++ libjpeg-dev libjpeg8-dev python2.7 python2.7-dev python2.7-psycopg2 libogdi3.2-dev libgif-dev libxerces-c-dev libgeos-dev libgeos++-dev libfreetype6 libfreetype6-dev python-imaging libproj-dev python-setuptools libgif-dev libxerces-c-dev libcap-dev libpq-dev openssl libxml2-utils libxmu-dev
    2. On RHEL/CentOS 
      sudo yum --setopt=group_package_types=mandatory,default,optional groupinstall "Development Tools"
sudo yum install scons perl-Perl4-CoreLibs xorg-x11-server-devel python-devel perl-Alien-Packages gtest-devel openssl-devel libxml2-devel libXinerama-devel libXft-devel libXrandr-devel libXcursor-devel gdbm-devel libmng-devel libcap-devel libpng12-devel libXmu-devel freeglut-devel zlib-devel libX11-devel bison-devel openjpeg-devel openjpeg2-devel geos-devel proj-devel ogdi-devel giflib-devel xerces-c xerces-c-devel
      If you get an error about git having conflicts, add --skip-broken to the first command.

  5. Clone the gee-os repository with git

    1. Method 1: Clone and download LFS files in one step (may be slower and more error prone) 
      git clone git@github.com:<username>/earthenterprise.git
    2. Method 2: Clone and download LFS files in two steps 
      GIT_LFS_SKIP_SMUDGE=1 git clone git@github.com:<username>/earthenterprise.git
cd earthenterprise
git lfs pull

  6. In the build instructions below, the scons commands for building GEE/Fusion have the following options:

    • internal=1 - Build using non-optimized code, best for development and debugging
    • optimize=1 - Build using optimized code, but with some debugging information
    • release=1 - Build a release using optimized code and no debugging information
    • -j# - Specifies the number of simultaneous build jobs to use. Replace # with an integer. It should roughly match the number of processing cores available
    • --debug=stacktrace - If there is an error within a scons script, this will give you more detailed information on how to debug it
    • --config=force - If you accidentally delete the .sconf_temp directory or make some changes to your system build libraries, use this to force the configuration to run again, otherwise the scons build may complain about missing libraries

  7. Build Earth Enterprise Fusion and Server:

    cd earthenterprise/earth_enterprise
scons -j8 release=1 build

  8. Run unit tests

    cd src/NATIVE-REL-x86_64/bin/tests
./RunAllTests.pl

    Or run an individual test

Install Fusion and Earth Server

For information on how to install Fusion and/or Earth Server, see Install Fusion or Earth Server

Building Portable Server on Linux and Windows

Software build prerequisites:

* Python
* Python pexpect installed
* Swig with support for Python
* g++

Portable run-time prerequisites:

* Python
* Python tornado installed

Portable on Linux

Make sure you have Python, the pexpect Pip package, as well as tornado, g++, and Swig with Python support installed. E.g.:

sudo apt-get install g++ python python-pexpect python-tornado swig

Run

earthenterprise/earth_enterprise/src/portableserver/build.py

The build script will produce a compressed archive with a name that looks like earthenterprise/earth_enterprise/src/portableserver/build/portableserver-linux-5.1.3-20170412.tar.gz. The build date part of the file name will change depending on the day you build.

To run Portable Server from this archive package:

1. Extract all archive contents
2. cd portableserver-linux-5.1.3-20170412/server/ #(substituting your extracted directory)
3. python portable_server.py

You can edit portableserver-linux-5.1.3-20170412/server/portable.cfg and portableserver-linux-5.1.3-20170412/server/remote.cfg for your configuration needs before starting the server.

To clean build files, run

earthenterprise/earth_enterprise/src/portableserver/build.py --clean

Portable on Windows

Install a g++ Compiler

You can install MinGW with a g++ compiler, or run the build from a Git-BASH or Git-Cmd shell from Git-Scm, which should come with g++.

Make sure g++ is in your PATH.

Install Swig with Python Support

  1. Download a Swig Zip for Windows.
  2. Extract the Zip in a desired installation directory.
  3. Add the installation directory you extracted to your PATH.

Install Python

Download and install Python 2.7 or later.

Once you have Python installed, make sure you have pexpect and tornado installed. E.g.:

cd \Python27\Scripts
pip install pexpect tornado

Add the directory you installed Python in to your PATH.

Build Portable Server

Open a command prompt with g++, swig and python in your PATH.

Run

python earthenterprise\earth_enterprise\src\portableserver\build.py

The build script will produce a compressed archive with a name that looks like earthenterprise\earth_enterprise\src\portableserver\build\portableserver-windows-5.1.3-20170412.zip. The build date part of the file name will change depending on the day you build.

To run Portable Server from this archive package:

1. Extract all archive contents
2. cd portableserver-windows-5.1.3-20170412\server\ #(substituting your extracted directory)
3. python portable_server.py

You can edit portableserver-windows-5.1.3-20170412\server\portable.cfg and portableserver-windows-5.1.3-20170412\server\remote.cfg for your configuration needs before starting the server.

To clean build files, run

python earthenterprise\earth_enterprise\src\portableserver\build.py --clean
Clone this wiki locally