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


Installed Software
--------------------------

OpenLDAP
~~~~~~~~

Apache
~~~~~~

Tomcat
######

Solr
######

Metacat
######

CN Rest Service
###############

Processing Daemon
~~~~~~~~~~~~~~~~~

Indexing Daemons
~~~~~~~~~~~~~~~~



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