Hosted by CU logo University of Colorado
Boulder
Powered by ESGF-CoG logo
Welcome, Guest. | Login | Create Account
CoG logo
You are at the CoG-CU node
 

HIWPP CoG Tutorial

HIWPP has chosen Earth System CoG as it collaboration tool. Below is a tutorial to get you started.

Phase 1: Getting Started

a) Create an account on the system

Click on the "Create Account" link in the upper right hand corner of this page and fill out the user profile. No approval is necessary to create an account. View detailed tutorial.

b) Understand the HIWPP project structure

There are currently seven HIWPP projects hosted on CoG.  Note that the HIWPP project, and the as yet created HIWPP_Partners project, are public while HIWPP_Internal and its child projects are private. Only project members, who are logged in, can see private projects. The private projects are there for working group documentation and collaboration. 

Project Name URL
HIWPP (Public) https://www.earthsystemcog.org/projects/hiwpp/
HIWPP Internal https://www.earthsystemcog.org/projects/hiwpp_internal/
HIWPP Management https://www.earthsystemcog.org/projects/hiwpp_management/
HWRF Nests https://earthsystemcog.org/projects/hiwpp_hurricanenest/
NMME https://www.earthsystemcog.org/projects/hiwpp_nmme/
Hydrostatic Models https://www.earthsystemcog.org/projects/hiwpp_hydrostatic/
Non-Hydrostatic Models https://www.earthsystemcog.org/projects/hiwpp_nonhydrostatic/
Test Program https://earthsystemcog.org/projects/hiwpp_testprogram/

Phase 2: Key Tasks

There are several key tasks that HIWPP project members will need to do on CoG. These include editing wiki pages, uploading files, and the creating and managing resources. General tutorials for how to perform these functions have been developed by the CoG team and are linked below for your convenience. 

a) Add or edit a wiki page

CoG comes bundled with a wiki, which is the primary collaboration space on the system. Any project member can add or edit wiki pages. Several tutorials exist to show you how to use the wiki.

  • How to use the built-in wiki system: Web
  • How to add link to a wiki page in the left navigation bar: Web
  • How to make a wiki page private: Web
  • How to add navigational items to the left navigation bar: Web

Each HIWPP project comes with several pre-defined wiki pages. Links to these pages are located in the left navigation bar. Click on one of these links (make sure you are logged in first). Below the wiki content is a row of options including "Update Page." The HIWPP project leads can give you more guidance about the content they expect to see on these wiki pages.

b) Upload files

In addition to the associated ESGF data node, CoG comes bundled with a file server suitable for files < 50mb. These can be presentations, PDF files, images etc. A tutorials exists that will show you how to use this capability.

  • How to use CoG's file sharing system: Web

What types of files you will be expected to upload and maintain will be determined by the HIWPP project leads.

c) Creating and managing resources

Resources in CoG are URLs that are organized into folders. CoG comes with some standardized folders, which have already been turned on for you by the HIWPP leads but additional folders can be created by the project. View the following tutorial to learn how to create and edit resources.

  • More about Resources: Web

Phase 3: Supplemental Tasks

There are several supplemental tasks that HIWPP project members should understand to get the most out of the CoG system. These are the Project Browser and links in the Upper Navigation Bar.

a) Project Browser

Projects in CoG exist within a hierarchy of parents, peers, and children. This hierarchy is discernable in the Project Browser, which exists to the right of the main wiki (note this can be turned off, so it may not exist on all pages). The main HIWPP project is the parent of all the subordinate HIWPP projects. The project names within the Project Browser are navigational links to those projects.

  • Click on a link in the Project Browser to see how it works.

b) Upper navigation bar

CoG comes with an ontology to describe projects and their management. Links to this information exists within the upper navigation bar (in teal). The HIWPP project leads have pre-selected a minimum set of links they wish to use. Project administrators can turn on additional links if desired (covered in the administrator tutorial). This information is consolidated across the HIWPP projects through the use of the CoG "roll-up".

  • Explore this information by clicking on the links in the upper navigation bar of one of the HIWPP projects.
  • Explore the "roll-up" by clicking on the light teal bar beneath each entry in the upper navigation bar. View the following tutorial to learn how the roll-up works.
    • How the roll-up of governance information works across projects:  Web

Phase 4: Project Content Tasks (select individuals only)

You may be tasked by your project PI with project content tasks. There is mandatory content that needs to be created/maintained for each working group. The following tasks involve editing previously defined wiki pages (see phase 2a on how to edit a wiki page). Note, these tasks do not require additional system privledges beyond project membership. 

a) Maintain/modify the summary description on the working group home page

Some initial text has been provided. This text should be modified to provide sufficient information about the goals and plans of the working group. 

b) Update the working group task pages

  • Fill in the task summary and POC on the task main page. 
  • List the team members on the task team member page. 

Phase 5: Project Administrator Tasks (select individuals only)

There are two roles within CoG, Project Administrators and Project Members. You may be selected as a Project Administrator for your working group. Project Administrators have the ability to perform additional maintenance functions on the system.

a) Editing and maintaining project-level metadata (upper navigation bar content)

CoG comes with an ontology to describe projects and their management. Links to this information exists within the upper navigation bar (in teal). The HIWPP project leads have pre-selected a minimum set of links they wish to use. An initial set of values will be filled in for you, but Project Administrators will be expected to modify and maintain this information as required. 

b) Managing project membership

The HIWPP leads will be working to ensure that members of HIWPP_Internal are copied as members of all other HIWPP projects. After this initial effort, Project Administrators may:

  • Receive an email notifiying them when a member wishes to join their project.
  • There will be a link in that email taking them to the "Pending Users" interface.  This interface will allow Project Administrators to approve or disapprove the request. Below is a tutorial to walk you through the process:
    • Managing project membership: Web

Phase 6: Getting Help

There are several ways to get assistance with the HIWPP pages on CoG:

Last Update: Nov. 21, 2014, 7:08 a.m. by Hydra Administrator