GeoHelm/docs/geoserver/geoservers/index.rst

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.