This topic explains how to install STAF/STAX onto the same
server as IBM® Rational® Quality
Manager,
as well as onto an external server.
- Download and install the latest STAF v3.3.x release from http://staf.sourceforge.net/getcurrent.php.
- Download and install the STAX service from http://staf.sourceforge.net/getstax.php.
- Create a services folder in the STAF install folder, for
example: C:\STAF\services.
- Extract the STAX service archive (STAXV3XX.zip or STAXV3XX.tar)
to ..\STAF\services. You should now have a ..\STAF\services\stax folder.
- 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
- 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
- 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: