Course Summary

Lesson 1 Introduction

The CHPS Configuration Focal Point has many responsibilities that includes configuring new sites, adding data from new sources, configuring modules and workflows, and overall maintenance of CHPS configuration.

xmlCHPS configuration files are in XML format. XML stands for eXtensible Markup Language.

XML contains elements, root elements, sub (child) elements, values, and attributes.

The main set of CHPS configuration files are located in the /Config directory. All of these directoriesare synchronized.

While there is no required naming standard, as a configuration focal point, you should follow a consistent naming convention to make managing configuration files easier.

As with the naming convention, there is not a required file retention policy. The Hydrologic Support Branch, however, suggests keeping patches and releases in the /install directory (located in chps_share) for at least one year after the release.

Lesson 2 Configuration Basics

The Basic Steps to configurations are:

  1. Download the most recent configuration from the database.
  2. Export the configuration from the OC to your local file system.
  3. Edit the files using an XML or text editor and validate changes.
  4. Import the configuration from your local file system.
  5. Upload the configuration to the Central Database.

Config ProcessTo acquire a copy of the latest configuration files for your SA, you can copy another user's up-to-date files using simple linux commands or copy the office's main copy of the base configuration files. To acquire a copy of the latest configuration for your OC, download the configuration into your local datastore.

Once you acquire files to edit, make sure to close CHPS before making changes. Once the changes are made, be sure that the code is "well formed" and "valid". Then restart CHPS.

Once your changes are made you upload your file(s) to the Central Database using the Configuration Manager. Make sure to set the correct version active and to use a consistent naming scheme for version control.

As creating and maintain configuration files is part of the focal point duties, deleting files is part of the job as well. Focal points should identify candidates for deletion, discuss with office members, and follow/create office policy on archive and deleting files.

Lesson 3 Configure Input Data

CHPS uses two types of data -- static and dynamic data. Static data includes location, parameter, unit and unit conversions, filters, and grid data. Dynamic data includes temperature and precipitation.

Static

Dynamic

Lesson 4 Modules

Modules are the activities or operations performed in CHPS.

There are several modules built into CHPS, but some of the most commonly used (and arguably the most important) include: Import, Export, Transformation, Interpolation and General Adapter Modules.

Module StructureThe standard structure of modules are:

  1. Request data from the data store
  2. Do something...
  3. Write data to the data store

The basic steps to configuring a module include:

  1. Create a module instance configuration file in the ModuleConfigFiles directory.
  2. Register the module in the ModuleInstanceDescriptors.xml file.
  3. Register parameters in ModuleParFiles (if needed).
  4. Register external datasets in ModuleDataSets (if needed).
  5. Ensure module is registered in ModuleDescriptors.xml file.

One way you can optimize CHPS using modules is to create conditional modules such as a conditional transformation module. These modules only run given a specific incident that would trigger the module.

Lesson 5 Workflows

Workflows identify specific tasks and outline the order in which they are completed.

Workflow configuration files are located in the WorkflowConfigFiles directory and are broken up into System+Preprocessing and forecast group subdirectories.

Configuring a workflow includes:

  1. Create a workflow file in the Workflows directory.
  2. Add the workflow to the WorkflowDescriptors.xml file in the RegionConfigFiles directory.
  3. Inspect the results in the Workflow Navigator.

Adding a module to workflow requires following the same steps outlined in Lesson 4 to creating new module. Follow those steps with:

  1. Add the new module to a workflow file.
  2. Add the model display for the forecast group to the DisplayGroups.xml file located in /SystemConfigFiles.

River ReachThe Workflow Navigator shows all of the registered workflows for the entire forecast are and its associated structure.

As a configuration focal point, you can design and clean up the code within workflows to optimize performance within CHPS.

Another way to optimize performance is to create conditional workflows that only run when triggered by a situation.

Lesson 6 Troubleshooting

When troubleshooting CHPS issues, use three techniques:

When troubleshooting, be aware of three types of errors: user, machine, and server/program errors.

Follow troubleshooting steps when tackling each issue.

  1. Identify the Problem
  2. Isolate the Issues
  3. Gather Data
  4. Take Action

CHPS provides access to log files using many interfaces. You can use the log.txt file, the Administration Interface, System Monitor, Log Panel in the FEWS IFD, and the Workflow Navigator to view the log messages. These applications may also help you troubleshoot your issue.

To receive a more verbose log message, edit the Log4jConfig.xml file to change the priority value to DEBUG. Just make sure to change this back to INFO when you resolve your issue as this change results in huge files.

If you cannot resolve your issue or want to share with others how you found a solution, use FogBugz. FogBugz is the reporting forum used by the Hydrologic Support Branch and other RFCS to support CHPS and its users. This is also a good place to search when at the beginning of troubleshooting an issue.

Congratulations. You reached the end of the course material.

The course material is complete. Please log into the CLC to complete the course assessment. You will not receive credit for the course until the CLC assessment is completed!