Installing Boundless SDK

There are two ways to install Boundless SDK: as part of OpenGeo Suite and standalone.

Installation with OpenGeo Suite

Boundless SDK is easiest to install as part of OpenGeo Suite.

Windows

Boundless SDK is included in OpenGeo Suite for Windows as an optional component.

  1. A Java Development Kit (JDK) will need to be downloaded and installed. The standard Java Runtime Environment (JRE) bundled with OpenGeo Suite is not sufficient. To verify installation execute the command javac -version from the command prompt.
  2. The build utility Apache Ant will need to be downloaded, installed and included on the PATH. To verify this, execute the command ant -version from a command prompt.
  3. During the OpenGeo Suite for Windows process, on the Components page, expand the Dev Tools tree and select Boundless SDK.

OS X

Boundless SDK is part of the OS X OpenGeo Suite CLI tools.

  1. A Java Development Kit (JDK) will need to be downloaded and installed. The standard Java Runtime Environment (JRE) bundled with OpenGeo Suite is not sufficient. To verify installation execute the command javac -version from the command prompt.

  2. The build utility Apache Ant will need to be downloaded, installed and included on the PATH. To verify this, execute the command ant -version from a command prompt.

  3. In the OpenGeo folder, double-click OpenGeo CLI Tools.

    ../_images/apps1.png
  4. Follow the installation process to install the CLI tools, including Boundless SDK.

  5. Add /usr/local/opengeo/bin to your PATH as described in the OS X CLI tools installation section.

  6. To verify installation, type suite-sdk on a terminal.

Ubuntu Linux

Boundless SDK is available as an individual package, installed through standard package management.

  1. Install the package is called opengeo-webapp-sdk.

    sudo apt-get install opengeo-webapp-sdk
    
  2. This package depends on ‘OpenJDK 7 <http://openjdk.java.net>`_ . To verify this is available, execute the command javac -version from the command prompt.

  3. This package depends on Apache Ant . To verify this is available, execute the command ant -version from a command prompt.

Red Hat-based Linux

Boundless SDK is available as an individual package, installed through standard package management.

  1. Install the package called opengeo-webapp-sdk.

    sudo yum install opengeo-webapp-sdk
    
  2. This package depends on ‘OpenJDK 7 <http://openjdk.java.net>`_ . To verify this is available, execute the command javac -version from the command prompt.

  3. This package depends on Apache Ant . To verify this is available, execute the command ant -version from a command prompt.

Application Servers

For installation when using OpenGeo Suite for Application Servers, please see the section on standalone installation.

Standalone installation

Boundless SDK can also be installed on a machine that does not have OpenGeo Suite.

  1. A Java Development Kit (JDK) will need to be installed and configured. The standard Java Runtime Environment (JRE) is not sufficient. After installation, to verify this is available, execute the command javac -version from the command prompt.
  2. This package depends on Apache Ant . After installation, to verify this is available, execute the command ant -version from a command prompt.
  3. Download Boundless SDK from http://boundlessgeo.com/solutions/solutions-software/software/, making sure to match the version of the SDK with the version of OpenGeo Suite.
  4. Extract the archive to a suitable location on the file system.
  5. Add the SDK bin directory to the PATH.
  6. To verify the SDK is installed properly, execute the command suite-sdk from a command prompt.

Troubleshooting

If you receive the following error when running suite-sdk:

Unable to locate tools.jar.

This means that your system is using a JRE and not a JDK. Make sure that you have downloaded and installed a JDK, and set the JAVA_HOME environment variable to point to the JDK. For example, if you installed a JDK in C:\Program Files\Java\jdk1.7.0, then set the JAVA_HOME variable to C:\Program Files\Java\jdk1.7.0\jre.