Installation

Installation is done via the GeoSuite Installer.

Check Hostname

While you can use GeoSuite with only an IP address, if you wish to use SSL, be sure to set the hostname.

You can check using the ‘hostname’ command

root@suite:~# hostname
suite

If the full hostname is not set, use hostnamectl to set the full hostname:

root@suite:~# hostnamectl set-hostname suite.domain.com

Use the hostname command to verify the full hostname is now set:

root@suite:~# hostname
suite.domain.com

Note

If using Rocky Linux, you may need to install wget before running the Installer. You can do using ‘yum -y install wget’

Run the Installer

On a fresh Ubuntu 22 or Rocky Linux 9 installation, as root:

wget https://raw.githubusercontent.com/AcuGIS/GeoSuite/master/scripts/geosuite-installer.sh && chmod +x geosuite-installer.sh && ./geosuite-installer.sh

The above will start the installer

Select the installation type you would like, either full (GeoSuite with QuartzMap) or GeoSuite Standalone

Tab to the OK button and hit enter

A reminder is displayed to set the hostname. If you have set the hostname, or do not wish to use SSL, hit continue

A prompt will ask you if you would like GeoSuite to provision a free SSL certificate using LetsEncrypt

The installation progressed is displayed as below.

A full installation with MapStore2 on Ubuntu takes about 3 to 4 minutes to complete installation.

A full installation with Rocky Linux can take 10-15 minutes due to manual OSM build required.

Upon completion the display will show as below:

Installation is now completed.
postgres, Tomcat, and crunchy pg passwords are saved in /root/auth.txt file
SSL Provisioning Success.

Click the Login link on the homepage to access the control panel.

If you elected to enable QuartzMap, go to https://yourdomain.com/quartzmap/admin/setup.php and enter your information

The passwords are also stored in the file /root/auth.txt following set up

Enable SSL

If you did not have the GeoSuite installer enable SSL, you can use the script below to issue a certificate and configure Apache, the control panel, and pg_tileserv for SSL.

wget https://raw.githubusercontent.com/AcuGIS/geosuite/master/scripts/build-ssl.sh && chmod +x build-ssl.sh && ./build-ssl

After a few moments you should see the success message below:

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/suite.domain.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/suite.domain.com/privkey.pem
This certificate expires on 2023-09-19.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate
Successfully deployed certificate for suite.webgis1.com to /etc/apache2/sites-available/000-default-le-ssl.conf
Congratulations! You have successfully enabled HTTPS on https://suite.domain.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
If you like Certbot, please consider supporting our work by:
 * Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donating to EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

SSL is now enabled for Apache, control panel, pg_tileserv, and pg_featursrv

Troubleshooting

GeoSuite creates a log file for each installation process.

The files are located in the /tmp directory (screenshot below).

If installation fails, check the last log file generated to see the cause of the failure.

Removing the Control Panel

If you do not wish to use the control panel for any reason, it can be removed using below.

Removing the control panel has no effect on any of the components (PostGIS, GeoServer, etc…)

root@suite:~# ./etc/webmin/uninstall.sh