CAMd Summer School 2016
Announcement: https://www.fysik.dtu.dk/english/Research/CAMD/Events/Summer-school-2016
Logging in to the databar
The software (mainly Python, ASE and GPAW) that you need for the computer exercises are available in the databar. You are expected to access the databar from your own laptops. There are essentially two ways for doing that: ThinLinc and Secure Shell. ThinLinc will give you a Linux desktop, Secure Shell will open windows on your normal desktop.
- Linux and Mac users:
We recommend using Secure Shell.
- Windows users:
ThinLinc is easier to install, many find that Secure Shell is nicer to work with.
Using Secure Shell on Linux and Mac computers
Mac users: You need to install the semi-official X-server for MacOS: https://xquartz.macosforge.org/
To log in, open a Terminal window. On Ubuntu Linux click on the Dash Home and search for Terminal - we recommend dragging it to the dock. In Mac OS X, find it in Spotlight, again we suggest dragging it to the dock.
In the terminal window, type:
$ ssh -X login.gbar.dtu.dk
and once you are logged in, proceed to log in to one of the Linux machines with:
$ linuxsh -X
Note that first you log in to a login server that cannot run our software, the second command then logs you on to one of the least loaded Linux servers where the software is expected to work. Forgetting to run the ``linuxsh -X`` command every time you login is the most common source of errors!
You now need to read Setting up your UNIX environment.
Installing and using Secure Shell on Windows computers
To log in to the databar and display the applications on your Windows desktop, you need to install an X11 server on your Windows machine. We recommend installing MobaXterm. See also MobaXTerm for Windows users.
The server name is login.gbar.dtu.dk
Once you have an xterm terminal window open on the gbar login server, type:
$ linuxsh -X
to proceed to one of the Linux servers, where the course software is installed.
You now need to read Setting up your UNIX environment.
Installing and using ThinLinc
This is an alternative way to access the computers from Macs and Windows machines, if for some reasons you do not wish to use SSH.
Information on how to install and use ThinLinc is available here: https://gbar.dtu.dk/index.php/faq/43-thinlinc
Set the server name to thinlinc.gbar.dtu.dk. User name and password is your DTU login. When loggin in, you are asked to choose between different desktops, we recommend choosing Xfce (some of the other choices will cause trouble).
You need to open a terminal window to use gpaw. Click on the Applications Menu, then on Terminal Emulator.
Hint: Before you log in the first time, click on Options, choose the Screen tab, and select “Work area (maximized)”. Then thinlinc will open a window filling the whole screen, but will not go into full-screen mode which many people find annoying to get out of again.
Setting up your UNIX environment
The first time you use the databar computers, you must configure your
environment. Add the following line to the very end of your
.bashrc
file:
source ~mikst/camd2016.bashrc
This will set up the environment for you so that you can use ASE, GPAW and matplotlib.
Note that the file .bashrc
starts with a period, making it a hidden file in Unix.
If you would like to setup the text editors nedit
and vim
in a python
friendly way you can execute the command:
$ sh ~mikst/python_friendly.sh
This may take about a minute or so.
Running GPAW calculations
Warning do not use spaces in the directory/file names!
GPAW calculations are written as Python scripts, which can be run with the command:
$ python filename.py
If the calculation lasts more than a few seconds, submit it to the queue instead of running it directly:
$ gpaw-qsub filename.py
This will allow the script to be executed on a different host, so the
jobs will be distributed efficiently even if many users logged on to
the same computer. The output from your script will be written to the
files filename.py.oNNNNNN
and filename.py.eNNNNNN
where NNNNNN
is a job number. Normal output (stdout) goes to
the .oNNNNNN
file, whereas error messages (stderr) goes to
.eNNNNNN
. Unlike some queue systems these files appear when
the job starts, so you can follow job progress by looking at them.
You can run jobs in parallel, using more CPUs for increased speed, by specifying e.g. 4 CPUs like this:
$ gpaw-qsub -p 4 filename.py
The qstat
or qstat -u USERNAME
commands can be used to
monitor running jobs, and qdel JOB_ID
to delete jobs if
necessary. On the joblist from qstat
, you can find the JOB_ID.
You can also see the status of the jobs, Q means queued, R means
running, C means completed (jobs remain on the list for a while after
completing).
Exercises and Tutorials
You are now ready to embark on the Tutorials and exercises. Have fun.
Accessing databar files on your laptop
The databar has its own file system, separate from your laptop (obviously). If you want to keep your scripts and/or results, the files should be transferred to your own computer.
If you use MobaXTerm on Windows, you can access your databar files by dragging and dropping in the file window to the left.
If you use ssh to log in, and are familiar with the scp command, you can use it to copy files back and forth:
scp camd16XXX@login.gbar.dtu.dk:myfolder/myfile . scp localfile camd16XXX@login.gbar.dtu.dk:myfolder
You can map your databar home folder as a network drive:
On a MAC: From Finder select Go / Connect to Server (⌘K) and enter the following as the Server Address:
smb://home.cc.dtu.dk/camd16XXX
On Windows: Tools | Map Network drive
And select any unused drive letter and enter the following as path:
\\home.cc.dtu.dk\camd16XXX
On Linux: It depends on the Linux distribution and on what software is installed. If you have samba installed, you should be able to mount the drive using the smb protocol, use the same address as on a Mac (see above).
Another option that may work is the sshfs command. Create an empty directory, and mount the remove file system there:
mkdir databar sshfs camd16XXX@transfer.gbar.dtu.dk: databar
If you fumble, you may leave the folder in a half-mounted state, and get a “Device or resource not ready” or “Transport endpoint is not connected” error when you try again. In those case, either create a new folder with a new name, or reboot your linux machine.
Cannot open new windows after 20 minutes
If you use SSH to log in from a Mac (and from some Linux distributions), an over-zealous security measure prevents the databar computer from opening new windows if it is more than 20 minutes since you logged in.
To fix it, edit the file /etc/ssh/ssh_config as the super-user, and add a magic line to it:
cd /etc/ssh
sudo nano ssh_config
This opens a primitive editor. Use the arrow keys to go to the end of the file, and add this line:
ForwardX11Timeout 36000
(it is case sensitive, so use copy-paste).
Save the file and exit (Control-X). This increases the time-out to 36000 seconds, i.e. ten hours.
Notes and hints
Editor: Several editors are available including emacs, vim and gedit.
Printer: There is a printer in each databar, the name is written on the printer. To use it from a terminal:
lp -d printename filename
. Read more about printing here.To open a pdf-file:
evince filename.pdf
The normal tilde (~) key combination is not functional on the databar computers. Use Alt Graph + 5 to type a tilde.