To stop and start Rational® ClearQuest® Web,
you must stop and start two components: the Rational ClearQuest server
and the Rational ClearQuest Web
application.
- To stop and start the Rational ClearQuest server,
use the Services application in Control Panel on Windows
or the shutdown and startup scripts provided for Linux and the UNIX system.
- To stop and start the Rational ClearQuest Web
application, you must stop and start the Web application server in which that
application is running. For more information, see the appropriate Web application
server documentation.
- If you are running the application in Rational Web
Platform (RWP), see the RWP Help topics.
- If you are running the application in WebSphere Application Server (WAS),
see the WebSphere documentation.
The information in this section assumes that you have installed the Rational ClearQuest Web components
to the default file system locations for the appropriate platform (that is, C:\Program
Files\Rational on Windows and /opt/rational on
Linux and the UNIX system). If you have installed in a different location,
change the path in the instructions as appropriate.
Starting and stopping services
on Windows
When you install the
Rational ClearQuest server
on a Windows host, the
Rational ClearQuest Registry
Server service is created and started on that computer. The service must be
running for the
Rational ClearQuest server
to work properly. The registry server processes are as follows:
- java.exe, which starts the Request Manager java.exe process,
which in turn starts the java.exe process for the Request
Manager
- cqregsvr.exe
Java programs cannot run directly as Windows services; they must be wrapped
in a program that runs the
java.exe process as a subprocess.
The process
cqregsvr.exe is a wrapper for
java.exe.
Starting and stopping services on
Linux and the UNIX system
You can start and stop the Rational ClearQuest server
process by using shell scripts in /opt/rational/clearquest/cqweb.
When stopping the Rational ClearQuest server,
always use the shutdown scripts. Do not attempt to kill the processes.
- cqserver_shutdown
- Stops the Rational ClearQuest server
- cqserver_startup
- Starts the Rational ClearQuest server
(in the background)
- cqserver_restart
- Stops and restarts the Rational ClearQuest server
(in the background)
The Rational ClearQuest server
process includes the Rational ClearQuest registry
server and Rational ClearQuest request
manager.
When you install the Rational ClearQuest server
components on Linux or the UNIX system, this daemon is created and started
on that computer:
/opt/rational/common/java/bin/../bin/architecture/native_threads/
com.rational.clearquest.cqweb.jtl.JTLRegistryServer
This
service uses the same ports that are used on Windows. For details, see Ports used by Rational ClearQuest Web.