GettingConnected - ACCESS-NRI/accessdev-Trac-archive GitHub Wiki
Getting Connected to Accessdev
NCI Account
The ACCESS research model is exclusively run at NCI, the National Computational Infrastructure. NCI provide supercomputing access to Australian researchers through a merit-based allocation scheme. You will need a NCI account to use the ACCESS model, to register visit their account management page.
Through the account management system you can also request to join project groups, which is how compute and storage grants are managed. This is where you can connect to your group's compute project. For details on how to create a new project please see NCI's information pages.
For information on how to use NCI's facilities, including how to log in, the different storage systems and how to submit jobs to the supercomputer queue see NCI's supercomputer user's guide.
NCI provide support to users via an email helpdesk to assist with general issues at [email protected]
. The ACCESS community also has a specialist helpdesk at [email protected]
for issues specific to the ACCESS model.
ACCESS Group Membership
As the ACCESS model contains licensed software we require users to register before using the model. To register request to join the ACCESS group on NCI's account system. We may contact you to verify your use of the model is covered by the licence.
Joining the ACCESS group provides access to the Accessdev server, used to configure and run models, and to the model input and ancillary data which is stored on Gadi.
Met Office Account
To access the source code for the atmospheric component of ACCESS, the UK Met Office's Unified Model, as well as the database of model configurations, please ask [email protected]
for an account on https://code.metoffice.gov.uk. This site is a shared development platform for all groups using the Unified Model, and provides access to ticketing systems where you can track science and model code changes.
You are welcome to create new code branches in the shared environment once you have an account, however please read and follow the working practices of the model when you do so.
- Request a Met Office Account from
[email protected]
CABLE Account
To access the source code for CABLE, the land surface model used in ACCESS, you will need to register with the CABLE group at NCI. For routine use you won't need to do this, there are pre-compiled versions of the model available in the ACCESS area on Gadi. You can find more information about CABLE at https://trac.nci.org.au/trac/cable.
MOM
You can find information about the MOM ocean model, the ocean component of ACCESS, at http://mom-ocean.org. There is no need to register to access the model's source code.
Required Software
X11
While Rose has a command-line interface available the best way to use it is via its graphical interface. To use this your computer will need X11 support. Linux computers come with this by default, for Windows and Mac computers you may need extra software.
You can check if X11 is working by running:
ssh -X [email protected] xclock
replacing abc123
with your NCI username. If X11 is working you will get a window with a little clock in it, if it isn't you'll get Error: Can't open display
.
While we don't provide support for your workstation the following software enables X11 on Mac and Windows:
- Mac: http://www.xquartz.org/ (This is included by default on some older versions of OSX)
- Windows: http://x.cygwin.com/
VNC Access
If you are on a high latency connection, for instance when connecting from overseas, X11 may become extremely slow. In this case you can try using the NCI virtual desktop environment which is more efficient on slow connections (http://vdi.nci.org.au/help). Once connected to a virtual desktop you can then connect to accessdev.
SSH & SSH Agent
In order to create secure connections between Accessdev and Gadi you'll need to have a SSH agent running on your workstation. See our SSH guide for details on how to set this up.
With the SSH configuration set up you can log on to Accessdev with
ssh access
or add the settings manually to the command line
ssh -oForwardAgent=true -oForwardX11=true [email protected]
replacing abc123
with your NCI username.
To setup Cylc communication between Gadi and Accessdev run
accessdev-gadi-setup
This allows jobs running on Gadi to tell the Cylc server when they have completed or run into an error.
GPG Agent
To securely store your Met Office password for the UM code and configuration browsers you need to set up a GPG agent on Accessdev. To set up your account to see the Rose database and UM source code run
mosrs-setup
Once you have run the setup program you can relog into Accessdev and run
mosrs-auth
to save your Met Office password for 12 hours.
Check that this has worked by running
svn info https://code.metoffice.gov.uk/svn/um
It may ask for a password the first time you run 'svn info', as it hasn't seen the server before, but after that a password should no longer be required.
Checking your Configuration
To check your configuration is working correctly, and that Rose will be able to submit model runs to the Gadi supercomputer, you can run the command:
check-access-setup
This will perform a variety of checks, with suggestions on how to best fix any issues:
[pass] X11 display connected
[pass] SSH Agent is running on your workstation
[pass] Cylc can connect to Accessdev in batch mode
[pass] Cylc can connect to Gadi in batch mode
[pass] Cylc can see Accessdev from Gadi
[pass] Rose can access local suites
[pass] FCM can access local code repository
[----] Rose cannot access shared suites (not required)
* Follow instructions at https://code.metoffice.gov.uk/trac/home/wiki/AuthenticationCaching#ACCESSNCI
* Use 'rosie go --prefix=au' to see only the local suite directory
[----] FCM cannot access shared code repository (not required)
[pass] FCM can access shared code mirror
Your default project for cylc jobs is w35
* You can change this in your '~/.rashrc' file on Accessdev
If you get errors with the SSH connections, make sure you can manually SSH from Gadi to Accessdev and back - you may need to approve the server's host key manually.
More Info
For information on how to use Rose with the UM see the UM Training Website