Running WPI Suite TNG Locally

This page contains instructions for running WPI Suite on your computer. If you have not already setup your development environment, see Setting Up Your Development Environment.

You can run both the WPISuite core and the client on your computer. The core runs on the Tomcat server you installed previously.

Before running WPISuite, you need to make sure Eclipse is not set to build before launching, as this will cause issues if you start the core, then run Janeway which triggers a build and overwrites the jars the core has already loaded. To make the change:

1. In Eclipse, open the Preferences window (Mac: Eclipe --> Preferenes, Other: Edit --> Preferences)
2. Expand the Run/Debug section and click Launching
3. Under General Options uncheck the option to "Build (if required) before launching"
4. Click Apply_ and then OK.

Run the core:

1. Right-click on the WPISuite project, select Run As, and click Run on Server.
2. Select the "Tomcat v7.0 Server at localhost" server you created earlier (or define a new server if necessary).
3. Check "always use this server when running this project".
4. Click Finish.
5. After the server starts up, you should see a new tab displaying the "WPI Suite Admin Console". This means the core is running!
6. Login to the core using the default admin account (username: admin; password: password)
7. Create a CoreUser by entering a username, full name, password, and a unique idNum (something greater than 1). Click "Create CoreUser".
8. Create a CoreProject by entering a unique idNum (something greater than 1) and a name. Click "Create CoreProject".

Run the Janeway client:

1. Right-click on the Janeway project, click Run As and select Java Application.
2. From the popup menu, select the edu.wpi.cs.wpisuitetng.Janeway class and click OK.
3. You should see a login window appear. Enter the username and password for the core user you created.
4. Enter the name of the project you created.
5. The server URL is http://localhost:8080/WPISuite/API if you are running locally with the default configuration.
6. Click Login.
7. You should now see the defects tab in Janeway (or some other module tab).

To stop the core, click the red stop square in the console tab of Eclipse. Whenever you make changes to the projects, you should stop the core, rebuild the workspace, and then restart the core.