Installation Instructions


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.7+
  • Django 1.5+
    • ​sudo pip install --upgrade django
  • South 0.8.3+
    • ​sudo pip install --upgrade south
  • ckeditor (installed under site_media)
  • django-pagination 1.0.5+
    • ​sudo easy_install django-pagination
  • lxml 2.3.3+
  • PIL (for managing jpg images)
    • sudo easy_install pil
  • TinyMCE
    • ​sudo easy_install django-tinymce
  • grappelli
    • pip install django-grappelli
  • django-filebrowser (packaged with COG because of modifications to the source code)


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 COG

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


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 createsuperuser


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

python 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. 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


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/
  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...


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

  2. svn export COG
  3. python migrate cog

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

Last Update: Oct. 25, 2013, 10:03 a.m. by Sylvia Murphy
  Facebook logo  

CoG partners: NSF, NOAA, NASA, & DOE
Earth System CoG Sponsors and Partners
CoG was developed under grants from the National Science Foundation and the National Oceanic and Atmospheric Administration, and in partnership with the Department of Energy Office of Science, the National Aeronautics and Space Administration, and the Infrastructure for the European Network for Earth System Modeling project, which is supported by the European Union. Data archive and search is provided by the Earth System Grid Federation.
CoG partners: ESGF & IS-ENES
CoG version 2.2.0   Department of Commerce   NOAA   Privacy Policy   FOIA   Disclaimer