Want to run WorkRoll as a Windows service?
For Windows, WorkRoll is most easily installed via workroll.exe. However, when installed this way, it runs as a Windows application, not as a Windows service. If you don't know what a "Windows service" is, then installing and running it is as an application is probably best for you (in which case, download workroll.exe); if you are interested in running WorkRoll as a service, please read on.
If the JSP container of your choice is installed as a service, then WorkRoll will run as a service. WorkRoll runs under almost any JSP container (Tomcat, Jrun, BEA WebLogic, IBM Websphere, SunONE, Resin, etc.); the following instructions are for installing the Tomcat JSP container as a service. Please follow these steps (note: you may need Administrator privileges to install the following software; if you need these privileges but do not have them, Windows will notify you):
- Install a recent version of the Java SE Development Kit (JDK) from Sun Microsystems; the Sun JDK is free, and is required to run any Java-based applications. You may download the JDK here.
Or, you may also get the latest version from Sun (just make sure you download the full Java SE JDK, not just the Java Runtime Environment, or JRE; note that you do not need the JDK with Java EE).
Either way, Save the file to your desktop, then double-click the file and follow the installation instructions (use all default settings), then proceed to the next step.
- Install a recent version of Tomcat, the free JSP container and application server from the Apache Software Foundation. Note that Apache offers both application and service versions of some Tomcat releases; it is important to download the service version. Download tomcat here to ensure you're installing the version that runs as a service.
Or, feel free to download the very latest version from Apache; be sure to download the ".exe" version, not the ".zip" version.
Either way, save the file to your desktop, then double-click the file to begin the installation.
- Click through the installer screens, leaving the default settings as they are, until you get to the "Choose Components" screen; for "Select the type to install," choose "Full" from the menu. Continue clicking through the installer screens, leaving each in its default state, until you get to the "Configuration" screen, which asks you for an HTTP/1.1 Connector Port and an administrator username and password. Enter "8080" (without the quotes) for the Connector Port; then enter a username and password, and make note of the ones you've chosen. Click the "Next >>" button, and then the "Install" button on the next screen.
- Click the "Finish" button on the next and final screen, after ensuring that "Run Apache Tomcat" is checked.
- Download workroll.war and save it to the directory C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps (make sure that your browser saves the file as "workroll.war", not as "workroll.zip" or any other filename.).
- Open Windows Explorer (open the Start Menu, choose "Run...", enter "explorer" without the quotes, then press the "OK" button) and browse to C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps. You should see the workroll.war file that you've just saved (if it's named "workroll.zip", rename it to "workroll.war"), and you should see a "workroll" directory (if you do not see this directory, wait for half a minute or so; Tomcat will create it).
- Double-click on the "workroll" directory to open it, and then double-click on the "WEB-INF" directory to open it. In the "WEB-INF" directory, locate the file "web.xml" in a text editor such as Notepad (do not open it in a word processor such as Microsoft Word, or WordPerfect).
- In the web.xml file, search for this text: "<web-app>" (without the quotes). Directly after this segment of text, paste the following code...
...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.
- Wait for two minutes. (Or if you're in a hurry, right-click on the new Apache Tomcat icon in the lower righthand part of your screen, choose "Stop Service," then right-click again and choose "Start Service.")
- Click on this link: http://localhost:8080/workroll and follow the configuration instructions.
- If you encounter difficulties (such as, if the above URL does not work), restart the Tomcat service (right-click on the Tomcat icon in the lower-righthand corner of your screen, choose "Stop Service," right-click again, then choose "Start Service") and try again. If you are still having difficulties, please contact WorkRoll.com by email or telephone; contact details are here.
|
