PrepServer Maintenance and Diagnostic
From RHESSI Wiki
Revision as of 09:53, 28 September 2010
Starting and Stopping
The PrepServer can be started and restarted using the re-startup.csh script (see PrepServer Installation Instructions#Standard Configuration). Executing this script will start a Management Service instance (if non is running) and then start the IDL Pre-processing Server instances. Should the PrepServer be running already, it will stop all instances of the IDL Pre-processing Server and, before shutting them down, have them unregister with the Management Service. The Management Service instance will NOT be stopped. Should it be necessary to shut the PrepServer down, then the following commands need to be executed WITH CARE:
# List all services running as the PrepServer user and show all entries for the IDL Pre-processing Service ps -u $PREP_USER | grep PreprocessorIdlService # Pick all the PIDs related to the PrepServer and execute kill kill IDL_SERVICE_PIDs # Find the Management Service ps -u $PREP_USER | grep PreprocessorManagementService # Pick the Management Service PID and execute kill kill MANAGEMENT_SERVICE_PID
If you are SURE the PrepServer user ($PREP_USER) only runs PrepServer related services, the stopping can be done quicker, HOWEVER, BE CAREFUL:
killall -u $PREP_USER java
Logging
Server/Service | Default Path | Description |
---|---|---|
Front-end | $CATALINA_HOME/logs/WebServiceAccessLogger.log | Contains an access log with details on pre-processing requests and results. Can be changed (see PrepServer Installation Instructions#PrepServer startup parameters). |
Front-end | $CATALINA_HOME/logs/catalina.out | Contains a general Tomcat log. If an error occurs in the web application, it will be recorded here. |
Management Server | $PREP_SERVER/logs/ManagementServiceMaintenanceLogger.log | Records the management server's internal queues' state (Registered/Idle/Busy servers, Preprocessing requests). |
Management Server | $PREP_SERVER/logs/ManagementServiceSystemLogger.log | Logs messages printed out by the general management server process (general errors and such). |
Management Server | $PREP_SERVER/logs/ManagementServiceProcessLogger.log | Logs messages that occur while processing client requests. |
Management Server | $PREP_SERVER/logs/*_complete_mgmt.log | A log that is written on shell level ensuring that even fatal exceptions for Java are recorded. * is the date and time the log was created. |
Media Server | $PREP_SERVER/logs/MediaServiceSystemLogger.log | Logs messages printed out by the general media server process (general errors and such). |
Media Server | $PREP_SERVER/logs/MediaServiceProcessLogger.log | Logs messages that occur while processing a client requests. |
Pre-processing Server | $PREP_SERVER/logs/IdlServiceSystemLogger.*.log | Logs messages printed out by the general pre-processing server process (general errors and such). * is the IDL Pre-processing Server ID. |
Pre-processing Server | $PREP_SERVER/logs/IdlServiceProcessLogger.*.log | Logs messages that occur while processing a client requests. * is the IDL Pre-processing Server ID. |
Pre-processing Server | $PREP_SERVER/logs/**_complete_idl_*.log | A log that is written on shell level ensuring that even fatal exceptions for Java are recorded. * is the IDL Pre-processing Server ID, ** is the date and time the log was created. |