Migrating from previous Tomcat packages
---------------------------------------

  * Refer to the upstream migration guides for application compatibility
    and configuration changes:
    - http://tomcat.apache.org/migration-7.html
    - http://tomcat.apache.org/migration-8.html
    - http://tomcat.apache.org/migration-85.html
    - http://tomcat.apache.org/migration-9.html
    - http://tomcat.apache.org/migration-10.html
    - http://tomcat.apache.org/migration-11.0.html

  * Before the version 9 the Debian packages for Tomcat each created their
    own tomcat<n> users. You may need to recursively update your application
    directories to be owned by the tomcat user. This user will no longer
    change for the future upgrades.


Getting started
---------------

  * After installing the tomcat11 package, the server should be accessible
    at http://localhost:8080/

  * The default port 8080 can be changed by modifying the port of the
    connector in /etc/tomcat11/server.xml. Privileged ports (such as 80 or 443)
    can be used with no extra configuration.

  * If you install tomcat11-admin, you have to define an admin account to
    access the manager interface. Edit /etc/tomcat11/tomcat-users.xml and
    follow the instructions in the comments. The Tomcat manager will be
    accessible at http://localhost:8080/manager/html

  * Tomcat is sandboxed by systemd and only has write access to the following
    directories:
    - /var/lib/tomcat11/conf/Catalina (actually /etc/tomcat11/Catalina)
    - /var/lib/tomcat11/logs          (actually /var/log/tomcat11)
    - /var/lib/tomcat11/webapps
    - /var/lib/tomcat11/work          (actually /var/cache/tomcat11)

    If write access to other directories is required the service settings
    have to be overridden. This is done by creating an override.conf file
    in /etc/systemd/system/tomcat11.service.d/ containing:

      [Service]
      ReadWritePaths=/path/to/the/directory/

    The service has to be restarted afterward with:

      systemctl daemon-reload
      systemctl restart tomcat11

  * To run more than one Tomcat instance on your server, install the package
    tomcat11-user and run the tomcat11-instance-create utility.
    You should remove the tomcat11 package if you don't want Tomcat to
    start as a daemon at boot time.
