Package install on Ubuntu

This page describes how to perform a package installation of Boundless Server 1.1.1 on Ubuntu Linux.

Note

For upgrades, see the section on Upgrading below.

System requirements

The following Ubuntu versions are supported:

Boundless Server for Ubuntu Linux has the following system requirements:

  • Memory: 1G minimum (2GB recommended)
  • Disk space: 750MB minimum (plus extra space for any loaded data)
  • Browser: Any modern web browser is supported
  • Permissions: Super user privileges are required for installation

New installation

This section describes how to perform a clean package installation of Boundless Server 1.1.1 on Ubuntu Linux.

See the Package list for details about the possible packages to install.

Warning

Mixing repositories is not recommended. If you already have a community (non-Boundless) repository that contains some of the components of Boundless Server (such as PostgreSQL) please remove them before installing Boundless Server.

  1. Change to the root user:

    sudo su -
    
  2. Import the Boundless GPG key:

    wget -qO- https://downloads-repo.boundlessgeo.com/GPG-KEY-Boundless | apt-key add -
    
  3. Add the Boundless repository:

    (Ubuntu 14)

    echo "deb [arch=amd64] https://<username>:<password>@downloads-repo.boundlessgeo.com/server-repo/1.1.1/ubuntu/14 trusty main" > /etc/apt/sources.list.d/boundless.list
    

    (Ubuntu 16)

    echo "deb [arch=amd64] https://<username>:<password>@downloads-repo.boundlessgeo.com/server-repo/1.1.1/ubuntu/16 xenial main" > /etc/apt/sources.list.d/boundless.list
    

    Make sure to replace each instance of <username> and <password> with the user name and password supplied to you.

    Note

    Your username is your email address. When entering your username into the Boundless.repo file, the @ in your username should be preserved as-is.

    Note

    Please contact us if you have purchased Boundless Server and do not have a user name and password.

  4. Update the repository list:

    apt-get update
    
  5. Search for Boundless packages to verify that the repository list is correct.

    apt-cache search boundless-server-
    

    If the command does not return any results, examine the output of the apt-cache command for any errors or warnings.

  6. You have options on what packages to install.

    • A simple installation including GeoServer, documentation, and the Dashboard:

      apt-get install boundless-server-geoserver boundless-server-docs boundless-server-dashboard
      
    • A more complete install, including all the web applications, PostGIS, GDAL, and NetCDF:

      apt-get install boundless-server-dashboard \
                      boundless-server-geoserver \
                      boundless-server-geowebcache \
                      boundless-server-composer \
                      boundless-server-docs \
                      boundless-server-quickview  \
                      boundless-server-wpsbuilder \
                      postgresql-9.6-postgis-2.3 \
                      boundless-server-gs-gdal \
                      boundless-server-gs-netcdf \
                      boundless-server-gs-netcdf-out
      

    Note

    See the Package list for details of individual packages.

    Note

    If you already have an existing JVM installed, you may need to change the default java. Run java -version to check the default java version. If it is less than 1.8, use update-alternatives to change the default to the newly installed java 8 JVM.

  7. Restart the server.

    service tomcat8 restart
    
  8. Verify that the installation succeeded by opening your browser and navigating to one of the following URLs:

    Note

    Please see the section on Administration on Ubuntu for additional information and best practices.

Upgrade

Upgrading from 4.9.1 or 4.10.0 to 1.1.1

This section describes how to upgrade Boundless Suite 4.9.1 or 4.10.0 to Boundless Server 1.1.1 on Red Hat-based Linux distributions.

Note

If you made changes to the tomcat context files located in /etc/tomcat8/Catalina/localhost/, please back them up now or your changes will be lost. After completing the upgrade process, restore the relevant portions of the backed up files.

  1. Change to the root user:

    sudo su -
    
  2. Replace the 4.10.0 repo definition with the new repo definition. Open /etc/apt/sources.list.d/boundless.list and replace the contents with:

    deb [arch=amd64] https://<username>:<password>@downloads-repo.boundlessgeo.com/server-repo/1.1.1/ubuntu trusty main
    

    Make sure to replace each instance of <username> and <password> with the user name and password supplied to you.

    Note

    Your username is your email address. When entering your username into the Boundless.repo file, the @ in your username should be preserved as-is.

  3. Refresh the apt repo data:

    apt-get update
    
  4. Install all Boundless Server 1.1.1 packages corresponding to the suite-* packages which are currently installed. For example:

    apt-get install boundless-server-geoserver boundless-server-docs boundless-server-dashboard
    
  5. Restart the server.

    service tomcat8 restart
    
  6. Verify that the installation succeeded by opening your browser and navigating to one of the following URLs:

Upgrading from 4.9.0 to 4.9.1

This section describes how to upgrade Boundless Suite 4.9.0 to Boundless Suite 4.9.1 on Ubuntu Linux.

Note

If you made changes to the tomcat context files located in /etc/tomcat8/Catalina/localhost/, please back them up now or your changes will be lost. After completing the upgrade process, restore the backed up files.

  1. Change to the root user:

    sudo su -
    
  2. Remove the 4.9.0 packages:

    apt-get remove suite-*
    

    Make note of which packages were removed this way.

  3. Import the Boundless GPG key:

    wget -qO- https://downloads-repo.boundlessgeo.com/GPG-KEY-Boundless | apt-key add -
    
  4. Replace the 4.9.0 repo definition with the new repo definition. Open /etc/apt/sources.list.d/boundless.list and replace the contents with:

    deb [arch=amd64] https://<username>:<password>@downloads-repo.boundlessgeo.com/suite-repo/4.9.1/ubuntu trusty main
    

    Make sure to replace each instance of <username> and <password> with the user name and password supplied to you.

    Note

    Your username is your email address. When entering your username into the Boundless.repo file, the @ in your username should be preserved as-is.

  5. Refresh the apt repo data:

    apt-get update
    
  6. Install all Boundless Suite 4.9.1 packages corresponding to the suite-* packages which were removed in step 1. For example:

    apt-get install suite-geoserver suite-docs suite-dashboard
    

Upgrading from 4.8 and older

This section describes how to upgrade Boundless Server 4.8 and earlier to 1.1.1 on Ubuntu Linux.

Warning

We do not recommend upgrading Boundless Server on a production server. Instead, do a new install on new machine, then transfer your data and settings to the new machine.

Warning

Because of the major package changes involved, if you have any version earlier than 4.9.0, it must be uninstalled first. Make sure you backup your data, configuration, your old 4.8 install, and any other data/software on the system.

The data directory at /var/lib/opengeo/geoserver will not be removed during uninstallation.

  1. Backup your configuration and data

  2. Change to the root user:

    sudo su -
    
  3. Uninstall old packages:

    Warning

    This will uninstall many packages (including tomcat7, postgresql/postgis, and other common GIS tools). Verify that removing these packages will not interfere with other applications running on your system. Ensure you do not have another Tomcat (or other service) on port 8080.

    apt-get remove gdal-mrsid \
                   geoexplorer \
                   geoserver \
                   geoserver-* \
                   geowebcache \
                   laszip \
                   laszip-dev \
                   libgdal-opengeo \
                   libgdal-opengeo-dev \
                   libgeos-3.5.0 \
                   libgeos-c1 \
                   libgeos-dev \
                   libgeos-doc \
                   libgeotiff \
                   libgeotiff-dev \
                   libght \
                   libght-dev \
                   libjpeg-turbo-official \
                   libpq5 \
                   libproj-dev \
                   libproj0 \
                   opengeo \
                   opengeo-* \
                   pdal \
                   pdal-dev \
                   pgadmin3 \
                   pgadmin3-data \
                   postgis-* \
                   postgresql-* \
                   proj \
                   proj-bin \
                   proj-data \
                   tomcat7
    apt-get autoremove
    
  4. Remove the reference to the Suite 4.8 repository:

    rm /etc/apt/sources.list.d/opengeo.list
    
  5. Continue above in the New installation section. When finished, change your GEOSERVER_DATA_DIR environment variable to point to the correct location.

    Note

    A default installation of Boundless Server, will install a sample GeoServer data directory. Make sure to update the GEOSERVER_DATA_DIR environment variable to point to your old data directory, if desired.

Package list

Boundless Server is broken up into a number of discrete packages. This section describes all of the available packages.

The packages are managed through the standard package management system for Ubuntu called apt. All packages can be installed with the following command:

sudo apt-get install <package>

where <package> is any one of the package names listed below.

Boundless Server web applications

Package Description
boundless-server-composer Composer application
boundless-server-dashboard Boundless Server Dashboard
boundless-server-docs Boundless Server documentation
boundless-server-geoserver GeoServer application
boundless-server-geowebcache GeoWebCache application
boundless-server-quickview QuickView application showcasing the WebSDK
boundless-server-wpsbuilder Graphical utility for executing WPS processes
boundless-server-tomcat8 Apache Tomcat application server (automatically installed by these packages)

Boundless Server GeoServer extensions

The following packages add additional functionality to GeoServer. After installing any of these packages, you will need to restart Tomcat:

service tomcat8 restart

For more information, please see the section on GeoServer extensions.

Package Description
boundless-server-gs-app-schema Application Schema support
boundless-server-gs-arcsde ArcSDE extension
boundless-server-gs-cloudwatch Connection to Amazon CloudWatch monitoring
boundless-server-gs-cluster Clustering extension. Use with boundless-server-gs-jdbcconfig.
boundless-server-gs-csw Catalogue Service for Web (CSW) extension
boundless-server-gs-db2 DB2 database extension
boundless-server-gs-gdal GDAL extension
boundless-server-gs-geomesa-accumulo GeoMesa data source support
boundless-server-gs-grib GRIB data format extension
boundless-server-gs-gsr GeoServices REST API extension
boundless-server-gs-inspire Additional WMS and WFS metadata configuration for INSPIRE compliance
boundless-server-gs-jdbcconfig Database catalog and configuration extension. Use with boundless-server-gs-cluster.
boundless-server-gs-jdbcstore JDBCStore extension
boundless-server-gs-jp2k JPEG2000 extension
boundless-server-gs-mongodb MongoDB data format extension
boundless-server-gs-netcdf NetCDF data format support (read-only)
boundless-server-gs-netcdf-out NetCDF data format support (output)
boundless-server-gs-oracle Oracle database extension
boundless-server-gs-printng Printing Extension
boundless-server-gs-script Scripting (Python) extension
boundless-server-gs-sqlserver SQL Server database extension
boundless-server-gs-vectortiles Vector tiles extension

Binary packages

The following major binary packages are available:

Package Description
libgdal Main GDAL/OGR binary package
libgdal-java Java support for GDAL
libgdal-dev Development support for GDAL
gdal-mrsid MrSID plugin for GDAL
libjpeg-turbo-official Libjpeg turbo binaries (version 1.4.2)
libnetcdf-bin NetCDF Binary packages
libnetcdf-dev Development support for the NetCDF Binary
postgresql-9.6-postgis-2.3 PostgreSQL and PostGIS
proj PROJ.4 libary
libgeos-3.5.0 GEOS (Geometry Engine, Open Source) library