Coordination Node Software Stack Administration¶
This document provides general overview on the software installed on the CNs for DataONE operations and procedures for managing the software
Software Administrative Procedures¶
Restarting CN Rest Service¶
To stop and restart the CN Rest Service, Tomcat must be stopped and restarted.
Turning off Tomcat will automatically stop Metacat and Solr as well.
Before stopping and starting Tomcat, be certain to follow the Restart Daemons procedure to stop the daemons before stopping Tomcat, and then starting the Daemons after restarting Tomcat.
To stop Tomcat run: :: | $ sudo service tomcat6 stop
To start Tomcat run: :: | $ sudo service tomcat6 start
Restart Daemons¶
DataONE Daemons should be started and stopped in sequence.
The sequence of commands to start the daemons: :: | $ /etc/init.d/d1-index-task-processor start | $ /etc/init.d/d1-index-task-generator start | $ /etc/init.d/d1-processing start
The sequence of commands to stop the daemons: :: | $ /etc/init.d/d1-processing stop | $ /etc/init.d/d1-index-task-generator stop | $ /etc/init.d/d1-index-task-processor stop
For the D1 Processing Daemon, the 3 different modules of log_aggregation, replication and synchronization should have their properties files altered before shutting down (most important for Production Environment). The properties files are found in /etc/dataone/process each one being named: :: | replication.properties | logAggregation.properties | synchronization.properties
in each file there is a ‘active’ property set to TRUE. :: | Synchronization.active=TRUE | LogAggregator.active=TRUE | Synchronization.active=TRUE
Each of these properties should be set to FALSE.
The log file of synchronization and logAggregation should be monitored until it is obvious that all tasks have been completed. The log files are found in /var/log/dataone/synchronize/cn-synchronization.log and /var/log/dataone/logAggregate/cn-aggregation.log, respectively.
You can tell that all log aggregation tasks are completed when the log file contain messages similar to the following: :: | [ INFO] 2013-11-14 01:08:13,381 (LogEntryQueueTask:call:95) All Log Entries are processed. Shutting down | [ WARN] 2013-11-14 01:08:13,381 (LogEntryQueueManager:run:66) Excecution Disabled continue polling until shutdown
You can tell that all synchronization tasks are completed when the log file contain messages similar to the following: :: | [ INFO] 2013-11-14 01:07:49,284 (SyncObjectTask:call:108) All Tasks are complete. Shutting down | [ WARN] 2013-11-14 01:07:49,284 (SyncObjectTaskManager:run:80) Excecution Disabled continue polling until shutdown
