Installation Instructions

Pre-requisites

The following Python and Django modules must be installed on the system before installing the COG workspace. Please refer to each package for its specific installation instructions:

• Python 2.6+
• Django 1.3+
• South 0.7.3+
• ckeditor (installed under site_media)
• django-pagination 1.0.5+
• lxml 2.3.3+
• PIL (for managing jpg images)
  • pip install PIL
• grappelli
  • pip install django-grappelli
• django-filebrowser (packaged with COG because of modifications to the source code)

Download

The COG scientific workspace software is hosted within the NCPP SVN Source Force repository. To check out the latest software version from the trunk:

svn export https://ncpp.svn.sourceforge.net/svnroot/ncpp/COG COG

The COG distribution includes the following software dependencies: filebrowser, tiny_mce, blueprint and yui.

Configuration

Installing the package will automatically create an empty database that conforms to the latest version of the schema, located in the “/database” subdirectory. After downloading the software, you must create a super-user account by running the following Django command (within the installed COG directory), and answering the ensuing questions appropriately:

python manage.py createsuperuser

Usage

To start the application, cd to the COG directory and run the Django command:

python manage.py runserver

Assuming you have deployed on localhost, you can start using the application by accessing the following URLs:

1. http://localhost:8000/admin: home page for the Django administrator interface. Log in with the superuser account you just created.
2. http://localhost:8000/cog/: the COG application index. It lists all projects that are part of the local COG site - none if you have just installed the application.
3. http://hydra.fsl.noaa.gov:8000/cog/admin/: the COG administrator home page. Start here to create a new project (for example, named <myproj>).
4. http://localhost:8000/cog/<myproj>/: the home page of the newly created project <myproj>. Start here to create additional web pages, blogs, etc. for this project

Migration

An existing installation can be easily migrated from one installation directory to another, following the steps below:

1. Check out the code from SVN into the new installation directory <COG_INSTALL>
2. Copy over the database file, located in <COG_INSTALL>/database/django.data
3. Copy all images previously uploaded to <COG_INSTALL>/site_media/uploads
4. Copy all attachments previously uploaded to <COG_INSTALL>/site_media/docs

Or, simply, the whole directory structure can be copied from one location to the other...

Upgrade

The COG application can be easily upgraded to a newer version, provided the database schema is upgraded as well. Simply follows these steps:

1. cd <PARENT_OF_COG_INSTALLATION_DIR> 
2. svn export https://ncpp.svn.sourceforge.net/svnroot/ncpp/COG COG
3. python manage.py migrate cog

The last step will evolve the schema of the schema used by the cog application to the latest version.