To install WorkRoll as a J2EE web application,
Please follow the instructions below. Installing WorkRoll in this way requires an application server that
implements version 2.2 of the Servlet specification; most JSP-friendly application servers released during
the past few years do. If you encounter any problems during installation, please contact WorkRoll, or call (toll-free) 877-247-4818.
If you do not have a J2EE application server, or are not sure if you,
click here, or, if you are a Windows user, just download the
workroll.exe installer program; the installer is a significantly larger
download than the WAR file below, but using it requires no knowledge whatsoever of application servers.
Also, 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.
- Right-click the file below and save it to a temporary directory:
- WorkRoll, when installed as a J2EE web application, requires a "workroll.db.path" context parameter.
The value of this parameter should be a path on your server where you want WorkRoll to store its data.
WorkRoll will create its database at the path you specify (after creating the directory you specify, if
it doesn't exist). Example values for this parameter are (without the quotes) "c:\workrolldb" (for Windows)
and "/workrolldb" (for UNIX operating systems). How you specify installation-specific context parameters
for web applications depends on your application server. Please consult your application server's documentation regarding
context parameters (look for something similar to "setting context parameters for web applications").
- After setting the "workroll.db.path" context parameter, install WorkRoll by deploying the WAR file you
have just downloaded in the normal way; this
is generally a simple process. (Depending on your application server, this may involve simply dropping
the WAR file into your application server's root, or uploading the file via your application server's admin
console.) You will probably want to specify "workroll" as the context path, although any context path will
work. No other configuration is necessary; you do not need a database to run WorkRoll since it comes with
its own, and all further configuration is done through your web browser. (Note that depending on your application
server, you may need to restart the server after deploying the WorkRoll application.)
- Load http://yourdomain/workroll/index.jsp (assuming you specified the context path "workroll") into
a browser window and follow the instructions there to complete the installation and initial setup.
|