Introduction to using PUMA

This page contains information on getting started with PUMA.

Logging on to PUMA

Users can log onto PUMA via ssh (and ssh only). For example:

$ ssh -Y's password:

If you wish to change your password, do so using the passwd command. Passwords should be at least 8 characters long with at least 1 non-alphanumeric character.

System Maintenance

Details of system maintenance, planned outages as well as informative notices will be sent to the PUMA users' email list. You will automatically be added to this mailing list when your PUMA account is activated. Whilst it is possible to unsubscribe yourself from this mailing list we advise that you DO NOT do so otherwise you will miss out on important announcements affecting PUMA. Only the PUMA systems team can post to this mailing list.

Shells, etc

PUMA is running SUSe Linux. The login shell is the Korn shell (ksh).

Transferring Files

File transfer to and from PUMA can be achieved via scp or sftp. For example:

userid1@host$ scp filename.tar's password:
filename.tar 100% |*******************************| 5170 00:00


The following text editors are available on PUMA:


Using the UMUI

To start up the UMUI simply issue the command:

$ umui

Hand-Edit & STASHmaster Files

This section only applies if you are moving from using a local UMUI installation to PUMA.

If you use any personal hand-edit scripts and/or STASHmaster files, then these will need to be copied over to PUMA using scp or sftp (see instructions above).

It will make life a lot easier if, and hence strongly recommended that, you keep the same directory structure when you copy these files over to PUMA.


$ scp -r /home/ros/hand-edits ros@puma:/home/ros/hand-edits

If you don't keep the same directory structure then you will have to update the paths to these files in all of your jobs, as will everyone else who uses your files!

Useful UMUI information

  • Ability to mark experiments as Private/Public

If you don't wish for an experiment to be viewable by everyone (Public) it is now possible to mark an experiment as being Private, meaning that the experiment is only viewable by the owner and those on the access list. This functionality is accessed from the Experiment menu. (Also see the Help menu on the main UMUI window.)

  • Using the "Submit" button to submit a job to ARCHER and MONSooN

If you are submitting your job to run on ARCHER or MONSooN then you need to have ssh setup correctly to allow submission to work. See setting up ssh for ARCHER and setting up ssh for MONSooN. Once you have ssh set up correctly, then having saved and processed your job you simply need to hit the "Submit" button. Submission to any other machine requires the use of the umsubmit script.

  • Troubleshooting

Should you have problems submitting your job to ARCHER using the "Submit" button then it is likely that the problem lies with the execution of the ssh commands. Before contacting the CMS Helpdesk please exit the UMUI. Set the following environment variable on the command line and restart the UMUI:

    $ export UMUI_SSH_DEBUG_LEVEL=1
    $ umui

Resubmit the job. Debug information about the ssh processes will be printed to the terminal window. This may help you diagnose the problem yourself, if not then please contact the Helpdesk and include the debug output.

For further hints and tips on using the UMUI and customisations that can be made see the webpage - customising the UMUI.


Rose and Cylc are available on PUMA. Further details can be found on the Rose/Cylc pages.

Last modified 14 months ago Last modified on 04/04/16 15:29:15