Skip to content

Install on Linux or Mac

Jump to bottom
Justin Lewis edited this page Nov 21, 2022 · 4 revisions

General Software Requirements

  • Java Open JDK 1.8
  • PostgreSQL 9.0 or greater
  • PostGIS 2.0 or greater
  • Orient DB

Development Environment Recommendations

  • Eclipse IDE for Java EE developers. You may not be able to use the latest version of Eclipse because there may not be AspectJ support yet. Check the Eclipse AJDT website first to find out what version of Eclipse you want to download.
  • AspectJ Development Tools Eclipse plugin (Must be the correct version for your Eclipse. For example with Eclipse Neon, use version 2.2.4).
  • These should come standard with Eclipse: Maven, m2e

Download Eclipse

Be sure to download a version of Eclipse that is compatible with AJDT and specifies it’s for Jave EE developers.

The AJDT download link will show you what versions of Eclipse are compatible with AJDT: https://www.eclipse.org/ajdt/downloads/index.php

For a tested version of Eclipse Photon download from here: https://www.eclipse.org/downloads/packages/release/photon/r

Configure Eclipse

Install EGit

  1. Install EGit if it is not already installed. EGit should be included with Eclipse.

Install m2e

  1. Install Maven Integration for Eclipse - m2e (aka m2eclipse) if it is not already installed. m2e should be included with Eclipse Luna.

Install AJDT

  1. Install AJDT if it is not already installed.
  2. In Eclipse go to ‘help -> Install New Software’
  3. Enter this URL in the input field ‘http://dist.springsource.org/release/AJDT/configurator/’

Install M2E connector, buildhelper

  1. In Eclipse go to ‘window -> Preferences -> Maven -> Discovery -> Open Catalog’.
  2. Search for buildhelper (by Sonatype) and install.

Install And Setup The Database

  1. Install PostgreSQL 9.0 + using whatever method you prefer.
  2. After installing PostgreSQL create a database called “template-postgis”.
  3. Spatially enable the template-postgis database by installing PostGIS with the SQL command: CREATE EXTENSION postgis;

Download and Load GeoPrism Into Eclipse

Load Into Eclipse

  1. In Eclipse go to ‘File -> Import -> Git -> Projects From Git -> Clone URI’.
  2. Set:
  • URI : [email protected]:terraframe/geoprism.git
  • Host : github.com
  • Repository path : terraframe/geoprism.git
  • User : git
  1. Click “Next”. Follow the wizard, and when asked to select projects to import select the following (at a minimum):
  • dev
  • master
  1. Click to download the repository
  2. Select “Import existing projects”
  3. Select all of the projects to import and make sure that “Search for nested projects” is checked.

Configure

  1. Configure the database properties by modifying the database properties in server.properties in geoprism-server to:
  • user=geoprism
  • password=geoprism
  • databaseName=geoprism

Create And Configure The Database

  1. Create a new database called ‘geoprism’ using template-postgis as a template to ensure PostGIS is included.
  2. If you don’t have a template-postgis database you can enable postgis by running the SQL command:

CREATE EXTENSION postgis;

Install Java

  1. If you don’t already have it installed you should install Java Open JDK.

Install The Build Tools

Install Maven

Install Maven with the following terminal command: sudo apt-get install maven

Configure A Basic Maven Build

  1. Create a new Maven build defining the following properties:
  • goals : clean install -P geoprism-cargo-run-debug
  • params : configuration.dir
  1. Define the base directory as ${workspace_loc:/geoprism}
  2. Add a new parameter:
  • Name: configuration.dir
  • Value: ${workspace_loc:/geoprism-platform}/Customer_projects/
Clone this wiki locally