GeoHelm/docs/geoserver/tomcat/index.rst

130 lines
3.0 KiB
ReStructuredText

.. This is a comment. Note how any initial comments are moved by
transforms to after the document title, subtitle, and docinfo.
.. demo.rst from: http://docutils.sourceforge.net/docs/user/rst/demo.txt
.. |EXAMPLE| image:: static/yi_jing_01_chien.jpg
:width: 1em
**********************
Apache Tomcat
**********************
.. contents:: Table of Contents
Layout
======
The Apache Tomcat (CATALINA) home directory is::
/home/tomcat/apache-tomcat-v/
Where apache-tomcat-v is the version installed.
The CATALINA_HOME variable is set both in the Tomcat init script as well as setenv.sh files.
Starting and Stopping
=====================
There are two ways to start/stop/restart Tomcat.
1. Via Module, using the Stop/Start/Restart buttons as shown below::
.. image:: _static/tomcat-functions.png
2. Via SSH, using the following commands
.. code-block:: console
systemctl { start | stop | restart | status } tomcat
3. If Tomcat is not responding, you can also issue, as root
.. code-block:: console
pkill -9 java
Service
===========
Tomcat runs as a system service.
The service file is located at /etc/systemd/system/tomcat.service
The content of the tomcat.service file are below:
.. code-block:: bash
[Unit]
Description=Tomcat ${TOMCAT_VER}
After=multi-user.target
[Service]
User=tomcat
Group=tomcat
WorkingDirectory=${CATALINA_HOME}
Type=forking
Restart=always
EnvironmentFile=/etc/environment
ExecStart=$CATALINA_HOME/bin/startup.sh
ExecStop=$CATALINA_HOME/bin/shutdown.sh 60 -force
[Install]
WantedBy=multi-user.target
Any changes to the system file should be followed by
.. code-block:: bash
systemctl daemon-reload
Version
=======
By default, Tomcat 9.x latest is used
Tomcat Users
=================
On installation, random passwords are generated for both the admin and manager roles.
The passwords can be found at /home/tomcat/apache-tomcat-version/conf/tomcat-users.xml
.. code-block:: xml
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="manager-gui" />
<user username="manager" password="aupiZ0GlzHAaC5-8GgL2gAi7XNuEiTE0" roles="manager-gui" />
<role rolename="admin-gui" />
<user username="admin" password="67Jyz1EdDXmmFfOL9DOBFzuwr17MUgLa" roles="manager-gui,admin-gui" />
</tomcat-users>
setenv.sh
==============
The setenv.sh file is located at /home/tomcat/apache-tomcat-version/bin/setenv.sh
The default parameters set by GeoSuite are:
.. code-block:: java
CATALINA_PID="/home/tomcat/apache-tomcat-9.0.76/temp/tomcat.pid"
JAVA_OPTS="${JAVA_OPTS} -server -Djava.awt.headless=true -Dorg.geotools.shapefile.datetime=false -XX:+UseParallelGC -XX:ParallelGCThreads=4 -Dfile.encoding=UTF8 -Duser.timezone=UTC -Djavax.servlet.request.encoding=UTF-8 -Djavax.servlet.response.encoding=UTF-8 -DGEOSERVER_CSRF_DISABLED=true -DPRINT_BASE_URL=http://localhost:8080/geoserver/pdf -Dgwc.context.suffix=gwc"
JAVA_OPTS="$JAVA_OPTS -Dgeostore-ovr=file:///home/tomcat/apache-tomcat-9.0.76/conf/geostore-datasource.properties"