Build Instructions

Building Earth Enterprise (Fusion, Server) on Ubuntu 14.04 LTS and RHEL 7 (64-bit)

Common steps

Run these commands on either Ubuntu or RHEL/CentOS

Install git according to the instructions for your Linux OS below
Install git-lfs according to the instructions specified at https://git-lfs.github.com
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
```
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
Build using the steps bellow for your target platform

Run unit tests

cd NATIVE-OPT-x86_64/bin/tests
./RunAllTests.pl

Or run an individual test

Steps for Building on Ubuntu 14.04.5 LTS:

Install git:
```
sudo apt-get install git
```
To get the most recent version of git, do the following (version 1.9.1 works for purposes of interacting with the repository, but if you want to download the latest version of git, the steps to do this have been outlined below):
```
sudo -i
add-apt-repository ppa:git-core/ppa
apt-get update
apt-get install git
```
This will install the latest version. Note: Be sure to exit "sudo" before proceeding

Install the following packages (if they’re not installed already):

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 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

Build Fusion/Earth Server:

cd earthenterprise/earth_enterprise
scons -j8 optimize=1 build

Steps for building on RHEL 7

Install git

Recommended: install the latest version of git:
1. Enable the IUS repo [More Info] .
```
sudo yum install -y wget
cd /tmp
wget https://rhel7.iuscommunity.org/ius-release.rpm
sudo yum install ius-release.rpm
```
2. Install git 2.x
```
sudo yum install git2u-all
```
Or install the system default version of git (1.8): sudo yum install git
Install EPEL repo
```
sudo yum install epel-release
```
Note, if this command doesn't work, try the alternate methods listed here

Enable optional repos

sudo subscription-manager repos --enable=rhel-7-server-optional-rpms
sudo subscription-manager repos --enable=rhel-7-server-optional-source-rpms

Install Development Tools
```
sudo yum --setopt=group_package_types=mandatory,default,optional groupinstall "Development Tools"
```
If you get an error about git having conflicts, add --skip-broken to the command

Install additional packages

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

Build Fusion/Earth Server

cd earthenterprise/earth_enterprise
scons -j8 optimize=1 build

Install Fusion and Earth Server

For information on how to install Fusion Pro 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

Download a Swig Zip for Windows.
Extract the Zip in a desired installation directory.
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.