Run Server - quality-manager/onboarding GitHub Wiki

Run Server

Run RQM Unit Tests

Run the unit tests to make sure you have all the needed code running and your environment is properly setup. In the future, you should run the unit tests prior to delivering code. See here

  1. Open AllRqmUnitTests.java
  2. Run it
  3. All should pass

Screencast:

Initialize Repository

This creates a database where things on your local server (such as test cases, test plans, test scripts, etc.) can be stored. Generating this may take a while.

  1. In Eclipse, open QM Initialize 4.0.launch.
  2. Run it.
  3. All tests should pass.

Screencast:

Launch QM Server

This starts the QM Web Server. With this you will be able to start using QM on your local machine. Note that you will need to create a new launch file on macs on the first time you start your server.

  1. If on Mac
    1. After running QM Initialize 4.0.launch the repository will be in /tmp/jazz-repo.
    2. Move /tmp/jazz-repo to location of choice.
    3. Duplicate RQM-sample.launch and rename it to something meaningful.
    4. In the duplicated launch file change the com.ibm.team.repository.db.jdbc.location property to point to your jazz-repo.
    5. In the pending changing view of RTC, right click the launch file you just created and click "ignore". When the ignore file gets generated right click that and click "ignore". You should now have no pending changes.
    6. Run the new launch file.
  2. If on Windows
    1. Run RQM-sample.launch
  3. Access the QM UI at https://localhost:9443/jazz/web/console
  4. Credentials are TestJazzAdmin1 password TestJazzAdmin1

Note: To change the default location of the generated repository, add and set the com.ibm.team.repository.db.jdbc.location property to QM Initialize 4.0.launch.

Screencast:

Troubleshooting

If you have build errors:

Go to project, clean, then okay

If you are getting Out of Memory Errors in AllRqmUnitTests

  1. Open the AllRqmUnitTests.java file
  2. Right click inside the file
  3. go to run as, then run configurations
  4. In arguments, add this to vm arguments
    • -XX:MaxPermSize=128M -Xms256M -Xmx256M

If you are still getting Out of Memory Errors or are getting them in some other context:

  1. Open eclipse.ini
    • If on Windows, it is in [RTC Home]\jazz\client\eclipse
    • If on a mac, navigate to your eclipse.app [RTC Home]/jazz/client/eclipse)
    • Right click and select show package contents
    • Navigate to Content/MacOs, then open eclipse.ini
  2. Set Xms to 512m
  3. Set Xmx to 2048m

If Eclipse is running particularly slowly:

Follow the same steps as above (Out of Memory Errors)

If you are getting SQL/Database related errors:

Create a new repository

If you are getting security related errors:

Make sure QM is set to run in Java 1.6

If you are facing following issue in QM Initialize 4.0 JUnit:

  • Method : com.ibm.team.repository.service.tests.TestDbInit.testRepositoryInited()
  • Error Trace :

com.ibm.team.repository.common.transport.TeamServiceException: CRJAZ0099E An HTTP error occurred when this URL was being accessed: /jazz/secure/service/com.ibm.team.repository.service.tests.remotetests.IRemoteTestService. Error details: java.io.IOException: An established connection was aborted by the software in your host machine..

  1. Install Oracle Java 1.8 as Installed JRE.
  2. In Run Configuration, Select QM Initialize, In Main Section > Java Runtime Environment > Select Runtime JRE and select installed JRE of Oracle Java 1.8