README.dev.procedures

# -*- Mode: sh; sh-basic-offset:2 ; indent-tabs-mode:nil -*-
#
# Copyright (c) 2014-2016 Los Alamos National Security, LLC.  All rights
#                         reserved.
# $COPYRIGHT$
#
# Additional copyrights may follow
#
# $HEADER$
#

HIO README.dev.procedures
=========================

Last updated 2016-06-02

This file contains notes on procedures for the HIO development team.


Add an HIO user to LANL groups and mailing lists
------------------------------------------------

On register.lanl.gov add the user to the hiouser mailing list.

On register.lanl.gov add the user to the hiouser unix group.


Generate and publish an HIO release
-----------------------------------

Update NEWS and README, commit and push changes.

git pull

Ensure kinit & ga & tr tunnels active

Test build via:

  ./buildall -a local ga-gnu tt-gnu ct-gnu mu-gnu tt-intel ct-intel mu-intel

Test run on one or more systems according to type of changes. Example:

  ./run_combo -t ./run02 ./run03 ./run12 -s s m -n 1 2 -p 32 -b
  grep -c "RESULT: SUCCESS" run/*.out

Tag master:

  export HIOVER=1.3.0.0
  git tag hio.$HIOVER
  git push --tags

Rename and publish tarball:

  mv libhio-1.3.tar.gz libhio-$HIOVER.tar.gz
  scp libhio-$HIOVER.tar.gz tt-fey:/usr/projects/hio/user/rel
  ssh tt-fey /usr/projects/hio/dev/bin/fixgp

Update github release

  Add libhio-$HIOVER.tar.gz to release as a binary
  Add design/libhio_api.pdf to release as a binary
  Add comment to release
  Publish

Send eMail to hiouser@lanl.gov.  Sample:

  To: hiouser@lanl.gov
  Subject: HIO Version 1.3.0.4 available

  See /usr/projects/hio/user/rel/libhio-1.3.0.4.tar.gz 
  or https://github.com/hpc/libhio/releases/tag/hio.1.3.0.4 .

  File NEWS contains a description of changes.

  Cornell

--- end of README.dev.procedures ---