-
Notifications
You must be signed in to change notification settings - Fork 128
Agilefant installation guide
If you're trying out Agilefant for the first time, we strongly recommend you get an account from the Cloud. It takes about five seconds, and is completely free for a single user. The Cloud version comes with a 30-day free trial during of which you can evaluate it with no limits.
After you've seen Agilefant in action it's easier to decide whether you still want to go for the open source version, continue using your premium Cloud account, or get Agilefant Ground. See our pricing page for details.
Check out the system and browser requirements!
Below are the instructions on how to install Agilefant. If you need more details you can check out the Ubuntu installation guide.
Phases 1-3 are mandatory. Phase 4 is optional for users who want to use Apache as part of their installation.
In the instructions the following references are used:
[Tomcat path]
The path to Tomcat. For example, /var/lib/tomcat7 on Ubuntu or C:\Program Files\Apache Software Foundation\Tomcat 7.0\ on Windows
[strong unique password]
The password for your Agilefant database. Create one yourself, or on Ubuntu you can create one by running: pwgen -s 32
[mysql username] and [mysql password]
The username and password used to access your mysql database. These are created during the installation of mysql
[Apache settings path]
Used only in the optional Apache phase. The path to Apache's settings. For example: /etc/apache2 on Ubuntu or C:\Program Files\Apache Software Foundation\Apache2.2\conf on Windows
- Install Java runtime environment (JRE, Oracle Java 7 recommended) and set environment variables
- Install Tomcat (Must be at least version 7)
- Install MySQL
- Download Agilefant release .zip from https://sourceforge.net/projects/agilefant/files/latest/download
- Unpack agilefant.war from the .zip file
- Generate & record a [strong unique password] to use for the organization's database
- Run the following commands in console:
- mysql -u [mysql username] -p
- input [mysql password] when asked
- create database agilefant;
- grant all on agilefant.* to agilefant@localhost identified by '[strong unique password]';
- exit;
-
Edit /WEB-INF/agilefant.conf in the agilefant.war package
- change password to the password created previously:
- password = "[strong unique password]"
- change password to the password created previously:
-
Deploy agilefant.war by either copying it to [Tomcat path]/webapps/ or use Tomcat Manager
-
You can test that the Agilefant has been set up correctly by clicking on it from Tomcat Manager app list.
-
Test that the Agilefant works at address localhost:8080/agilefant by logging in.
N.B.! The username is admin and the password is secret.
-
Default Tomcat Connector port should be 8080 on Ubuntu. You can see it from [Tomcat path]/conf/server.xml)
-
If yes, you're set!
4. Optional phase: Configure Apache to allow access to the new Agilefant instance from outside localhost and restart
- Install Apache
- Open [Apache path]/httpd.conf in a text editor, and add the text below to the end of the file:
------ clip clip ------
<Location /agilefant>
ProxyPass http://localhost:8080/agilefant
ProxyPassReverse http://localhost:8080/agilefant
Order Allow,Deny
Allow from all
</Location>
------ clip clip ------
- Restart Apache (service apache2 reload should be enough on Ubuntu)
- Test that the 'Fant works at address localhost/agilefant by logging in with admin:secret
This installation guide is for Agilefant 3.1.1+ (which will not work on Tomcat 6).
This guide is an extension to Jarno's original installation guide. It that adds some additional steps required to get Agilefant running properly with Tomcat 7 on Ubuntu 12.04 LTS.
Here's my recommended list of environment changes
Why: Getting chart drawing to function with OpenJDK is near impossible. The easiest solution is to use Oracle's JDK instead.
Solution: we'll install the Oracle JDK for Ubuntu from the webupd8 PPA
Steps:
- Install add-apt-repository
- Execute sudo apt-get install python-software-properties
- Add the webup8 PPA package list
- Execute sudo add-apt-repository ppa:webupd8team/java
- Execute sudo apt-get update
- Install the Oracle Java 7 JDK
- Execute sudo apt-get install oracle-java7-installer
- Check that the default java version is 1.7
- Execute java -version
- If the default JDK library is not Oracle Java 7, then update the machine to default to Oracle's Java JDK (correct path to JDK can be found by executing sudo update-java-alternatives -l)
- Execute sudo update-java-alternatives -s /usr/lib/jvm/java-7-oracle
- Force Tomcat 7 to use the Oracle JDK (The Tomcat 7 prefers OpenJDK over Oracle JDK even if the Oracle JDK is the default java environment)
- Edit /etc/default/tomcat7
- Add the following line: JAVA_HOME=
- The default path should be /usr/lib/jvm/java-7-oracle
Why: Agilefant's chart rendering requires fonts. Unfortunately, the Ubuntu installation may not necessarily have installed any fonts.
Solution: install some fonts
Steps:
- Install the common dejavu fonts -- sudo apt-get install ttf-dejavu
- Install the Microsoft TrueType core fonts -- sudo apt-get install ttf-mscorefonts-installer
Why: Tomcat 7 and Agilefant is fairly resource heavy. We'll need all the space we can get.
Solution: we'll apply the following JVM options to address these problems:
(a) Enable chart rendering functions on GUI-less Ubuntu installation: -Djava.awt.headless=true
(b) Increase Tomcat's heap space -Xms256m -Xmx1024m
(c) Increase Tomcat's Perm Space so that the charts rendering have enough memory -XX:PermSize=256m -XX:MaxPermSize=512m
Steps:
- Edit /etc/default/tomcat7
- Add/modify the JAVA_OPTS setting and apply the following options:
- -Djava.awt.headless=true -Xms256m -Xmx1024m -XX:PermSize=256m
- -XX:MaxPermSize=512m
- Restart Tomcat.
If the changes are successful, Tomcat's server status should report that:
- Tomcat's JVM version number should match the java binary version number
- Tomcat's total memory is approximately 256 MB and its maximum memory is approximately 1 GB.