Building ACCESS

Building ACCESS

Note: These instructions are for the CoE CMS staff, and are not intended for general users.

1. Create a target directory (e.g. /short/$PROJECT/$USER/access)

cd /short/$PROJECT/$USER/access
mkdir access

2. Create subdirectories named 'bin' and 'submodels'

cd access
mkdir bin
mkdir submodels

3. Check out the latest versions of OASIS, MOM4, and CICE Note: svn repositories for OASIS and CICE will probably change soon

cd submodels
svn co https://access-svn.nci.org.au/svn/oasis/branches/oasis3_cmip5/
svn co https://access-svn.nci.org.au/svn/mom4/branches/mom4p1_cmip5
svn co https://access-svn.nci.org.au/svn/cmip5/trunk/submodels/cice4.1

4. Create a directory in your home directory:

mkdir -p ~/ACCESS/bin

5. Copy this file into the new directory from Dave Bi's home directory

cp ~dhb599/ACCESS/bin/environs.vayu.nci.org.au ~/ACCESS/bin

6. Build OASIS: Note: Should be submitted on the express queue (to reduce stress on login nodes)

cd submodels/oasis3_prism_2-5/prism/compile
./comp_oasis325.VAYU

7. Create this directory in home:

mkdir ~/bin

8. Copy this file:

cp ~dhb599/bin/environs.vayu.nci.org.au ~/bin/

9. Build the MOM4 component: Note: Use express queue

cd submodels/mom4p1_cmip5/compile
./comp_auscom_mom4p1.VAYU

10. Build CICE Note: Use express queue. Also, we need to confirm some details of the CICE compilations

cd submodels/cice4.1/compile
./comp_access_cice.VAYU.nP 6

All executables up to this point should be in your access/bin directory

11. Build UM (Atmosphere)

• • A. Using UMUI (GUI) for ACCESS 1.0

Follow the instruction | here to setup UMUI run environment

Start up UMUI at the machine accesscollab.nci.org.au, run:

umui

This will bring up the rather large Entry Window comprising an experiment table and a set of menus.

Use the mouse to select "New" from the Experiment menu. You will be prompted for a description of the experiment. Enter the description (e.g. ACCESS Coupled Build) and click ok. An identifier for this new experiment is assigned automatically and click ok again.

Highlight this new experiment by clicking over the text (not the folder icon) with the mouse.

Use the mouse to select "New" from the Job menu. You will be prompted to pick up an identifier for this new job. Select one of letters from a to z and you then will be prompted for a description of the job. Enter the description (e.g. ACCESS Coupled Build). Lastly, you will be prompted to pick up a version for this new job. Select vn7.3.

Highlight this new job by clicking over the text (not the folder icon) with the mouse and ensure that you do not highlight other jobs or experiments at the same time

Use the mouse to select "Open read write" from the File menu.

In the main job edit window, click button "Import". You will be prompted to specify the full pathname of the job basis. Enter /projects/access/umui_jobs/basis/basis_access_coupled.vn7.3 and click button "Import"

In the left panel of main job edit window, click folder icon of "Model Selection" and then click folder icon of "User Information and Target Machine".

In the right panel of main job edit window, click "Generic Details". Change User-id to your NCI user account name and Mail-id to your email address. Also, change Tic code to the project ID (e.g. w97) that you will use for building UM. After having done, click "Close" and this will bring you back to main job edit window.

Click "Target Machine" in the main job edit window. Change "Target Machine user-id" to your NCI user account name. After having done, click "Close" and this will bring you back to main job edit window.

Click button "Save" at the bottom of main job edit window and this will save changes back to database. Click button "Process" to process your job definition into control files suitable for use by the UM. At last, click button "Submit" to submit this UM build job.

The executable is to be found in the directory $DATAOUTPUT/$USER/THIS-JOB-RUN-ID/ummodel/bin at the target machine (should be vayu.nci.org.au), where THIS-JOB-RUN-ID is a combination of experiment ID and Job ID in the format like uaelq ("uael" is the experiment ID and "q" is the Job ID)

• • B. Using Command Line Interface (CLI) for ACCESS 1.3

cd submodels
mkdir UM
svn co https://access-svn.nci.org.au/svn/um/branches/dev/han32j/VN7.3_ACCESS_coupled_dhb599 UM/umbase_hg3-CABLE
svn co https://access-svn.nci.org.au/svn/cmip5/trunk/submodels/UM/compile UM/compile
svn co https://access-svn.nci.org.au/svn/cmip5/trunk/submodels/UM/ummodel_hg3-CABLE UM/ummodel_hg3-CABLE
cd ./UM/compile/
./compile_hg3-CABLE

The executable um_hg3.exe-CABLE-XXXXXXXX is to be found in the directory /short/$PROJECT/$USER/access/bin, as created in the step 1 .