Installing OpenATNA

Step 1. Setting up mysql users and db

Create a user with username 'openatna' and host 'localhost' identified by pass 'openatna'*

mysql -u root -p
create user 'openatna'@'localhost' identified by 'openatna';

Create new db with name 'openatna'*

create database openatna default character set = utf8;

Granting all priviledges to user 'openatna' on 'openatna' db* 

grant all on openatna.* to 'openatna'@'localhost' identified by 'openatna';

Important - After deploying OpenATNA, please check if your 'messages' table has a field 'messageContent' with type 'blob' and allows 'NULL'. If not, you have to run this script in order to have the messages displayer in OpenATNA Viewer:

alter messages change messageContent messageContent blob null;

Step 2. Building openatna component

Checking out the openatna component source using git URI: https://code.google.com/p/epsos-common-components.openatna/

Building openatna using maven

cd /path/to/openatna/folder
mvn clean install (-P all|service|web)

The compiled WAR archive (in folder openatna/web/target/epsos-openatna-all.war) contains OpenATNA service and Log Viewer. It is also possible to compile a war which has only the other component. The profiles that can be used are: all (default), service and web. The compiled war with all-profile has both OpenATNA service and OpenATNA Log Viewer; if compiled with profile service, the war contains only the OpenATNA Service; if compiled with profile web, the war contains only the Log Viewer.

Step 3. Configuration

Modifying actors properties within file /opt/openncp/openatna/openatna.properties

# IHE actor configuration directory
ihe.actors.dir=/opt/openncp/openatna/conf
ihe.actors.file=IheActors.xml

Modifying mysql properties within file /opt/openncp/openatna/openatna.properties
{code}
# mySQL 5
hib.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
db.driver.class=com.mysql.jdbc.Driver
db.url=jdbc:mysql://localhost/openatna?createDatabaseIfNotExist=true&useUnicode=true&characterEncoding=utf-8
db.username=openatna
db.password=openatna
hib.hbm2ddl.auto=update

OpenATNA uses property with name scheduled.time.between.failed.logs.handling.minutes in ConfigurationManager database to define the interval in which OpenATNA checks if some audit log was not persisted. In case these logs are found, they will be attempted to re-persist. The default value is 60 (minutes).

Step 4. Installing the certificates into OpenATNA server

Firstly modify the file /opt/openncp/openatna/conf/ArrConnections.xml

<HostName>IP_ADDRESS</HostName>
<Port>2862</Port>
<!-- Trust and Keystore -->
<KeyStore>/opt/openncp/certs/service-provider-keystore.jks</KeyStore>
<KeyPass>password</KeyPass>
<TrustStore>/opt/openncp/certs/service-consumer-keystore.jks</TrustStore>
<TrustPass>password</TrustPass>

Step 5. Deploying OpenATNA

Deploy the compiled WAR archive on Tomcat server and OpenATNA AuditService and logViewer should be running.