2.1. HAFS Quick Start Guide

Currently, the HAFS application works on the following NOAA HPC platforms:

2.1.1. Clone and Checkout the Repository

git clone <-b BRANCH> --recursive https://github.com/hafs-community/HAFS.git

Select the branch to clone by setting the <-b BRANCH> option to the branch name.

Note

develop is the default branch.

cd /path/to/HAFS/sorc
./install_hafs.sh > install_hafs.log 2>&1

Hint

Got errors? Look into the HAFS/sorc/logs directory.

machine-setup.sh Determine shell, identify machine, and load modules
build_all.sh Compile components: forecast, post, tracker, utils, tools, hycom, ww3, and gsi
install_all.sh Copy executables to exec directory
link_fix.sh Link fix files (fix files are available on disk on supported platforms)

To configure an experiment, run:

cd /path/to/HAFS/parm
cp system.conf.<system> system.conf
vi system.conf

where <system> is replaced by the name of one of the supported platforms listed above.

Edit the following:

disk_project: Project name for disk space.
tape_project: HPSS project name.
cpu_account: CPU account name for submitting jobs to the batch system (may be the same as disk_project)
archive=disk: Archive location (make sure you have write permission)
CDSAVE: HAFS parent directory
CDNOSCRUB: Track files will be copied to this location — contents will not be scrubbed (user must have write permission)
CDSCRUB If scrub is set to yes, this directory will be removed (user must have write permission)

cd /path/to/HAFS/rocoto
vi system.conf

In HAFS/rocoto/hafs_workflow.xml.in the following can be modified to set the number of cycles and tasks.

<!ENTITY CYCLE THROTTLE “5”>: The number of cycles that can be activated at one time
<!ENTITY TASK_THROTTLE “120”>: The number of tasks that can be activated at one time
<!ENTITY MAX_TRIES “1”>: The maximum number of tries for all tasks

Change the cron job driver script to set up the experiment and storm.

cd /path/to/HAFS/rocoto
vi cronjob_hafs.sh

Make sure to check HOMEhafs and edit as appropriate.

Add the driver script to cron or simply run the driver script.

./cronjob_hafs.sh

To add the script to cron:

crontab -e
*/5 * * * * <path-to-HAFS>/rocoto/cronjob_hafs.sh

Note

On Orion, cron is only available on the orion-login-1 node.