Agilefant installation On Linux

System requirements:

Browser
Agilefant is developed and tested using Firefox, Chrome, Opera and Safari also work well. Microsoft Internet Explorer has many serious problems with Agilefant.

Java
Need 7 (1.7) or later.

J2EE-server
Tomcat 7 or later recommended.

Database server
MySQL 5 (with InnoDB engine) is required. Agilefant is developed and tested on MySQL 5.5.

Operating systems
Linux x86-64 bit.

Download Required Softwares:

Java - jdk-8u161-linux-x64.tar.gz
Tomcat - apache-tomcat-8.0.48.tar.gz
Mysql - mysql  Ver 15.1 Distrib 10.4.6-MariaDB, for Linux (x86_64) using readline 5.1
Agilefant - https://sourceforge.net/projects/agilefant/files/latest/download (Latest Version)

Install Java and Tomcat:

[apache@oracle Apache]$ gtar -xzf jdk-8u161-linux-x64.tar.gz

Edit .bash_profile and add below lines

export JAVA_HOME=/u01/Apache/jdk1.8.0_161
export JRE_HOME=/u01/Apache/jdk1.8.0_161/jre
export PATH=$PATH:/u01/Apache/jdk1.8.0_161/bin:/u01/Apache/jdk1.8.0_161/jre/bin

Untar Tomcat

[apache@oracle Apache]$ gtar -xzf apache-tomcat-8.0.48.tar.gz

Start tomcat and verify services


Create the database for the Agilefant instance in MySQL

[root@oracle ~]# mysql -u root -p
Enter password:
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 2418
Server version: 10.4.6-MariaDB MariaDB Server

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [(none)]> show databases;
+--------------------+
| Database           |
+--------------------+
| bugs               |
| information_schema |
| mysql              |
| performance_schema |
+--------------------+
4 rows in set (0.000 sec)

MariaDB [(none)]> create database agilefant;
Query OK, 1 row affected (0.000 sec)

MariaDB [(none)]> show databases;
+--------------------+
| Database           |
+--------------------+
| agilefant          |
| bugs               |
| information_schema |
| mysql              |
| performance_schema |
+--------------------+
5 rows in set (0.000 sec)

MariaDB [(none)]> grant all on agilefant.* to agilefant@localhost identified by '<password>';
Query OK, 0 rows affected (0.210 sec)

MariaDB [(none)]> exit;
Bye

Deploy Agilefant in Tomcat:

Deploy agilefant.war by either copying it to [Tomcat path]/webapps/ or use Tomcat Manager

Copy agilefant.war to webapps and restart tomcat services
./shutdown.sh
./startup.sh

Will get error in catalina.out file
SEVERE [main] org.apache.catalina.core.StandardService.initInternal Failed to initialize connector [Connector[HTTP/1.1-8080]]
 org.apache.catalina.LifecycleException: Failed to initialize component [Connector[HTTP/1.1-8080]]

Edit [Tomcat path]/webapps/agilefant/WEB-INF/agilefant.conf

change password to the password created previously

password = "agilefant" to password = "<created password>"

Test that the Agilefant works at address localhost:8080/agilefant

Default username is 'admin' and password is 'secret'.