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. During the OpenGeo Suite for Windows process, on the Components page, expand the Dev Tools tree and select Boundless SDK.

If you have already installed OpenGeo Suite, the installer can be rerun and just this option checked. That will install the SDK without affecting the current installation.

../_images/winwebappsdk.png

Installing the SDK from the Components page

OS X

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

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

    ../_images/apps1.png

    OpenGeo CLI Tools

  2. Follow the installation process to install the CLI tools, including Boundless SDK.

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

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

Ubuntu Linux

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

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

    sudo apt-get install opengeo-webapp-sdk

Red Hat-based Linux

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

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

    sudo yum install opengeo-webapp-sdk

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. Install a Java Runtime Environment (JRE) After installation, to verify this is available, execute the command java -version from the command prompt.

    Note

    The java command may need to be added to the PATH if it is not done automatically.

  2. The SDK depends on Apache Ant . After installation, to verify this is available, execute the command ant -version from the 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.