230 lines
5.4 KiB
ReStructuredText
230 lines
5.4 KiB
ReStructuredText
**********************
|
|
Overview
|
|
**********************
|
|
|
|
.. contents:: Table of Contents
|
|
|
|
Version
|
|
==================
|
|
|
|
GeoSuite installs the latest, stable version of GeoServer.
|
|
|
|
|
|
Control Panel
|
|
=============
|
|
|
|
Within the control panel, GeoServer can be accessed via Servers > GeoServer
|
|
|
|
.. image:: _static/geoserver-panel-1.png
|
|
|
|
The GeoServer tab checks that GeoServer is installed.
|
|
|
|
.. image:: _static/geoserver-tab.png
|
|
|
|
If not, it can be installed using the "Install Now" button.
|
|
|
|
This will install the latest, stable version of GeoServer.
|
|
|
|
|
|
Edit Config
|
|
---------------
|
|
.. image:: _static/config-tab.png
|
|
|
|
The Config tab is used to edit the following files
|
|
|
|
.. code-block:: console
|
|
|
|
server.xml
|
|
web.xml
|
|
context.xml
|
|
tomcat-users.xml
|
|
setenv.sh
|
|
|
|
These files can, of course, be edited via the file system or VI as well.
|
|
|
|
|
|
Apps
|
|
---------------
|
|
.. image:: _static/apps-tab.png
|
|
|
|
The Apps manager allows you to deploy, undeploy, and redeploy WAR files in Apache Tomcat
|
|
|
|
|
|
Java
|
|
---------------
|
|
.. image:: _static/java-tab.png
|
|
|
|
The Java tab is used during installation as well as for updating of JDK.
|
|
|
|
It can also be used to un-install the selected JDK and replace it with a new version.
|
|
|
|
|
|
.. image:: _static/java-installed.png
|
|
|
|
|
|
.. note::
|
|
When installing or removing, there is an option to set as System default.
|
|
|
|
|
|
|
|
Location
|
|
==================
|
|
|
|
By default, GeoServer is installed at /home/tomcat/apache-tomcat-<version>/webapps/geoserver
|
|
|
|
To make upgrading easier, you should always change the GeoServer Data Directory location.
|
|
|
|
To install GeoServer extensions, see our guide
|
|
|
|
As we can see above, the creation of our NewReports Directory has been added to the directory structure. This is true for all directories and sub directories added.
|
|
|
|
Geoserver Extensions
|
|
====================
|
|
|
|
GeoServer Extensions can be installed as below.
|
|
|
|
Below, we are installing the MapFish Print Module via SSH.
|
|
|
|
**1. Switch to user tomcat**
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
su - tomcat
|
|
|
|
|
|
**2. Change to the GeoServer /lib directory (adjust for your own version of Tomcat)**
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
cd /home/tomcat/apache-tomcat-9.0.70/webapps/geoserver/WEB-INF/lib
|
|
|
|
|
|
**3. Download the desired extension, making sure to match the version to your GeoServer version**
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
wget http://sourceforge.net/projects/geoserver/files/GeoServer/2.23.1/extensions/geoserver-2.23.1-printing-plugin.zip
|
|
|
|
|
|
**4. Unzip the downloaded file**
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
unzip -q geoserver-2.23.1-printing-plugin.zip
|
|
|
|
|
|
**5. Remove the zip file**
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
rm -f geoserver-2.23.1-printing-plugin.zip
|
|
|
|
**6. Restart Tomcat for the extension to take effect.**
|
|
|
|
.. Note:: Some components, such as GDAL, require additional configuration.
|
|
|
|
|
|
Data Directory
|
|
==============
|
|
|
|
To make GeoServer more portable and easier to upgrade, you should change the GeoServer data directory.
|
|
|
|
Follow the instructions below, substituting your own paths and file names.
|
|
|
|
**1. Stop Tomcat**
|
|
|
|
**2. Connect via SSH and move the data directory as below: (Important: the target directory - 'geodata' below - should not exist.)**
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
mv /home/tomcat/apache-tomcat-9.0.70/webapps/geoserver/data/ /var/lib/geodata/
|
|
|
|
chown -R tomcat:tomcat /var/lib/geodata/
|
|
|
|
**3. Add the following to your GeoServer web.xml file:**
|
|
|
|
.. code-block:: xml
|
|
|
|
|
|
<context-param>
|
|
<param-name>GEOSERVER_DATA_DIR</param-name>
|
|
<param-value>/var/lib/geodata</param-value>
|
|
</context-param>
|
|
|
|
<context-param>
|
|
<param-name>GEOSERVER_REQUIRE_FILE</param-name>
|
|
<param-value>/var/lib/geodata/global.xml</param-value>
|
|
</context-param>
|
|
|
|
**4. Start Tomcat**
|
|
|
|
You should log into GeoServer and verify that your workspaces, etc.. are accesible.
|
|
|
|
|
|
CSRF Whitelist
|
|
==============
|
|
|
|
GeoServer includes CSRF Protection to protect against form submission that did not originate from your GeoServer instance.
|
|
|
|
Follow the instructions below, substituting your own paths and file names.
|
|
|
|
**1. Stop Tomcat**
|
|
|
|
**2. Connect via SSH and move the geoserver WEB-INF directory**
|
|
|
|
**3. Add the following after the last context-param entry, subsituting your own domain for the param value**
|
|
|
|
.. code-block:: xml
|
|
|
|
|
|
<context-param>
|
|
<param-name>GEOSERVER_CSRF_WHITELIST</param-name>
|
|
<param-value>YOURDOMAIN.COM</param-value>
|
|
</context-param>
|
|
|
|
**4. Save the file and restart Tomcat for change to take effect**
|
|
|
|
|
|
Enable CORS
|
|
==============
|
|
|
|
To enable Cross-Origin Resource Sharing (CORS) it's best to do so using the Tomcat web.xml configuration file.
|
|
|
|
Follow the instructions below, substituting your own paths and file names.
|
|
|
|
**1. Stop Tomcat**
|
|
|
|
**2. Connect via SSH and move the Tomcat WEB-INF directory**
|
|
|
|
**3. Add the following above the closing <//web-app> tag**
|
|
|
|
.. code-block:: xml
|
|
|
|
|
|
<filter>
|
|
<filter-name>CorsFilter</filter-name>
|
|
<filter-class>org.apache.catalina.filters.CorsFilter</filter-class>
|
|
<init-param>
|
|
<param-name>cors.allowed.origins</param-name>
|
|
<param-value>*</param-value>
|
|
</init-param>
|
|
<init-param>
|
|
<param-name>cors.allowed.methods</param-name>
|
|
<param-value>GET,POST,HEAD,OPTIONS,PUT</param-value>
|
|
</init-param>
|
|
</filter>
|
|
<filter-mapping>
|
|
<filter-name>CorsFilter</filter-name>
|
|
<url-pattern>/*</url-pattern>
|
|
</filter-mapping>
|
|
|
|
Important: Above is a permissive CORS configuration. You should adjust to suit your needs and requirements.
|
|
|
|
|