Working Environment¶
Instructions and recommendations for setting up your computational working environment for the Salish Sea MEOPAR project, and information about the major tools that we use.
Team members at UBC will typically set up their first working environment on a Waterhole workstation running Linux. If you are running the Salish Sea NEMO model you will eventually need to set up working environments on several machines.
The Waterhole workstations are a collection of Linux workstations owned co-operatively by Susan Allen,
Rich Pawlowicz,
Stephanie Waterman,
and Roger Pieters.
They are maintained by EOAS Comp Staff,
primarily Charles Krzysik.
They are mostly located in ESB 3024/3026 but some are located in users’ offices.
The Waterhole machines are nominally identically configured so that you should be able to log-in on all of them and find the same software available for use.
They are set up so that your user configuration is identical on all machines.
All machines have a /ocean/
partition which provides storage that is large
(several terabytes),
redundant (RAID), and
automatically backed up.
That storage space is on the ocean.eos.ubc.ca
storage server
(also co-operatively owned and maintained by the same group).
Each user has their own directory on /ocean/
named with their EOAS user id;
e.g. /ocean/sallen/
.
You should use your /ocean/
directory as your primary file storage area.
Other machines that you may need working environments on later include:
salish.eos.ubc.ca
: Our group compute server that runs Linux and has several disk mounts in common with Waterhole workstations.salish
is primarily used for short development runs of the Salish Sea NEMO model.salish
has several terabytes of storage in its/data/
filesystem. If your Waterhole workstation does not have access to/data/
you should open a ticket via the Helpdesk link on https://helpdesk.eoas.ubc.ca/ to request that EOAS Comp Staff add asalish /data/
mount on the workstation you are using. That will enable you to read/write files on thesalish /data/
filesystem without having to sign on tosalish
or copy the files from one machine to another.One or more of the Digital Research Alliance of Canada (formerly Compute Canada) HPC clusters graham.computecanada.ca that run Linux. Those machines are used for longer research runs of the model.
When you are ready to run on those machines, please see the Quick Start Guide for instructions on setting working environments on them.
skookum.eos.ubc.ca
is our group results storage and web server.
The SalishSeaCast system results are stored on the /results/
and /results2/
file systems on skookum
,
and the Strait of Georgia WaveWatch3 model results and Vancouver Harbour/Fraser River FVCOM model results
are stored on the /opp/
file system on skokkum
.
If your Waterhole workstation does not have access to /results/
,
/results2/
,
and/or /opp/
you should open a ticket via the Helpdesk
link on https://helpdesk.eoas.ubc.ca/ to request that
EOAS Comp Staff add /results/
,
/results2/
,
and/or /opp/
mount(s) on the workstation you are using.
That will enable you to read files from the those filesystem(s) without have to sign on to skookum
or copy the files from one machine to another.
- bash Configuration
- Version Control
- Anaconda Python Distribution
- Salish Sea Repos and Packages
- Python, netCDF, and Model Results Visualization
- Jupyter Notebook READMEs
- Create a Digital Research Alliance of Canada Account
- Documentation with Sphinx
- ssh Configuration
- emacs Configuration
- Building a Python 3 Conda Environment
- Porting Code to Python 3
It is also possible to set up a working environment for most things other than running the NEMO model on your own laptop, if you wish. The instructions and recommendations above are most applicable to doing that on a laptop that runs OS/X or Linux. Our best advice for Windows is to install puTTY and use it to connect remotely (via ssh) to your Linux environments (though additions to these docs by experienced Windows users who set up a working environment similar to the one described above are most welcome).