Package install on Red Hat

This page describes how to perform a package installation of Boundless Server 1.1.1 on Red hat-based Linux distributions.

Note

For upgrades, see the below section on Upgrading.

System requirements

The following distributions are supported:

  • CentOS 6 (64-bit)
  • CentOS 7 (64-bit)
  • RHEL 6 (64-bit)
  • RHEL 7 (64-bit)

Boundless Server for Red Hat has the following system requirements:

  • Memory: 1GB minimum (2GB recommended)
  • Disk space: 750MB minimum (plus extra space for any loaded data)
  • Browser: We recommend Firefox (an xml extension is recommended)
  • 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 Red hat-based Linux distributions.

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. Download the Boundless key

    mkdir -p /etc/pki/boundless
    wget -O /etc/pki/boundless/GPG-KEY-Boundless https://downloads-repo.boundlessgeo.com/GPG-KEY-Boundless
    
  3. Add the Boundless Server repository by creating the file /etc/yum.repos.d/Boundless.repo and adding the following contents:

    (Enterprise Linux 6)

    [boundless-server]
    name=Boundless Server Repository
    baseurl=https://<username>:<password>@downloads-repo.boundlessgeo.com/server-repo/1.1.1/el/6/x86_64
    enabled=1
    gpgcheck=1
    gpgkey=file:///etc/pki/boundless/GPG-KEY-Boundless
    

    (Enterprise Linux 7)

    [boundless-server]
    name=Boundless Server Repository
    baseurl=https://<username>:<password>@downloads-repo.boundlessgeo.com/server-repo/1.1.1/el/7/x86_64
    enabled=1
    gpgcheck=1
    gpgkey=file:///etc/pki/boundless/GPG-KEY-Boundless
    

    Make sure to replace <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, replace the @ in your username with %40.

    Note

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

  4. Search for Boundless packages to verify that the repository list is correct.

    yum list boundless-server-*
    

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

  5. You have options on what packages to install. A standard installation including common packages is as follows:

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

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

      yum install boundless-server-dashboard \
                  boundless-server-geoserver \
                  boundless-server-geowebcache \
                  boundless-server-composer \
                  boundless-server-docs \
                  boundless-server-quickview  \
                  boundless-server-wpsbuilder \
                  postgis23-postgresql96 \
                  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.

  6. Restart the server.

    service tomcat8 restart
    
  7. 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 Red Hat 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 suite-docs tomcat context file located in /etc/tomcat8/Catalina/localhost/suite-docs.xml, please back it up now or your changes will be lost (The other context files will be preserved).

  1. Change to the root user:

    sudo su -
    
  2. Replace the 4.10.0 repo definition with the new repo definition. Open /etc/yum.repos.d/Boundless.repo and replace the contents with:

    [boundless-server]
    name=Boundless Server Repository
    baseurl=https://<username>:<password>@downloads-repo.boundlessgeo.com/server-repo/1.1.1/el/6/x86_64
    enabled=1
    gpgcheck=1
    gpgkey=file:///etc/pki/boundless/GPG-KEY-Boundless
    

    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, replace the @ in your username with %40.

  3. Refresh the yum repo data:

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

    yum install boundless-server-geoserver boundless-server-docs boundless-server-dashboard
    
  5. Update the tomcat context files. For each file ending in ”.new” in /etc/tomcat8/Catalina/localhost/, copy it to a ”.xml” file. For example:

    cp -p geoserver.xml.new geoserver.xml
    
  6. If you had previously made any changes to the context files, copy these changes from the ”.orig” file into the corresponding ”.xml” file.

  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:

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 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 backed up files.

  1. Change to the root user:

    sudo su -
    
  2. Remove the 4.9.0 packages:

    yum remove suite-*
    

    Make note of which packages were removed this way.

  3. Download the Boundless key:

    wget -O /etc/pki/boundless/GPG-KEY-Boundless https://downloads-repo.boundlessgeo.com/GPG-KEY-Boundless
    
  4. Replace the 4.9.0 repo definition with the new repo definition. Open /etc/yum.repos.d/Boundless.repo and replace the contents with:

    [boundless-server]
    name=Boundless Server Repository
    baseurl=https://<username>:<password>@downloads-repo.boundlessgeo.com/suite-repo/4.9.1/el/6/x86_64
    enabled=1
    gpgcheck=1
    gpgkey=file:///etc/pki/boundless/GPG-KEY-Boundless
    

    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, replace the @ in your username with %40.

  5. Refresh the yum repo data:

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

    yum install suite-geoserver suite-docs suite-dashboard
    

Upgrading from 4.8 and older

This section describes how to upgrade OpenGeo Suite 4.8 and earlier to 1.1.1 on Red Hat-based Linux distributions.

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.

    yum --setopt=clean_requirements_on_remove=1 remove \
                    tomcat \
                    tomcat-* \
                    geoexplorer \
                    geos-* \
                    geoserver \
                    geoserver-* \
                    geowebcache \
                    laszip \
                    laszip-devel \
                    gdal-devel \
                    gdal-mrsid \
                    gdal \
                    ght \
                    ght-devel \
                    laszip \
                    laszip-devel \
                    libgeotiff \
                    libgeotiff-devel \
                    libjpeg-turbo-official \
                    opengeo \
                    opengeo-* \
                    pdal \
                    pdal-devel \
                    pgadmin3 \
                    pgadmin3-docs \
                    pointcloud-* \
                    postgis2* \
                    postgresql \
                    postgresql* \
                    proj-* \
                    proj \
                    wxBase \
                    wxGTK \
                    wxGTK-*
    
  4. Remove the reference to the Suite 4.8 repository:

    rm /etc/yum.repos.d/OpenGeo.repo
    
  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 use the standard RPM format used in Red Hat-based systems. All packages can be installed with the following command:

yum 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
gdal Main GDAL/OGR binary package
gdal-java Java support for GDAL
gdal-devel Development support for GDAL
gdal-mrsid MrSID plugin for GDAL
libjpeg-turbo-official Libjpeg turbo binaries (version 1.4.2)
netcdf NetCDF Binary packages
netcdf-devel Development support for the NetCDF Binary
postgis23-postgresql96 Postgresql and PostGIS
proj PROJ.4 libary
geos-3.5.0 GEOS (Geometry Engine, Open Source) library