Skip to content

Latest commit

 

History

History
89 lines (57 loc) · 3.88 KB

running-e-parliament-at4am-production.md

File metadata and controls

89 lines (57 loc) · 3.88 KB

AT4AM.eu Running the e-parliament AT4AM (NSESA) project on production systems

Steps for fetching/compiling/installing/configuring/running/testing the e-parliament project of AT4AM on production systems. You don't need to do this to develop or run AT4AM on your own computer!

Preparations

Assumptions

  • You are familiar with running the e-parliament AT4AM (NSESA) project, as this is a follow-up.
  • You are experienced enough to see where this tutorial fails horribly, and are willing to contribute your improvements.
  • The path <at4am/e-parliament> is where you previously put the source code.

Steps

Environment

# This path to Tomcat might differ on your system.
# For me it expands to `/usr/local/opt/tomcat7`.
AT4AM_TOMCAT=$(brew --prefix tomcat7)

# Change directory to where you previously put the source code.
cd "<at4am/e-parliament>"

Logging

The default location for logs is $PWD/../logs/, which is relative to where Tomcat was started from. When running Tomcat as a service, that won't do.

NSESA uses log4j through slf4j. We can configure more advanced logging by providing our own production-log4j.xml.

<at4am/e-parliament>/production-log4j.xml

Example configuration. You might want to use SyslogAppender (example) or even SMTPAppender (example).

TODO: Use org.apache.log4j.rolling.RollingFileAppender from log4j-extras when NSESA has upgraded to log4j-1.2.17.jar. Check for another (git) branch of this file for details.

# Edit location!
sudo mkdir /var/log/nsesa/

# Edit username/group to match your service user!
# Edit location!
sudo chown <tomcat-service-user> /var/log/nsesa/
sudo chgrp <tomcat-service-group> /var/log/nsesa/
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration>
    <appender name="nsesa-rollingfile" class="org.apache.log4j.RollingFileAppender">
        <!-- Edit location! -->
        <param name="file" value="/var/log/nsesa/nsesa.log" />
        <param name="MaxFileSize" value="10MB"/>
		<param name="MaxBackupIndex" value="10" />
        <param name="encoding" value="UTF-8" />

        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d{ISO8601} %p [%t] %c{2}: %m%n"/>
        </layout>
    </appender>

    <root>
        <priority value="INFO" />
        <appender-ref ref="nsesa-rollingfile" />
    </root>
</log4j:configuration>

Edit your setenv.sh and add -Dlog4j.configuration=file://<at4am/e-parliament>/production-log4j.xml to CATALINA_OPTS. Optionally add -Dlog4j.debug to verify that the right log4j settings have been loaded.

"$EDITOR" "$AT4AM_TOMCAT"/libexec/bin/setenv.sh

Remember to restart Tomcat.

AT4AM.eu AT4AM.eu © 2013, 2014, 2015 Föreningen för digitala fri- och rättigheter (DFRI). The documentation is released under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. Related resources and projects may have other licences.