XPlanner installation

Posted on 19.04.09

3



XPlanner is a project planning and tracking tool for eXtreme Programming (XP) teams. This guide describes how to install XPlanner on a Windows XP system.

Installation of required software

  1. Download and install JDK 6 Update 13
  2. Copy the file C:\Program Files\Java\jdk1.6.0_13\bin\msvcr71.dll into C:\WINDOWS\system\ (details)
  3. Download and install Apache Tomcat 6.0.18
  4. Download and unzip XPlanner Version 0.7b7
  5. Copy the extracted folder xplanner-0.7b7-war\xplanner\ into C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\

Configuration of XPlanner

Specify the database credentials in the XPlanner database configuration file xplanner-custom.properties which is located inside the C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\xplanner\WEB-INF\classes\ folder.

Adjustment of XPlanner source code

XPlanner does not officially support the versions of Java and Tomcat that we have installed, but only minor adjustments needs to be taken to get up and running.

C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\xplanner\WEB-INF\classes\spring-beans.xml. Replace (details):

<property name="repositories">
    <map>...</map>
</property>

with:

<property name="repositories">
    <bean class="java.util.HashMap">
        <constructor-arg>
            <map>...</map>
        </constructor-arg>
    </bean>
</property>

C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\xplanner\WEB-INF\jsp\common\WEB-INF\jsp\common\footer.jsp line 43. From:

<bean:message key="footer.message" 
        arg0="<%=productionSupportEmail%>" 
        arg1="<%=issueLink%>" 
        arg2="<%=appUrl+"/do/systemInfo"%>"/>

to:

<bean:message key="footer.message" 
        arg0="<%=productionSupportEmail%>" 
        arg1="<%=issueLink%>" 
        arg2='<%=appUrl+"/do/systemInfo"%>'/>

C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\xplanner\WEB-INF\jsp\view\notes.jsp line 86. From:

<xplanner:link page="/do/delete/note" onclick='<%="return confirm('Do you want to delete note \\\\'" + StringUtilities.replaceQuotationMarks(StringEscapeUtils.escapeJavaScript(note.getSubject())) + "\\\\'?')"%>'>
    <html:img page="/images/delete.gif" alt="delete" border="0"/>
    <xplanner:linkParam id="oid" name="note" property="id"/>
</xplanner:link>

to:

<xplanner:link page="/do/delete/note">
    <html:img page="/images/delete.gif" alt="delete" border="0"/>
    <xplanner:linkParam id="oid" name="note" property="id"/>
</xplanner:link>

Note that this removes the confirmation of deleting comments in XPlanner.

Start XPlanner

The last step is to start XPlanner from the Tomcat Web Application Manager.

Advertisements
Posted in: Uncategorized