Maintain Installation

To maintain the DVN application, perform the tasks in this section on a regular basis. Not that there is no maintenance for the PostgreSQL database and Apache server. Be sure to check the Dataverse Network Project Forum for additional information about maintaining the DVN application.

Maintenance includes the following tasks:

Check GlassFish

Perform the following to maintain GlassFish server:

Check the GlassFish logs periodically. 
Log files are located in the /<glassfish>/domains/domain1/logs directory. The main log is the server.log file.
Restart GlassFish. 
See GlassFish Utilities for detailed information about utilities that you can use to start and stop the server.

GlassFish Utilities

The asadmin utility is located in /<glassfish>/bin. You can use this utility to perform the following:

If you are in the top level of the GlassFish directory, the command to stop GlassFish is:
bin/asadmin stop-domain domain1
To restart GlassFish, type: 
ulimit -n 32768  bin/asadmin start-domain domain1

Or, you can create an initialization script (see The glassfish.sh Script):

Save the script in the following location:
/etc/rc.d/init.d/glassfish.sh
Type the following: 
chmod +x /etc/rc.d/init.d/glassfish  chkconfig --add glassfish
You then can stop and start GlassFish by using the service command as follows: 
service glassfish stop  service glassfish start

Note: If you installed GlassFish anywhere other than /usr/local/glassfish, you must change the following line in the GlassFish script to the location in which you installed the application: 
ASADMIN=/usr/local/glassfish/bin/asadmin

The glassfish.sh Script

#! /bin/sh
# chkconfig: 2345 99 01
# description: GlassFish App Server

set -e

# Increase file descriptor limit
ulimit -n 32768

ASADMIN=/usr/local/glassfish/bin/asadmin

case "$1" in
start)
     echo -n "Starting GlassFish server: glassfish"
     $ASADMIN start-domain domain1
     echo "."
     ;;
stop)
     echo -n "Stopping GlassFish server: glassfish"
     $ASADMIN stop-domain domain1
     echo "."
     ;;

*)
     echo "Usage: /etc/init.d/glassfish {start|stop}"
     exit 1
esac

exit 0

Back Up Data

The DVN software does not provide automatic back ups of your application data in the database or of your files in the file system.

Plan to do regular back ups of all data and files, to ensure that users have reliable access to current data. The Project recommends the data backup terms supported by the IQSS DVN:

Data backup terms - The IQSS Dataverse Network maintains a full backup of all data and directories on the Network for 6 months, in the Harvard Depository. This means that there always is a full, offsite copy of the Network that is less than 7 months old.
Backup schedule - On Mondays, any files changed since the last full back up are backed up. On other days, only the files changed since the last incremental back up are backed up. Full back ups also are performed administratively on an as-needed basis.