Installing Boundless SDK

To create an application with Boundless SDK, you will need:

  • Boundless SDK installed. See the next section for installation details.
  • A Java Development Kit (JDK). A standard Java Runtime Environment (JRE) is not sufficient.
  • Apache Ant installed and on the PATH. To verify this, execute the command ant -version from a command prompt.

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.

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

  2. Follow the instllation 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. The package is 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. The package is 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. 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.
  2. Extract the archive to a suitable location on the file system.
  3. Add the SDK bin directory on the PATH.

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.