bug tracker, user feedback manager, web-based bug tracker, defect tracker, defect tracking, user feedback, beta feedback manager, beta feedback, taskmanager, bugtracker webapp, bug tracker webapp, issue tracker, to-do list, task manager, web-based issue tracker, web-based to-do list, web-based task manager, jsp bug tracker, jsp to-do list, jsp task manager, bugt tracker, suer feredback, suer feedback, beta feedlack manager, bet a feedback, issuee tracker, isseu tracker, to-do mlst, task manger, we-bbased todo lsti, web-baseed task manager, jps bug tracker, jsp todo list l, jsp task maanger, bug htracker, user feedback manasger, web based bug thracker, beta feed back amanager, beta fedzback, taskmansger, bugtrascker webapp, isseu trascker, jspsa bug tracker




bug tracker, user-feedback manager, to-do list, task manager
     

To run WorkRoll, You need a JSP-friendly, J2EE application server. Whether or not you've already got one installed, one WorkRoll installation option is to install the (free) Apache Tomcat application server, and then install WorkRoll. Tomcat is a relatively lightweight application; it will not significantly tax your server's system resources as larger application-server software will. Please follow the instructions below, which will take you step-by-step through installing Tomcat and then WorkRoll. (And note, again: Tomcat is free.) You may want to print out these instructions now. If you encounter any problems during installation, please contact WorkRoll, or call (toll-free) 877-247-4818. (Remember, if you are a Windows user, that it may be easier for you to use the Windows installer program instead of following the instructions below; you may download the Windows installer by right-clicking here.)

Please note: installation is not necessary if you choose to have WorkRoll.com host your WorkRoll installation. A monthly fee based on volume applies; please contact WorkRoll, or call (toll-free) 877-247-4818, for details.

(Also note: these instructions are for Windows servers; if your server's operating system is not Windows, please adjust accordingly.)

(Finally, please note: the current version of Tomcat is 5.5, and the current JDK version is 1.5.x, also known as "5.0". Users are welcome to install these instead of the versions described below -- 4.x for Tomcat and 1.4.2 for the JDK. The downloads for the newer versions of Tomcat and the JDK are significantly larger than the ones linked to below; also, the Tomcat 5.5 installation process has become more complicated since the Tomcat 4.x release, especially for users wishing to use Tomcat's "admin" application.)

  1. Tomcat (and all J2EE application servers) requires a Java SDK. This is a free download from Sun Microsystems; if you do not have a Java SDK installed on your machine (or are not sure that you do), download the Java 2 Platform, Standard Edition, v 1.4.2, here (look for the "Download J2SE SDK" link; do not use the "Download J2SE JRE" link).


  2. Once you've installed Java, click here to open the Tomcat download page in a new window.

  3. Scroll down to the "Tomcat 4.x.x" section and download the file from one of these links: 4.x.x exe, 4.x.x zip, or 4.x.x tar.gz (depending on your system) to your desktop (the x's represent the version of the most recent Tomcat release).

  4. Go to your desktop, double-click the file you just downloaded, and install Tomcat as directed by the installer program. Do not start Tomcat after you have installed it. (Note: The rest of these instructions assume that you have installed Tomcat to the directory C:\Apache Group\Tomcat 4.1.)

  5. Open the file C:\Apache Group\Tomcat 4.1\conf\web.xml in a text editor such as Notepad (do not use a word processor such as Microsoft Word, Microsoft Works, WordPerfect, or Wordpad).

  6. Paste the XML code in the box below into the file, on the line following "<web-app>" (this is approximately the fifth line of the web.xml document)...
    ...and replace the text "c:\workrolldb\" if you wish for WorkRoll to store its data somewhere other than in the directory "c:\workrolldb\". Then save and close the file.

  7. Save the following file (by right-clicking on it and choosing "Save target as" or "Save file as") to C:\Apache Group\Tomcat 4.1\webapps:
    workroll.war (~500K)
  8. Make sure Tomcat is not running: go to the Start Menu and choose "Programs" (or "All Programs" on some systems), then "Apache Tomcat 4.1", then "Stop Tomcat." A command-prompt window will open; wait for it to close. Then start the Tomcat server: go to the Start Menu and choose "Programs" (or "All Programs" on some systems), then "Apache Tomcat 4.1", then "Start Tomcat." (If you cannot find these items on your Start Menu, open the Start Menu, then choose "Run...", then paste C:\Apache Group\Tomcat 4.1\bin\startup.bat into the textbox, then press "OK".)

  9. Open a web browser and go to http://localhost:8080/index.jsp. If you see the text "If you're seeing this page via a web browser, it means you've setup Tomcat successfully" at the top of the page, you have successfully installed Tomcat. (If the page does not load, wait about a minute and then try again.)

  10. You've established that Tomcat is installed and running; now, make sure WorkRoll is installed and running within Tomcat: in your browser, go to http://localhost:8080/workroll/index.jsp. Follow the instructions on this page to complete your WorkRoll installation.

Copyright © Steve Schneider 2002-2007. All rights reserved.