Get Started with JASMIN

This article explains the steps involved for most scientific end-users to gain access to the JASMIN environment.

The JASMIN scientific data analysis environment is administered by CEDA and supports a wide variety of scientific workflows across environmental science domains. 

Essential steps to get started with JASMIN  

The steps listed in Table 1 (below) are required for scientific end-users to gain ssh access to the JASMIN login machines which are the "front door" for most users. Other services are available once these basic steps have been completed. 

An overview of JASMIN compute & storage components are summarised in the presentation given at the JASMIN workshop - we strongly encourage all new users to watch this video recording and take a look at the accompanying exercises. These go into detail about all the basic things you may want to do with JASMIN. 

Table 1. Steps involved for a scientific end-user to gain login access to JASMIN. Click on the links under the 'Details' column to find instructions for each step. 

Step Details Comments
1 Generate an SSH key Create this locally, ready to upload it to your JASMIN Account profile (see Step 2)
2 Get a JASMIN portal account Access to JASMIN services is controlled by the JASMIN Accounts Portal - you must register for an account. Using the JASMIN Accounts portal, you will then need to make a request to access JASMIN services and privileges you require (as described in the steps below). Some of these services will require manual approval by individuals external to the CEDA/JASMIN team.

Please note that registering on the JASMIN accounts portal does not by itself provide you with any access to JASMIN machines or services. You must complete all the steps below to gain full access. 

For further information See Getting started with JASMIN Webinar - section 2
3 Check network details In order to maintain a secure and reliable scientific infrastructure for its users, JASMIN restricts login access by maintaining an "allow list" of network domains. Check details of your network connection to JASMIN to ensure you are able to connect.
4 Request ssh login access to JASMIN Your account so far is just a profile on the accounts portal but has no privileges. If you intend to use JASMIN computing resources you need to apply for the "jasmin-login" service, which will allow you to connect to JASMIN machines using ssh. See Getting started with JASMIN Webinar - section 2  
5 Apply for access to additional services on JASMIN JASMIN has a vast number of additional services, access to these is all managed in the Accounts Portal. Search and apply for any services you require in the portal. In most cases, users will "belong" to a particular scientific project which may already have a presence on JASMIN, often in the form of a Group Workspace. See here how to Apply for access to a Group Workspace.

For further information see Getting started with JASMIN Webinar- section 4
6 How to login The 'how to login' document explains all the basic steps about logging in to JASMIN via ssh, but we also have several other tutorials that may be useful - see Exercises 1-3 here.
Get a CEDA account The CEDA Archive provides access to thousands of atmospheric, climate change, and earth observation datasets. This is directly accessible as a file system from the shared science machines on JASMIN. Some datasets on the CEDA Archive require specific agreements, to apply for access to these, you will need a CEDA account.
8 Link your JASMIN and CEDA accounts
The final step is to link your CEDA account to your JASMIN account. This allows you filesystem access to data on CEDA Archive. This is a step that you will be guided through in the JASMIN account portal. 

The table above describes the initial steps to get you started on JASMIN - however, there are a variety of ways that users can get the most out of JASMIN, that are not described in the table. Users are strongly encouraged to read further about JASMIN, and/or to discuss with scientific colleagues to gain an understanding of the resources available.

The documentation in this site is split into sections, based on different areas/services on JASMIN. You can navigate these sections in the menu on the left-hand side of your screen. A short description of each of these sections is below: 

  • Getting Started - this details all the steps needed to get started on JASMIN. Most documents are linked to from the table above, but there may be some other useful information there too.
  • Interactive Computing - this introduces the resources on JASMIN available for interactive computing. This type of computing is the most common workflow on JASMIN for new users. 
  • SLURM Batch Computing on LOTUS - this introduces the available resources on JASMIN for batch computing. 
  • Software on JASMIN - Information on running software packages within JASMIN
  • Data Transfer - this category includes guidance on transferring data to and from JASMIN.
  • MASS - JASMIN has Read-only access to the Met Office MASS storage archive. This section explains how to get access. 
  • Short-term project storage - this section introduces the concept of shared Group Workspaces and the different storage types on JASMIN. Group Workspaces (GWSs) are portions of disk allocated for particular projects to manage themselves, enabling collaborating scientists to share network accessible storage on JASMIN. 
  • Long-term archive storage - this section describes the long-term CEDA Archive which consists of thousands of atmospheric, climate change, and earth observation datasets. This is directly accessible as a file system from the shared science machines on JASMIN.
  • For Cloud Tenants - JASMIN also provides a cloud computing service, this section describes this. 
  • Workflow management - this category details the various tools available for managing your workflow.

The CEDA team also regularly hosts training workshops and events. Details about past and future events can be found on the events section of the CEDA website.