EmForge Quick Start

Start EmForge

1. Download EmForge or Build EmForge from sources
2. As result - you will get ready-to-use war file configured to use build-in HSQL database to store all required data and EmForge Subversion Repository to display sources
3. Deploy this war-file into Servlet Container (we are recommending to use Tomcat 5.5 or 6.0 since we are using them in our development and it should work without any problems)
4. Open EmForge at http://your.server.name:port/EmForge

First Steps in EmForge

If EmForge start is opened for you - so, seems everything working well until now. If not - try to looks into logs - probably you will find something wrong there - or write into EmForge Mail Lists about your problem

To login into EmForge you can use build-in administrator user:

• User Name: admin;
• Password: admin;

Now, you have administrator rights and you can:

• Edit/create wiki-pages
• Create projects and milestones
• Deploy new workflows into system.

Project Management

Since all task information is related to projects, before you will able to create any tasks you need to create at least one project. It is possible to di with Admin rights (under admin used) on Projects page.

For created project you can specify it's description and manage it' milestones (on Project page click on Roadmap page and there you will able to add new Milestone for project).

Task Management

OK, you can create/edit wiki pages and projects, and now you want to test Task Management - but - how to do it?

First of all - as already was described in previous section - to be able to create tasks - you need to have at least one project in your system. Is it because all tasks in EmForge are specified for some Project, and - you cannot create task, not assigned to any Project

Second - since all tasks in EmForge are controlled by Workflow, you need to deploy some into system...

Starting from EmForge-0.22 war-file comes with some default build-in workflows, so, then EmForge will be started - you will able to use followed workflows:

• Personal Task - simplest PersonalTaskProcess workflow, there you can create task, see it in you active tasks list - and then it will be done - close it.
• To Do - simplest "To Do" - you can create some task, assign it to somebody else - and, then task will be done by this person - check - is it done and accept or reject;
• Bug-Fixing Workflow - Bug-Fixing Workflow, used by EmForge project itself;
• Feature Request Workflow - Feature Request Workflow, used by EmForge project itself.

What next?

If EmForge started and working quite fine in your case, and you want to use it a little bit more then just for simple playing and testing you need to read:

• EmForge Setup Guide - to know how setup EmForge for Production Environment;
• EmForge Workflow Development - to know how to develop a new workflow.