Installing STAF/STAX on the server

This topic explains how to install STAF/STAX onto the same server as IBM® Rational® Quality Manager, as well as onto an external server.
  1. Download and install the latest STAF v3.3.x release from http://staf.sourceforge.net/getcurrent.php.
  2. Download and install the STAX service from http://staf.sourceforge.net/getstax.php.
  3. Create a services folder in the STAF install folder, for example: C:\STAF\services.
  4. Extract the STAX service archive (STAXV3XX.zip or STAXV3XX.tar) to ..\STAF\services. You should now have a ..\STAF\services\stax folder.
  5. Modify the STAF.cfg file in ..STAF\bin to include the following lines:
    • SERVICE STAX LIBRARY JSTAF EXECUTE {STAF/Config/STAFRoot}/services/stax/STAX.jar OPTION J2=-Xmx384m
    • SERVICE EVENT LIBRARY JSTAF EXECUTE {STAF/Config/STAFRoot}/services/stax/STAFEvent.jar
      SET MAXQUEUESIZE 10000
  6. Configure STAF trust levels. Trust levels define the level of code access security that is applied to an application. By default, STAF trust levels are only set for requests coming from local. STAF does not identify localhost, 127.0.0.1 or the local hostname as the local machine, and does have trust levels set for it. This can be fixed by adding a trust level for the local logical id. On the Rational Quality Manager/STAX Server, run this command:
    • > staf localhost misc whoami
      Response
      --------
      Instance Name : STAF
      Instance UUID : B59A4649A01200000925E9802D543630
      Request Number : 37
      Interface : ssl
      Logical ID : MyMachine
      Physical ID : 127.0.0.1
      Endpoint : ssl://MyMachine@6550
      Machine : MyMachine
      Machine Nickname: MyMachine.raleigh.ibm.com
      Local Request : No
      Handle : 10
      Handle Name : STAF/Client
      User : none://anonymous
      Trust Level : 3
      Notice in the response that the trust level is 3, not 5. A trust level of 5 needs to be added for the Logical ID (on Windows the Logical ID should be the computer name, on Unix the Logical ID should be localhost). Add the following to STAF.cfg:
    • trust machine MyMachine level 5
      or
    • trust machine localhost level 5
  7. If you are using an external STAX server, the STAX server must trust the Rational Quality Manager server with trust level 5, and the Rational Quality Manager server must trust the STAX server with trust level 4. Add the following lines to the STAF.cfg files:
    • Add the following line to the Rational Quality Manager server STAF.cfg file:
      trust machine mystaxserver.ibm.com level 4
    • Add the following line to the STAX server STAF.cfg file:
      trust machine myrqmserver.ibm.com level 5

Feedback