Upgrade¶
This section describes how to perform an upgrade to GeoCat Map 2026.0.
Before you start¶
Minor updates may be performed in place:
- GeoCat Recommends backing up your
GEOSERVER_DATA_DIR, and the configurationconf/Catalina/localhost/geoserver.xmlfile.
For major updates or migrating from an earlier version of GeoServer:
- GeoCat Recommends backing up your
GEOSERVER_DATA_DIR, and the configurationconf/Catalina/localhost/geoserver.xmlfile. - In general we do not recommend
- We do not recommend upgrading on a production server. Instead perform a new installation and transfer your data and settings to the new installation.
References:
GeoCat Map Upgrade¶
GeoCat Map Upgrades
| Release | GeoServer | Updates | Standard | Premium |
|---|---|---|---|---|
| GeoCat Map 2026 | 3.0 | 2026 | 2029 | 2031 |
| GeoCat Map 2025 | 2.27 | 2025 | 2028 | 2030 |
| GeoServer Enterprise 2024 | 2.25 2.26 |
2024 | 2027 | 2029 |
| GeoServer Enterprise 2023 | 2.23 2.24 |
2023 | 2026 | 2028 |
| GeoServer Enterprise 2022 | 2.21 2.22 |
2022 | 2025 | 2027 |
| GeoServer Enterprise 2021 | 2.20 2.19 |
2021 | 2024 | 2026 |
| GeoServer Enterprise 2020.5 | 2.18 2.17 |
2020 | 2023 | 2025 |
| GeoServer Enterprise 2.14 | 2.14 | 2019 | 2022 | 2024 |
| GeoServer Enterprise 2.13 | 2.13 | 2018 | 2021 | 2023 |
GeoCat Map is provided ready to use with popular extensions preinstalled.
GeoCat Map Premium is provided as a preconfigured web archive with the extensions you have requested. If you have chosen to remove an extension please work with our staff on the my.geocat.net support portal to determine if any modifications to your data directory are required during the upgrade process.
-
Follow install instructions to setup a new environment:
-
This is a good opportunity to update to:
-
Tomcat 11
-
Java Java 17
-
Make a backup of your existing
GEOSERVER_DATA_DIRECTORYprior to use.
Migrating Guidance¶
It is straight forward to migrate from the GeoServer Community Distribution to GeoCat Map.
Migration guidance for specific versions of GeoServer are noted below, along with timeframe for community updates and GeoCat support information.
References:
Migrate Guidance
| Version | Guidance | Updates | Standard | Premium |
|---|---|---|---|---|
| GeoServer 3.0 | Java 17 required | Early 2027 | 2026 | 2028 |
| GeoServer 2.28 | End of Java 11 support | Late 2026 | 2028 | 2028 |
| GeoServer 2.27 | Feburary 2026 | 2028 | 2028 | |
| GeoServer 2.26 | September 2025 | 2026 | 2028 | |
| GeoServer 2.25 | Feburary 2025 | 2026 | 2028 | |
| GeoServer 2.24 | August 2024 | 2026 | 2028 | |
| GeoServer 2.23 | End of Java 8 support | February 2024 | 2026 | 2028 |
| GeoServer 2.22 | February 2023 | 2025 | 2027 | |
| GeoServer 2.21 | February 2023 | 2025 | 2027 | |
| GeoServer 2.20 | September 2022 October 2021 |
2024 | 2026 | |
| GeoServer 2.19 | February 2022 March 2021 |
2024 | 2026 | |
| GeoServer 2.18 | August 2021 September 2020 |
2023 | 2025 | |
| GeoServer 2.17 | End of ArcSDE support | February 2021 April 2020 |
2023 | 2025 |
| GeoServer 2.16 | August 2020 September 2019 |
2022 | 2024 | |
| GeoServer 2.15 | Java 8 LTS minimum Java 11 LTS supported |
February 2020 March 2019 |
2022 | 2024 |
| GeoServer 2.14 | REST API geometry bindings, recommend re-testing automation scripts. | July 2019 September 2018 |
2021 | 2023 |
| GeoServer 2.13 | December 2018 March 2018 |
2021 | 2023 | |
| GeoServer 2.12 | REST API ported to spring-framework, recommend re-testing automation scripts. | August 2018 October 2017 |
2020 | 2022 |
| GeoServer 2.11 | February 2018 March 2017 |
2020 | 2022 | |
| GeoServer 2.10 | August 2017 October 2016 |
2019 | 2021 | |
| GeoServer 2.9 | Java 8 required | January 2017 May 2016 |
2019 | 2021 |
| GeoServer 2.8 | End of Java 7 Support | August 2016 September 2015 |
2018 | 2020 |
To migrate from GeoServer distribution to GeoCat Map:
-
Locate your
GEOSERVER_DATA_DIR: -
Binary:
data_dir - WAR:
webapps/geoserver/data - Windows:
C:\\ProgramData\\GeoServer\\Data - Windows:
C:\\Program Files\\GeoServer\\data_dir - Linux:
/usr/share/geoserver
Make a backup of your data directory:
2. Check for any configuration settings recorded in:- Windows:
bin/setenv.bat - Linux:
bin/setenv.sh - Linux:
/etc/default/tomcat8ortomcat9service, using aJAVA_OPTSenvironmental variable - Windows Service: Apache Tomcat 9.0 Tomcat Properties, where Java Options are located on the Java tab.
During upgrade any custom settings noted here can be applied to your new system following: Java Startup Options.
- Check if
conf/web.xmlhas enabled Cross-Origin Resource Sharing (CORS):
<filter>
<filter-name>CorsFilter</filter-name>
<filter-class>org.apache.catalina.filters.CorsFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>CorsFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
To enable CORS for your new system: CORS (now a built-in option for GeoSever 3.0).
-
Follow the GeoSever Enterprise installation instructions:
- Installation on Windows
Transfer your backup (the file :data.zip above) for use when setting up the GEOSERVER_DATA_DIR.
The file will be unpacked into the recommended location:
- Linux:
/var/opt/geoserver/data - Windows:
C:\\ProgramData\GeoServer\\Data
This GEOSERVER_DATA_DIR configuration will be updated in place as GeoServer starts up.