From  

Tutorials: Introduction to unix and the Arcus cluster

Connecting to the Arcus-b Cluster in Oxford

We will use mobaXterm to connect to the arcus-b cluster. This uses Xwindows and ssh.

You will find mobaXterm in the H: drive on your machine. Double click on the MobaXterm_Personal_10.2.exe to launch the program.

Click on the "Session" icon. Choose "ssh". Enter "arcus-b.arc.ox.ac.uk" as the remote host and enter the username given to you (e.g. course99). Click "ok" and it will then prompt you for your ARC password.

Do not allow the computer to save your password

You are connected to the arcus-b Cluster!!

Running your first cluster job

For this very first example you are going to submit a castep job to the queuing system. This will take place in the following steps:

  1. Creating a working area and copying some example code into it
  2. Preparing and and submitting the job
  3. Checking the output

All the things which you should type are in bold and your Linux prompt is always shown as:

[teaching01@login11(arcus-b) ~]$

i.e. you do not need to type [teaching01@login11(arcus-b) ~]$

Step 0 Copy over the environment

[teaching01@login11(arcus-b) ~]$ cp /home/jr_yates/jryates/WORKSHOP/bash_profile_castep $HOME/.bash_profile
Note carefully the dot (.) before the bash and the fact that the above is all on one line. Then activate it.

source $HOME/.bash_profile

Step 1 Copying the examples into a working area.

Firstly, let's create a temporary working area to do the examples in. This is usually a good idea for every distinct problem you're working on as it keeps things tidy and manageable. We'll create a directory (or "folder" in Windows parlance) called "intro" using the Linux command mkdir

[teaching01@login11(arcus-b) ~]$ mkdir intro

Now check that your intro directory has been made properly by listing the directory (or folder) you are already in:

[teaching01@login11(arcus-b) ~]$ ls

and you should see a list of files and directories including the new examples directory. Now let's "move" into that directory:

[teaching01@login11(arcus-b) ~]$ cd intro

Note that "cd" is the Linux command for changing directories. You can move back to your home directory at any time by typing "cd" just on its own. You can check your current directory at anytime with the "pwd command":

[teaching01@login11(arcus-b) ~]$ pwd

If you run "ls" in the examples directory, nothing is listed as there are no files yet (try it). Let's copy the example code from one directory (provided by the tutors) to your current location. Note the space between the "*" and "." :

[teaching01@login11(arcus-b) ~]$ cp /home/jr_yates/jryates/WORKSHOP/intro/* .

Do NOT forget the "." character. To Linux this means "my current directory". So you are copying (with the "cp" command) all files (represented by "*") in the directory /home/jr_yates/jryates/WORKSHOP/intro to your current directory. Now try an "ls" to see what you've got. You should see several files:

[teaching01@login11(arcus-b) ~]$ ls
diamond.cell diamond.param 

These are the usual "cell" and "param" castep input files. To look at the files you can use the command called more (similar commands are cat and less)

user@login-sand7 ~]$ more diamond.cell

Step 2 - Preparing & submitting a job

Now we are ready to submit the job to the queue. The special command ‘castepsub’ is used for this. We’ve written this command specially for the workshop - on your local cluster there will be a different (but very similar) way to submit jobs to the cluster.

[teaching01@login11(arcus-b) ~]$ castepsub -n 4 diamond

This will have submitted your job to the cluster to run on 4 processors. Use ‘ls’ to to list your files. It should take only a few seconds to run. You can then examine the castep output file "diamond.castep". Note how many kpoints were used.

Rename the *.castep file

[teaching01@login11(arcus-b) ~]$ mv diamond.castep diamond_200ev.castep

Editing a file Edit the diamond.param file (increase the cutoff energy to 400 eV). To do this you will need to use an editor. (for experts ‘vi’ and ‘emacs’ are available). Otherwise I suggest using an editor called nano. This has helpful list of instructions are the bottom of the screen (but ask if you are confused!)

[teaching01@login11(arcus-b) ~]$ nano diamond.param

Now submit the job again.

Compare the runs at 200 and 400eV. Which took longer? Has the total energy gone up or down. Look at the Atomic Populations section - is it what you expect?

Summary of useful commands

check2xsf

This is a handy free program written by Michael Rutter (TCM group Cambridge). It can convert castep.cell and castep.check files into various formats eg cell, pdb. (and many other things!)

Retrieved from http://www.castep.org/Tutorials/00-unix
Page last modified on August 14, 2017, at 12:15 PM