ProjectCards Support - Your Agile Project Management Tool

Starting ProjectCards for the First Time

ProjectCards is a client-server application. You must install the server on one machine. On all the other machines, you just install the client. You can install both the server and the client on the same machine.

If the client is on the same machine as the server, use "localhost" for the server name. The server is installed on port number 51630 by default. If you have specified a different port while installing the server, make sure all of your users are informed of the port number used.

Once you have installed the application, login with the default username "admin" and the password "projectcards".

Installation instructions

Choose the instructions you need

Client
Server

Client

Client
Server

Client
Server

Windows

Full install (client and server)

Download and run the full installer
Follow instructions and customize for your installation
Enjoy!

Client-only installer (to deploy to other clients)

Download and run the client-only installer
Follow instructions and customize for your installation
Enjoy!

Update

If you are updating the client or the server from a previous version, a quicker way is to download the upgrade installer.

Eclipse

Client plugin

Download the plugin and copy the jar file to the plugins directory of your Eclipse installation (ECLIPSE_HOME/plugins).

Linux Server

The variety of Linux distributions and desktop choices makes it a little more difficult to supply a simple installer.
We are planning a packaging solution for a future release.
So, we tried to be as explicit as we can. But you must be ready to adapt the following instructions to your particular installation.
We will greatly appreciate any tips you can give us to improve this page and the installation process.

Linux Debian distribution

Install the latest Tomcat
```
sudo apt-get install tomcat6
```
Dowload and extract the server installation somewhere (PCARDS_INSTALL)
```
tar xzvf projectcards-server-x.x.x.tar.gz
```
Install the web application into Tomcat's webapps directory (${CATALINA_BASE}/webapps)
```
sudo cp PCARDS_INSTALL/projectcards.war /var/lib/tomcat6/webapps
```
Install the context file into Tomcat's (${CATALINA_BASE}/conf/Catalina/localhost)
```
sudo cp PCARDS_INSTALL/projectcards.xml /var/lib/tomcat6/conf/Catalina/localhost
```
Configure the ProjectCardsDataPath value in the projectcards.xml file, specifying where ProjectCards saves its data.
Example: change value="/data/projectcards" to "/srv/projectcards-projects"
```
sudo vi /var/lib/tomcat6/conf/Catalina/localhost/projectcards.xml
```
NOTE: tomcat6 user must have read/write access to the data directory. You might have to do this:
```
sudo chown tomcat6\: /srv/projectcards-projects/
```
Install the server libraries into Tomcat's lib directory (${CATALINA_HOME}/lib).
```
sudo cp -t /usr/share/tomcat6/lib PCARDS_INSTALL/tomcat-lib/*.jar
```
(Optional) The default port of Tomcat is 8080. If you want to change the default port, edit and save the server.xml file
```
sudo vi /etc/tomcat6/server.xml
```
Replace:
```
Connector port="8080"    WITH    Connector port="51630"
```
Restart Tomcat's server
```
sudo /etc/init.d/tomcat6 restart
```
Test the ProjectCards web services by accessing the 'http://localhost:8080/projectcards/ProjectProvider' page. You should see the WSDL description for the ProjectCards' web services.
Enjoy!

Linux Client

Minimum requirements : The client requires GTK and Java 1.4+ must be installed. (We are currently using version 1.4.2_13-b06)

Download and extract the client installation
To run ProjectCards using GTK, run ./projectcards-gtk.sh

NOTE: You can adjust the path towards your desired java executable in the .sh scripts. By default, it simply calls "java" with no path information.

Enabling Linux server reports

Dowload and extract the server installation somewhere (PCARDS_INSTALL)
```
tar xzvf projectcards-server-x.x.x.tar.gz
```
Install the web reports into Tomcat's webapps directory (${CATALINA_BASE}/webapps)
```
sudo cp -r PCARDS_INSTALL/pc-reports /var/lib/tomcat6/webapps
```
Install the reports context file into Tomcat's (${CATALINA_BASE}/conf/Catalina/localhost)
```
sudo cp PCARDS_INSTALL/pc-reports.xml /var/lib/tomcat6/conf/Catalina/localhost
```
NOTE: tomcat6 user must have read/write access to the report's directory. You might have to do this:
```
sudo chown -R tomcat6\: /var/lib/tomcat6/webapps/pc-reports
```
Configure reports in ProjectCards client
- Start ProjectCards Client and open a project
- Go to menu Manage > Configure server tasks
- Check 'Enable Report Generation Task'
- Set the report path. Example: /var/lib/tomcat6/webapps/pc-reports
Consult your reports at http://localhost:8080/pc-reports

Mac Client

Make sure you have GTK and Java 6 installed.
Download and extract the client installation file
run ./setup.sh
Select 'Mac' as the desired platform

NOTE: You can adjust the path towards your desired java executable in the .sh scripts. By default, it simply calls "java" with no path information.

Mac Server

Make sure Macports is installed(http://www.macports.org/)
Dowload and extract the server installation somewhere (PCARDS_INSTALL)
```
tar xzvf projectcards-server-x.x.x.tar.gz
```
Install the latest Tomcat6 :
```
sudo port -b install tomcat6
```
Install the web application into Tomcat's webapps directory (${CATALINA_BASE}/webapps) :
```
sudo cp PCARDS_INSTALL/projectcards.war /opt/local/share/java/tomcat6/webapps
```

Install the context file into Tomcat's (${CATALINA_BASE}/conf/Catalina/localhost)

sudo cp PCARDS_INSTALL/projectcards.xml /opt/local/share/java/tomcat6/conf/Catalina/localhost

Configure the ProjectCardsDataPath value in the projectcards.xml file, specifying where ProjectCards saves its data.
Example: change value="/data/projectcards" to "/opt/local/projectcards-projects"
```
sudo vi /opt/local/share/java/tomcat6/conf/Catalina/localhost/projectcards.xml
```
NOTE: tomcat6 user must have read/write access to the data directory. You might have to do this:
```
sudo chown _www:_www /opt/local/projectcards-projects/
```
Install the server libraries into Tomcat's lib directory (${CATALINA_HOME}/lib).
```
sudo cp -t /opt/local/share/java/tomcat6/lib PCARDS_INSTALL/tomcat-lib/*.jar
```
(Optional) The default port of Tomcat is 8080. If you want to change the default port, edit and save the server.xml file
```
sudo vi /opt/local/share/java/tomcat6/conf/server.xml
```
Replace:
```
Connector port="8080"    WITH    Connector port="51630"
```

Restart Tomcat's server

sudo /opt/local/share/java/tomcat6/bin/tomcatctl restart

Test the ProjectCards web services by accessing the 'http://localhost:8080/projectcards/ProjectProvider' page. You should see the WSDL description for the ProjectCards' web services. Note : Remember to use port 51630 instead of 8080 if you changed it.
Enjoy!

User's guide

Our User's guide is a good source of information. If you have any suggestion to improve this guide, do not hesitate to contact us at support@projectcards.com

We are currently updating the user's guide. Here are some additional information:

Import/Export specifications

When you export a card, all card's information is included.
When you import a card, if an entire column is missing (e.g. Tests), the import will work without error.
The column title for Acceptance Tests is "Tests".
'|||' (3 pipes) is used to separate each test or task.
';;;' (3 semicolons) is used to separate each field of test or task.
For each test, the fields' order is: Title, Status (values should be 'To do', 'Fail' or 'Pass'), Test Action, Expected Results, Setup, Teardown.
For each task, the fields' order is: Title, Estimate, Status (values should be 'true' or 'false'.

ProjectCards resources

You can find a lot of information in our Forums.

We are also available to answer your technical questions at support@projectcards.com

Project Cards

Simplify your Agile project management