Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
tutorial:adm:server_preparation [2019/06/04 11:57] urbanl [Start Tomcat automatically after system startup - Debian] Selinux change on Centos |
tutorial:adm:server_preparation [2020/07/28 09:08] urbanl |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Server preparation - Linux ====== | + | ====== Server preparation - Linux - CentOS8 |
{{tag> | {{tag> | ||
- | This tutorial shows how to prepare the server for test or production | + | This tutorial shows how to prepare the server for test or production |
===== Basic system setup ===== | ===== Basic system setup ===== | ||
- | * 1 server (can be virtualized) for all: backend, frontend and database. | + | * 1 server (can be virtualized) for everything: backend, frontend and database. |
- | * OS Linux with EPEL repository enabled - CENTOS, basic network enabled installation | + | * OS Linux with EPEL repository enabled - CentOS, basic network enabled installation |
- | * It is possible to use Debian but you have to adjust | + | * It is possible to use Debian |
- | * PostgreSQL - installed from a new repository | + | * PostgreSQL |
- | * Java - distribution repository (OpenJDK 1.8) | + | * Java 11 - installed from OS packages. |
- | * Apache Tomcat - manually | + | * Apache Tomcat |
- | * Services | + | * Apache HTTPd 2.4.x - installed from OS packages. Can be replaced by nGinx. |
- | * Services run under dedicated | + | * All services |
+ | * Each service runs under dedicated non-privileged | ||
===== Instalation and software configuration ===== | ===== Instalation and software configuration ===== | ||
- | Prerequisities - Basic installation of CentOS | + | Prerequisities - Basic installation of CentOS |
<code bash> | <code bash> | ||
# EPEL installation | # EPEL installation | ||
- | yum clean all | + | dnf clean all |
- | yum install | + | dnf -y install |
- | yum update -y | + | dnf update -y |
# other recommended packages installation | # other recommended packages installation | ||
- | yum install | + | dnf -y install mc haveged nmap screen sysstat telnet |
# enable haveged after OS start | # enable haveged after OS start | ||
systemctl start haveged.service | systemctl start haveged.service | ||
systemctl enable haveged.service | systemctl enable haveged.service | ||
- | # remove unnecessary software | + | |
- | yum remove -y postfix | + | |
- | systemctl stop avahi-daemon.socket avahi-daemon.service | + | |
- | systemctl disable avahi-daemon.socket avahi-daemon.service | + | |
- | yum remove -y avahi-autoipd avahi | + | |
# set the hostname | # set the hostname | ||
hostnamectl set-hostname FQDN_server_name | hostnamectl set-hostname FQDN_server_name | ||
Line 39: | Line 37: | ||
</ | </ | ||
- | When installing on Debian, install these packages: | + | ===== PostgreSQL |
- | < | + | <note tip>If you are installing |
- | screen dnsutils sysstat lsof haveged nmap tcpdump traceroute tcptraceroute curl iptables-persistent | + | We install |
- | </ | + | ==== Database server installation - CentOS8 |
- | ===== PostgreSQL ===== | + | * Software installation |
- | <note tip>If you are install | + | |
- | CentOS7 default repository version of PostgreSQL | + | |
- | ==== Database server installation - CentOS7 | + | |
- | * Software installation (versions can vary): | + | |
<code bash> | <code bash> | ||
- | yum install -y https:// | + | # enable module postgres 12 |
- | yum install | + | dnf module enable postgresql:12 |
+ | dnf -y install postgresql-server | ||
</ | </ | ||
- | | + | |
- | < | + | |
- | mkdir -p / | + | |
+ | < | ||
+ | mkdir -p / | ||
chown -R postgres: | chown -R postgres: | ||
chmod 700 /data/pgsql | chmod 700 /data/pgsql | ||
</ | </ | ||
- | | + | |
+ | | ||
<code bash> | <code bash> | ||
- | cp / | + | cp / |
</ | </ | ||
- | In the file ''/ | + | |
+ | In the file ''/ | ||
< | < | ||
# Location of database directory | # Location of database directory | ||
- | Environment=PGDATA=/ | + | Environment=PGDATA=/ |
</ | </ | ||
- | * In the file '' | + | * In the file '' |
< | < | ||
- | PGDATA=/ | + | PGDATA=/ |
</ | </ | ||
Line 85: | Line 86: | ||
<code bash> | <code bash> | ||
- | / | + | postgresql-setup |
</ | </ | ||
+ | Change SELINUX labels: | ||
+ | < | ||
+ | chcon -Rt postgresql_db_t / | ||
+ | chcon -Rt postgresql_log_t / | ||
+ | </ | ||
* Enable and start database: | * Enable and start database: | ||
<code bash> | <code bash> | ||
- | systemctl start postgresql-9.6.service | + | systemctl start postgresql.service |
- | systemctl enable postgresql-9.6.service | + | systemctl enable postgresql.service |
</ | </ | ||
Line 100: | Line 105: | ||
<code bash> | <code bash> | ||
- | [root@tomcat1 system]# systemctl status postgresql-9.6.service -l | + | [root@HOSTNAME data]# systemctl status postgresql.service -l |
- | ● postgresql-9.6.service - PostgreSQL | + | ● postgresql.service - PostgreSQL database server |
- | | + | |
- | | + | |
- | Main PID: 2626 (postmaster) | + | Main PID: 25715 (postmaster) |
- | | + | Tasks: 8 (limit: 52428) |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | └─2634 postgres: stats collector | + | |
+ | | ||
+ | ├─25722 postgres: stats collector | ||
+ | | ||
- | lis 18 23:50:06 tomcat1.localdomain | + | Mar 11 10:48:06 HOSTNAME |
- | lis 18 23:50:06 tomcat1.localdomain | + | Mar 11 10:48:06 HOSTNAME postmaster[25715]: |
- | lis 18 23:50:06 tomcat1.localdomain | + | Mar 11 10:48:06 HOSTNAME |
- | lis 18 23:50:06 tomcat1.localdomain | + | Mar 11 10:48:06 HOSTNAME postmaster[25715]: |
+ | Mar 11 10:48:06 HOSTNAME postmaster[25715]: | ||
+ | Mar 11 10:48:06 HOSTNAME postmaster[25715]: | ||
+ | Mar 11 10:48:06 HOSTNAME postmaster[25715]: | ||
+ | Mar 11 10:48:06 HOSTNAME | ||
+ | Mar 11 10:48:06 HOSTNAME | ||
</ | </ | ||
- | ==== Database server installation - Debian Stretch ==== | ||
- | Install the database from OS packages: | ||
- | < | ||
- | apt-get install postgresql-9.6 | ||
- | </ | ||
- | We will move the database - create directory structure: | ||
- | < | ||
- | mkdir -p / | ||
- | chown -R postgres: | ||
- | chmod -R 700 /data/pgsql | ||
- | </ | ||
- | Create the file .bash\_profile in postgres user's home (default / | ||
- | < | ||
- | PGDATA=/ | ||
- | </ | ||
- | Stop the database: | ||
- | < | ||
- | systemctl stop postgresql | ||
- | </ | ||
- | Move database directory (run this as root): | ||
- | < | ||
- | mv / | ||
- | </ | ||
- | In the PostgreSQL configuration file / | ||
- | < | ||
- | data_directory = '/ | ||
- | </ | ||
- | Enable and start the database: | ||
- | < | ||
- | systemctl start postgresql | ||
- | systemctl enable postgresql | ||
- | </ | ||
- | ==== DB server configuration ==== | ||
- | First of all, enable | + | ==== Database server configuration and sizing ==== |
+ | |||
+ | * Enable | ||
- | In the file ''/ | + | In the file ''/ |
< | < | ||
host all | host all | ||
host all | host all | ||
</ | </ | ||
- | + | and change the value at the end of each line to '' | |
- | and change the value at the end of each line into md5 like this: | + | |
< | < | ||
host all | host all | ||
Line 168: | Line 149: | ||
</ | </ | ||
- | Now we can do DB sizing. | + | * Adjust |
- | In a file ''/ | + | * In following snippet, we presume the system has 3GB of memory |
+ | * We also log queries running longer than 200ms. | ||
+ | In a file ''/ | ||
< | < | ||
- | max_connections = 100 # (change requires restart) | + | # This is an EXAMPLE. Use the calculator to adjust for your deployment! |
- | shared_buffers = 768MB # min 128kB | + | # DB Version: 12 |
+ | # OS Type: linux | ||
+ | # DB Type: web | ||
+ | # Total Memory (RAM): 3 GB | ||
+ | # Connections num: 100 | ||
+ | # Data Storage: ssd | ||
+ | max_connections = 100 | ||
+ | shared_buffers = 768MB | ||
effective_cache_size = 2304MB | effective_cache_size = 2304MB | ||
- | work_mem = 7864kB | ||
maintenance_work_mem = 192MB | maintenance_work_mem = 192MB | ||
- | |||
- | min_wal_size = 1GB | ||
- | max_wal_size = 2GB | ||
checkpoint_completion_target = 0.7 | checkpoint_completion_target = 0.7 | ||
wal_buffers = 16MB | wal_buffers = 16MB | ||
- | |||
default_statistics_target = 100 | default_statistics_target = 100 | ||
+ | random_page_cost = 1.1 | ||
+ | effective_io_concurrency = 200 | ||
+ | work_mem = 3932kB | ||
+ | min_wal_size = 1GB | ||
+ | max_wal_size = 4GB | ||
log_min_duration_statement = 200 | log_min_duration_statement = 200 | ||
</ | </ | ||
- | Restart | + | * Restart |
- | For Debian installation, | ||
< | < | ||
- | /etc/postgresql/9.6/ | + | systemctl restart |
- | /etc/ | + | </code> |
+ | |||
+ | < | ||
+ | |||
+ | ===== Java - CentOS8 ===== | ||
+ | |||
+ | Tomcat application server needs Java installed. We recommend to use OpenJDK 11 from standard OS repository. (OpenJDK 1.8 is also supported, check [[devel: | ||
+ | |||
+ | Installation: | ||
+ | < | ||
+ | dnf install -y java-11-openjdk-headless java-11-openjdk-devel | ||
</ | </ | ||
- | < | ||
===== Tomcat ===== | ===== Tomcat ===== | ||
- | Installation | + | * Create a new group and add user for the tomcat to run under: |
+ | |||
+ | < | ||
+ | groupadd | ||
+ | useradd -r -s / | ||
+ | getent passwd tomcat | ||
+ | # | ||
+ | </ | ||
+ | |||
+ | * change working directory into / | ||
<code bash> | <code bash> | ||
- | yum install -y tomcat | + | mkdir / |
+ | cd /opt/tomcat | ||
</ | </ | ||
- | Installation | + | * Download Apache Tomcat 8.5.x from the website [[https:// |
+ | * In our exapmle the version is 8.5.57. | ||
+ | |||
+ | * extract files from the archive: | ||
<code bash> | <code bash> | ||
- | apt install | + | tar xzf apache-tomcat-8.5.57.tar.gz |
</ | </ | ||
+ | * create a new symbolic link to current user version (we presume there may be more versions at the server in future due to upgrades/ | ||
- | ==== Start Tomcat automatically after system startup | + | <code bash> |
- | + | cd / | |
+ | ln -s apache-tomcat-8.5.57 current | ||
+ | </ | ||
- | * Make some adjustments to systemd unit. | + | * Set rights on files for tomcat user (still working under root): |
<code bash> | <code bash> | ||
- | systemctl edit tomcat.service | + | chown -R root:root /opt/tomcat |
+ | chown root:tomcat / | ||
+ | chmod 750 / | ||
+ | cd / | ||
+ | chmod -R o+rX ./ | ||
+ | chgrp -R tomcat conf/ bin/ lib/ | ||
+ | chmod g+rx conf | ||
+ | chmod g+r conf/* | ||
+ | chown -R tomcat webapps/ work/ temp/ logs/ | ||
+ | |||
+ | mkdir / | ||
+ | chown tomcat: | ||
+ | chmod 750 / | ||
</ | </ | ||
- | Or if you want use diferent editor than nano( vim) use this comands: | + | |
+ | |||
+ | ==== Start Tomcat automatically after system startup ==== | ||
+ | |||
+ | * Create startup script | ||
<code bash> | <code bash> | ||
- | export SYSTEMD_EDITOR=" | + | vim /etc/ |
- | sudo -E systemctl edit tomcat.service | + | |
</ | </ | ||
- | * Add these lines and save the file: | ||
- | <code> | + | * File content of ''/ |
+ | |||
+ | <file ini tomcat.service> | ||
+ | # Systemd unit file for tomcat | ||
+ | [Unit] | ||
+ | Description=Apache Tomcat Web Application Container | ||
+ | After=syslog.target network.target postgresql.service | ||
[Service] | [Service] | ||
- | SyslogFacility=local3 | + | Type=forking |
+ | |||
+ | PIDFile=/ | ||
+ | |||
+ | Environment=JAVA_HOME=/ | ||
+ | Environment=CATALINA_PID=/ | ||
+ | Environment=CATALINA_HOME=/ | ||
+ | Environment=CATALINA_BASE=/ | ||
Environment=' | Environment=' | ||
Environment=' | Environment=' | ||
- | </ | ||
- | | + | ExecStart=/ |
- | * Tomcat will be started under user tomcat: | + | ExecStop=/ |
- | * After every systemd configuration | + | |
+ | User=tomcat | ||
+ | Group=tomcat | ||
+ | |||
+ | [Install] | ||
+ | WantedBy=multi-user.target | ||
+ | </ | ||
+ | < | ||
+ | | ||
+ | * Tomcat will be started under user '' | ||
+ | </ | ||
+ | |||
+ | * Reload | ||
< | < | ||
systemctl daemon-reload | systemctl daemon-reload | ||
</ | </ | ||
- | | + | |
+ | | ||
< | < | ||
systemctl start tomcat | systemctl start tomcat | ||
+ | systemctl enable tomcat | ||
</ | </ | ||
+ | |||
* Check that Tomcat runs with desirable parameters: | * Check that Tomcat runs with desirable parameters: | ||
+ | |||
<code bash> | <code bash> | ||
- | [root@tomcat1 logs]# ps -u tomcat | + | [root@tomcat1 logs]# ps -ef | grep ^tomcat |
- | UID PID PPID C STIME TTY TIME CMD | + | tomcat |
- | tomcat | + | |
</ | </ | ||
- | | + | |
+ | | ||
< | < | ||
systemctl stop tomcat | systemctl stop tomcat | ||
</ | </ | ||
- | * Enable tomcat start after OS start: | ||
- | <code bash> | ||
- | systemctl enable tomcat | ||
- | </ | ||
- | ==== Start Tomcat automatically after system startup - Debian ==== | ||
- | * In file ''/ | + | ==== Apache Tomcat configuration ==== |
- | <file ini tomcat8> | + | === Interface Management === |
- | CATALINA_OPTS=" | + | Apache Tomcat offers two applications for tomcat management available at: |
- | JAVA_OPTS=" | + | |
+ | * http:// | ||
+ | * http:// | ||
+ | |||
+ | If you want to use them, it is necessary to do following steps. | ||
+ | |||
+ | First of all, create a Tomcat' | ||
+ | |||
+ | * Create administration user | ||
+ | * Create the a new user in the file ''/ | ||
+ | * The documentation of available roles as well as overall configuration of the application is a part of application installation available at http:// | ||
+ | |||
+ | The file ''/ | ||
+ | <file xml tomcat-users.xml> | ||
+ | <?xml version=" | ||
+ | < | ||
+ | xmlns: | ||
+ | xsi: | ||
+ | version=" | ||
+ | <role rolename=" | ||
+ | <role rolename=" | ||
+ | <role rolename=" | ||
+ | <role rolename=" | ||
+ | <role rolename=" | ||
+ | <user username=" | ||
+ | </ | ||
</ | </ | ||
- | * Values of Xms a Xmx se are closely dependent on server sizing. | + | * If you plan to connect to the applications remotely (not only from localhost) |
- | * Tomcat will be started under user '' | + | * If you see '' |
- | * Test start: | + | |
- | < | + | Add your IP address into application configuration files. In files ''/ |
- | systemctl start tomcat8 | + | For example, if you want to access Tomcat' |
- | </code> | + | <file xml context.xml> |
- | * Check that Tomcat runs with desirable parameters: | + | <?xml version=" |
+ | <Context antiResourceLocking=" | ||
+ | <Valve className=" | ||
+ | | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | * Again, restart the tomcat | ||
<code bash> | <code bash> | ||
- | [root@tomcat1 logs]# ps -u tomcat8 -fwww | + | systemctl |
- | UID PID PPID C STIME TTY TIME CMD | + | |
- | tomcat8 | + | |
- | </ | + | |
- | * Stop Apache Tomcat: | + | |
- | < | + | |
- | systemctl | + | |
- | </ | + | |
- | * Enable | + | |
- | <code bash> | + | |
- | systemctl enable tomcat8 | + | |
</ | </ | ||
- | === On CentOS turn off Selinux | + | === |
- | On CentOS in Selinux you need to allow tomcat | + | |
+ | We advise | ||
+ | |||
+ | * Remove unnecessary applications that come with Tomcat: | ||
<code bash> | <code bash> | ||
- | setsebool | + | rm -rf / |
</ | </ | ||
- | Then check it. | ||
- | <code bash> | ||
- | getsebool -a |grep tomcat | ||
- | </ | ||
- | If it's set right you will se this line with " | ||
- | < | ||
- | tomcat_can_network_connect_db --> on | ||
- | </ | ||
- | ==== Apache Tomcat configuration recommended for production usage ==== | ||
- | It is advised to follow these steps for production usage: | ||
- | |||
- | - In file ''/ | ||
* Turn off the shutdown port: | * Turn off the shutdown port: | ||
- | * Set value -1 from 8005 to the Server port tag, thus you deactivate it: | + | |
<code xml> | <code xml> | ||
Line 318: | Line 388: | ||
</ | </ | ||
- | - In same file do this: | ||
* Make Tomcat listen only on localhost: | * Make Tomcat listen only on localhost: | ||
- | * Add the '' | + | |
- | * In Debian you need to uncoment AJP conector on port '' | + | |
- | * Change logging into '' | + | |
- | * Find these lines and comment them. | + | |
- | <code xml> | + | * Set the '' |
- | <!-- | + | * In the ''/ |
- | <Valve className=" | + | |
- | | + | * In same file configure AJP port ('' |
- | pattern=" | + | |
- | --> | + | < |
- | </code> | + | <Connector protocol="AJP/1.3" |
- | And add these lines: | + | address=" |
- | < | + | secretRequired="true" |
- | <Valve className="org.apache.catalina.valves.AccessLogValve" | + | |
- | prefix=" | + | port="8009" |
- | pattern="%h %l %u %t & | + | |
- | rotatable="false" /> | + | |
</ | </ | ||
- | - In the file ''/ | ||
* Do not show aplication server version: | * Do not show aplication server version: | ||
- | * Set showServerInfo to false (default is true): | + | * In the file ''/ |
<code xml> | <code xml> | ||
Line 362: | Line 426: | ||
< | < | ||
</ | </ | ||
- | </ | ||
- | We need to tell Tomcat where idm.war will be. Create context file ''/ | ||
- | <code xml> | ||
- | <Context | ||
- | docBase="/ | ||
- | path="" | ||
- | /> | ||
- | </ | ||
- | ==== Tomcat loging configuration ==== | ||
- | - in file ''/ | ||
- | * Change logging properties | ||
- | * Add/change lines( 1catalina, 2localhost, 3manager, 4host-manager) into this(leave the other lines as they are): | ||
- | |||
- | < | ||
- | 1catalina.org.apache.juli.FileHandler.level = ALL | ||
- | 1catalina.org.apache.juli.FileHandler.prefix = tomcat. | ||
- | 1catalina.org.apache.juli.FileHandler.rotatable = false | ||
- | 1catalina.org.apache.juli.FileHandler.suffix = log | ||
- | |||
- | 2localhost.org.apache.juli.FileHandler.rotatable = false | ||
- | 2localhost.org.apache.juli.FileHandler.suffix = log | ||
- | |||
- | 3manager.org.apache.juli.FileHandler.rotatable = false | ||
- | 3manager.org.apache.juli.FileHandler.suffix = log | ||
- | |||
- | 4host-manager.org.apache.juli.FileHandler.rotatable = false | ||
- | 4host-manager.org.apache.juli.FileHandler.suffix = log | ||
- | </ | ||
- | |||
- | On Debian make these extra changes: | ||
- | < | ||
- | handlers = 1catalina.org.apache.juli.AsyncFileHandler, | ||
- | #, java.util.logging.ConsoleHandler | ||
- | |||
- | .handlers = 1catalina.org.apache.juli.FileHandler | ||
- | #, java.util.logging.ConsoleHandler | ||
- | |||
- | ############################################################ | ||
- | # Handler specific properties. | ||
- | ############################################################ | ||
- | |||
- | 3manager.org.apache.juli.FileHandler.level = FINE | ||
- | 3manager.org.apache.juli.FileHandler.directory = ${catalina.base}/ | ||
- | 3manager.org.apache.juli.FileHandler.prefix = manager. | ||
- | |||
- | 4host-manager.org.apache.juli.FileHandler.level = FINE | ||
- | 4host-manager.org.apache.juli.FileHandler.directory = ${catalina.base}/ | ||
- | 4host-manager.org.apache.juli.FileHandler.prefix = host-manager. | ||
- | |||
- | # | ||
- | # | ||
- | |||
- | ############################################################ | ||
- | # Facility specific properties. | ||
- | ############################################################ | ||
- | |||
- | org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/ | ||
- | org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/ | ||
- | |||
- | org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/ | ||
- | org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/ | ||
- | |||
- | </ | ||
- | |||
- | |||
- | |||
- | On CentOS for redirect logging from / | ||
- | < | ||
- | ### tomcat log | ||
- | $template TomcatForm," | ||
- | if ($syslogfacility-text == ' | ||
- | action(type=" | ||
- | & stop | ||
- | } | ||
- | </ | ||
- | Then restart rsyslog | ||
- | < | ||
- | systemctl restart rsyslog | ||
</ | </ | ||
- | ==== Rotating Tomcat logs ==== | + | === Rotating Tomcat logs === |
- | Tomcat logger appneds to the logfile | + | Default |
<file txt tomcat> | <file txt tomcat> | ||
- | /var/log/tomcat/tomcat.log | + | /opt/tomcat/current/logs/catalina.out { |
- | /var/ | + | rotate |
- | / | + | |
- | / | + | |
- | / | + | |
- | rotate | + | |
daily | daily | ||
dateext | dateext | ||
Line 457: | Line 439: | ||
notifempty | notifempty | ||
compress | compress | ||
- | create 0644 tomcat tomcat | ||
- | } | ||
- | / | ||
- | { | ||
- | rotate COUNT | ||
- | daily | ||
- | dateext | ||
- | copytruncate | ||
- | missingok | ||
- | notifempty | ||
- | compress | ||
- | create 0644 tomcat tomcat | ||
- | sharedscripts | ||
- | postrotate | ||
- | /bin/kill -HUP `cat / | ||
- | | ||
- | } | ||
- | </ | ||
- | On **Debian** logs are in ''/ | ||
- | <file txt tomcat8> | ||
- | / | ||
- | / | ||
- | / | ||
- | / | ||
- | / | ||
- | / | ||
- | rotate COUNT | ||
- | daily | ||
- | dateext | ||
- | copytruncate | ||
- | missingok | ||
- | notifempty | ||
- | compress | ||
- | create 0644 tomcat8 tomcat8 | ||
} | } | ||
</ | </ | ||
Line 508: | Line 456: | ||
* Adjust particular SELinux labels. Example ([[https:// | * Adjust particular SELinux labels. Example ([[https:// | ||
</ | </ | ||
- | Please note that the log does not rotate during the first day, but after the second day. | ||
- | ==== Optional - Management Interface for Tomcat==== | ||
- | If you installed two additional applications for tomcat management follow this part to complete tomcat configuration. | ||
- | These applications are available at: | ||
- | |||
- | * http:// | ||
- | * http:// | ||
- | |||
- | If you want to use them, it is necessary to do following steps. | ||
- | |||
- | First of all, create a database user that you will use for the access to those applications. If you plan to connect to the applications remotely (not only from localhost) you have to also allow communication from your IP. | ||
- | |||
- | Create user like this: | ||
- | |||
- | Create the a new user in the file ''/ | ||
- | The documentation of available roles as well as overall configuration of the application is a part of application installation available at http:// | ||
- | |||
- | The file ''/ | ||
- | <file xml tomcat-users.xml> | ||
- | <?xml version=" | ||
- | < | ||
- | xmlns: | ||
- | xsi: | ||
- | version=" | ||
- | <role rolename=" | ||
- | <role rolename=" | ||
- | <role rolename=" | ||
- | <role rolename=" | ||
- | <role rolename=" | ||
- | <user username=" | ||
- | </ | ||
- | </ | ||
- | |||
- | If you plan to connect to the applications remotely (not only from localhost) you have to also allow communication from your IP. If you see '' | ||
- | |||
- | Add your IP address into application configuration files. In files ''/ | ||
- | |||
- | In my case, I want to access to Tomcat management from network 192.168.0.0/ | ||
- | |||
- | <file xml context.xml> | ||
- | <?xml version=" | ||
- | <Context antiResourceLocking=" | ||
- | <Valve className=" | ||
- | | ||
- | </ | ||
- | </ | ||
- | |||
- | Again, restart the tomcat: | ||
- | <code bash> | ||
- | systemctl restart tomcat | ||
- | </ | ||
====== Apache httpd as a reverse proxy ====== | ====== Apache httpd as a reverse proxy ====== | ||
Line 575: | Line 472: | ||
<code bash> | <code bash> | ||
yum install -y httpd httpd-tools mod_ssl mod_security mod_security_crs | yum install -y httpd httpd-tools mod_ssl mod_security mod_security_crs | ||
- | </ | ||
- | |||
- | On Debian install those packages and allow modules: | ||
- | < | ||
- | apt-get install apache2 libapache2-mod-security2 modsecurity-crs | ||
- | a2enmod ssl | ||
- | a2enmod proxy | ||
- | a2enmod proxy_ajp | ||
- | a2enmod proxy_http | ||
- | a2enmod security2 | ||
- | a2enmod rewrite | ||
- | a2enmod headers | ||
</ | </ | ||
HTTPd basic configuration: | HTTPd basic configuration: | ||
- | Change MPM to worker | + | Change MPM to worker - in the file ''/ |
<code bash> | <code bash> | ||
Line 621: | Line 506: | ||
</ | </ | ||
- | Virtualhost configuration to forward the communication from port 80 to 443. Add following section and change string 'server' to the real servername in the file ''/ | + | Virtualhost configuration to forward the communication from port 80 to 443. Add following section and change string 'SERVER' to the real servername in the file ''/ |
<code xml> | <code xml> | ||
< | < | ||
| | ||
- | | + | |
</ | </ | ||
</ | </ | ||
- | Set the proxy in the virtualhost for https (443/tcp) - at the end of the file ''/ | + | Set the proxy in the virtualhost for https (443/tcp) - at the end of the file ''/ |
< | < | ||
+ | Protocols | ||
ProxyRequests | ProxyRequests | ||
ProxyPreserveHost on | ProxyPreserveHost on | ||
ProxyAddHeaders on | ProxyAddHeaders on | ||
- | ProxyPass / ajp:// | + | ProxyPass / ajp:// |
- | ProxyPassReverse / ajp:// | + | ProxyPassReverse / ajp:// |
</ | </ | ||
Line 650: | Line 536: | ||
To do so, add following lines to the virtualhost config file (ssl.conf): | To do so, add following lines to the virtualhost config file (ssl.conf): | ||
< | < | ||
- | | + | RewriteEngine On |
- | RewriteRule " | + | RewriteRule " |
</ | </ | ||
- | In the file ssl.conf we also have to disable SSLv3. Edit the line with SSLProtocol directive: | + | Syntax check before httpd restart |
- | < | + | |
- | SSLProtocol all -SSLv2 -SSLv3 | + | |
- | </ | + | |
- | + | ||
- | On Debian, create symlinks to sites-enabled: | + | |
- | < | + | |
- | cd / | + | |
- | ln -s ../ | + | |
- | ln -s ../ | + | |
- | </ | + | |
- | + | ||
- | Syntax check before httpd restart: | + | |
< | < | ||
httpd -t -D DUMP_VHOST | httpd -t -D DUMP_VHOST | ||
+ | # or apachectl configtest | ||
</ | </ | ||
Line 676: | Line 551: | ||
</ | </ | ||
+ | Allow in SELINUX to httpd connect to network: | ||
+ | < | ||
+ | / | ||
+ | </ | ||
+ | |||
Enable httpd after OS start: | Enable httpd after OS start: | ||
<code bash> | <code bash> | ||
Line 682: | Line 562: | ||
===== mod_security configuration ===== | ===== mod_security configuration ===== | ||
- | Mod_security files locations (on CentOS7): | + | Mod_security files locations (on CentOS8): |
* Audit log: ''/ | * Audit log: ''/ | ||
* Directory with activated rules: ''/ | * Directory with activated rules: ''/ | ||
- | * basic configuration file for mod\_security: | + | * basic configuration file for mod\_security: |
* The file for chosen rules deactivation: | * The file for chosen rules deactivation: | ||
Line 701: | Line 581: | ||
==== Disabling mod_security rules ==== | ==== Disabling mod_security rules ==== | ||
- | In the file ''/ | + | These rules are disabled for modsec_crs 3.0. |
+ | |||
+ | In the file ''/ | ||
<code xml> | <code xml> | ||
< | < | ||
- | SecRuleRemoveById | + | SecRuleRemoveById |
- | SecRuleRemoveById | + | SecRuleRemoveById |
- | SecRuleRemoveById | + | SecRuleRemoveById |
+ | | ||
+ | | ||
# Allow Czech signs | # Allow Czech signs | ||
- | SecRuleRemoveById | + | SecRuleRemoveById |
- | SecRuleRemoveById | + | SecRuleRemoveById |
- | SecRuleRemoveById | + | SecRuleRemoveById |
- | SecRuleRemoveById | + | SecRuleRemoveById |
| | ||
# Too restrictive for login format | # Too restrictive for login format | ||
- | SecRuleRemoveById | + | SecRuleRemoveById |
+ | |||
# Needed by Websockets | # Needed by Websockets | ||
< | < | ||
- | SecRuleRemoveById | + | SecRuleRemoveById |
</ | </ | ||
| | ||
- | # These break Certificate Authority module | ||
- | < | ||
- | SecRuleRemoveById 960915 | ||
- | SecRuleRemoveById 200003 | ||
- | </ | ||
- | |||
# do not log request/ | # do not log request/ | ||
SecAuditLogParts ABFHZ | SecAuditLogParts ABFHZ | ||
Line 733: | Line 611: | ||
</ | </ | ||
- | ==== mod_security configuration - CentOS7 | + | ==== mod_security configuration - CentOS8 |
- | In the file / | + | Edit the file '' |
- | Whole rule after the changes looks like this: | + | |
- | < | + | * find the rule '' |
- | SecAction \ | + | |
- | "id:'900012', \ | + | |
- | phase:1, \ | + | |
- | t:none, \ | + | |
- | setvar:'tx.allowed_methods=GET HEAD POST OPTIONS | + | |
- | setvar:'tx.allowed_request_content_type=application/ | + | |
- | setvar:'tx.allowed_http_versions=HTTP/ | + | |
- | setvar:'tx.restricted_extensions=.asa/ | + | |
- | setvar:'tx.restricted_headers=/ | + | |
- | nolog, \ | + | |
- | pass" | + | |
- | </ | + | |
- | ==== mod_security configuration - Debian ==== | ||
- | Enable mod\_security configuration: | ||
< | < | ||
- | cd / | + | # Default HTTP policy: allowed_methods (rule 900200) |
- | cp modsecurity.conf-recommended modsecurity.conf | + | SecRule & |
+ | " | ||
+ | phase:1,\ | ||
+ | pass,\ | ||
+ | nolog,\ | ||
+ | setvar:' | ||
</ | </ | ||
- | Uncomment following rules in the '' | + | * find the rule '' |
< | < | ||
- | SecAction \ | + | # Default HTTP policy: allowed_request_content_type (rule 900220) |
- | " | + | SecRule &TX:allowed_request_content_type "@eq 0" \ |
- | phase:1,\ | + | "id:901162,\ |
- | nolog,\ | + | phase:1,\ |
- | pass,\ | + | pass,\ |
- | t:none,\ | + | nolog,\ |
- | setvar:' | + | setvar:' |
- | + | ||
- | SecAction | + | |
- | " | + | |
- | phase:1,\ | + | |
- | | + | |
- | | + | |
- | | + | |
- | setvar:' | + | |
</ | </ | ||
Line 817: | Line 678: | ||
</ | </ | ||
- | ===== Workaround for slow HTTPD shutdown ===== | ||
- | In some RHEL/CentOS versions Apache HTTPD shutsdown or restarts itself very slowly. It is caused by [[https:// | ||
- | Workaround is to edit '''/ | ||
- | < | ||
- | KillMode=none | ||
- | </ | ||
- | Then reload systemd: | ||
- | |||
- | < | ||
- | systemctl daemon-reload | ||
- | </ | ||
- | |||
- | It is absolutely correct to create new versions of unity in /etc, that has the option: | ||
- | |||
- | < | ||
- | cp / | ||
- | vim / | ||
- | systemctl daemon-reload | ||
- | </ | ||
- | |||
- | The patch of httpd should come soon so the first option is OK too. | ||
- | |||
- | ===== SSO ===== | ||
- | |||
- | If you want to enable SSO to CzechIdM, additional configuration must be done with mod\_auth\_kerb. See [[tutorial: | ||
- | |||
- | ====== nginx as reverse proxy ====== | ||
- | |||
- | In case that you want to use nginx instead of Apache httpd, the configuration is as follows. | ||
- | |||
- | <code ini> | ||
- | server { | ||
- | listen | ||
- | server_name | ||
- | client_max_body_size 1G; | ||
- | ssl on; | ||
- | ssl_certificate | ||
- | ssl_certificate_key | ||
- | gzip on; | ||
- | gzip_proxied any; | ||
- | gzip_types | ||
- | text/css | ||
- | | ||
- | text/xml | ||
- | | ||
- | application/ | ||
- | | ||
- | application/ | ||
- | |||
- | location / { | ||
- | proxy_hide_header X-Frame-Options; | ||
- | add_header X-Frame-Options SAMEORIGIN; | ||
- | proxy_pass http:// | ||
- | proxy_set_header Host $host; | ||
- | proxy_set_header X-Real-IP $remote_addr; | ||
- | proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; | ||
- | proxy_set_header X-Forwarded-Proto " | ||
- | proxy_ssl_session_reuse off; | ||
- | proxy_redirect off; | ||
- | |||
- | # WebSocket support | ||
- | proxy_http_version 1.1; | ||
- | proxy_set_header Upgrade $http_upgrade; | ||
- | proxy_set_header Connection " | ||
- | } | ||
- | } | ||
- | </ | ||