\documentclass{article}
\begin{document}

You can find general information about the computing resources in the
Theory Group in these web pages.

%{{{ Theory Group Computing Policy

\section*{Theory Group Computing Policy}
\label{sec:policy}

{\bf 1. Category of users included in this policy:}

a) Postgraduate students \\
b) Postdoctoral Fellows \\
c) Lecturing Staff \\
d) Visiting Academics (with the approval of the Lecturing Staff member
   they are visiting) \\
e) 4th Year MPhys (theory) project students (with the approval of
   their Lecturing Staff member supervisor) \\
\bigskip

{\bf 2. All the above members of staff are entitled to:}

a) an account on the fileserver/mailserver (pyserver) \\
b) access to the gateway machine \\
c) an account on the web server (pyweb) \\
d) an account on their their desktop workstation \\
e) registration of the ip address (both wired and wireless) of any or
   their laptops (whether personal or group owned) \\
f) in the case of seminar organisers, access to the seminar organisers
   web pages/accounts on pyweb \\
\bigskip

{\bf 3. People allowed to have root access to their desktop workstations:}

a) Lecturing Staff \\
b) Postdoctoral fellows with the approval of the lecturing staff member
   "overseeing" them \\
c) Postgraduate students with the approval of the student's supervisor \\
d) Visiting academics with the approval of the lecturing staff member
   they are visiting \\
\bigskip

{\bf 4. Person responsible for providing 2a-f and 3a-d:}

2a: Chris Allton (c.allton@swan.ac.uk) \\
2b-f & 3a-d: Dave Payne (d.payne@swan.ac.uk) \\

%}}}

%{{{ new users

\section*{New Users}

If you are recently arrived in the department, then an account should
have been set up for you. Ask your supervisor, or the
person you are visiting if this has been done.

Email registration with the Computing Services can unfortunately
take a few days. This means that you will not be able to email out
of Swansea for this period.

If you have any queries which cannot be resolved by reading the details
below, see \ref{sec:pydave} for details.

%}}}
%{{{ passwords

\section*{Passwords}

To change your password, use the command {\tt passwd}.

%}}}
%{{{ Backups

\section*{Backups}

<blink>
{\bf Desktop Linux PC's are NOT BACKED-UP !!!!!!!!!!!!!!!!!!!!!!}
</blink>

The only computer files which are backed up automatically are on your user
account on pyserver.

{\bf MAKE SURE THAT ANY IMPORTANT FILES ARE COPIED TO YOUR pyserver USER ACCOUNT.}


You can easily copy your files from your workstation to pyserver using
a command analogous to this (while logged onto your workstation):

{\tt rsync -avtz -e ssh TestDir pyuser@pyserver:}

This copies across the entire directory {\tt TestDir} (including all its
subdirectories) to the home area of the {\tt pyuser} account on
pyserver. Note that it's important {\em not} to put a trailing
backslash on {\tt TestDir}, i.e. do not use {\tt TestDir/}

You can trivially generalise this to copy across more than one
directory:

{\tt rsync -avtz -e ssh TestDir AnotherDir pyuser@pyserver:}

If you want to copy across the directory {\tt TestDir} to a subdirectory
on pyserver, you can use the following:

{\tt rsync -avtz -e ssh TestDir pyuser@pyserver:MyBackupDir}

This will put the directory {\tt TestDir} and all its contents onto the
directory {\tt MyBackupDir} on pyserver.

Note, if you don't want to copy across, say, postscript files, then
you can use the {\tt --exclude} option as follows:

{\tt rsync -avtz -e ssh --exclude '*.ps' TestDir pyuser@pyserver:}



% User files on pyserver are automatically backed-up
% nightly (internally) on pyserver. i.e. there are two user disks on pyserver,
% one contains your usual files ({\tt /home/pyuser}) and the other
% contains a nightly backup of these files. This backup copy is
% accessible by all users in the directory:
% 
% {\tt /mnt/backup/home/home/pyuser}
% 
% where {\tt pyuser} is your usual pyserver account name.
% This means that if you accidentally delete a file, and realise you
% have done this {\em the same day}, you can retrieve {\em yesterday's}
% version of that file by going to the above directory where you will see
% a copy of all your files, as they were last night.

%}}}
%{{{ file space

\section*{File Space}

{\tt df -k} gives the amount of disk space (in kilobytes) used up in
all the disks.

{\tt df -m} gives the amount of disk space (in megabytes) used up in
all the disks.

If the output from the above is confusing, just type:

{\tt df -h .} which will give you the disk usage (including spare capacity) on
the disk partition where you are currently sitting in more human
readable units.

{\tt du -h file} gives the amount of disk space of {\tt file} (in more
human readable units) where {\tt file} can be a filename or directory

%}}}

%{{{ machines available

\section*{Machines Available}

We have a number of Linux PC's scattered throughout the group.
There is probably one sitting on your desk in fact!

The mailserver and fileserver (see section on backups!!) is pyserver.

%}}}
%{{{ I've got a new machine, how do I connect it to the network?

\section*{I've got a new machine, how do I connect it to the network?}

Firstly see our policy on such machine in \ref{sec:policy}.

{\bf For a wired connection:} give/send Dave Payne \ref{sec:pydave}
the mac address, and it'll be registered on the network.

To get the mac address in {\bf Linux} type {\tt ifconfig} or {\tt
/sbin/ifconfig} and the mac address is the thing which looks like:

{\tt 01:A2:3B:C4:5D:E6}.

To get the mac address in {\bf Windows}, go to the Start menu and select
{\tt Run}. Type {\tt cmd} and press enter. Type {\tt ipconfig /all}
when you see a command prompt and the mac address is the thing which
looks like:

{\tt 01:A2:3B:C4:5D:E6}

{\bf For a wireless connection:}
\begin{enumerate}

\item Goto SWIS and register at <a href=''http://swis.swan.ac.uk''> 
http://swis.swan.ac.uk</a>

\item Input mac address (see above)

\item Wait for confirmation email.

\item Download and run the tool setup programme.  Note that the tool
setup programme works for XP only; W2K and MACs have to be done
manually. Linux can be done but it's a pain and LIS only offer rough
guidelines support.
\end{enumerate}
 
For short-term visitors - LIS have generic guest accounts that
are activated for the period.

For long-term visitors - LIS can create an account for them for their stay.

%}}}
%{{{ VPN

\section*{VPN}

The university runs a VPN which is run by the LIS (Library and
Information Service) and not by the department.

For information, contact the LIS computer help desk on extension 5060.

%}}}

%{{{ email

\section*{Email}

Your incoming email (once it is registered) goes to pyserver.

It is preferable that you use an email client on your desktop linux PC so that it
reads your email from pyserver automatically.

If you have a new machine (like a new laptop) then this machine will have to
have its ip number registered with pyserver for this to work. Contact Chris Allton
for this.

To set-up your email client to read from pyserver, and to send email
via pyserver, you should follow the following instructions:

%{{{ email client

\subsection*{Setting up an email client}

\begin{itemize}
\item set your incoming email server to be {\tt pyserver.swan.ac.uk}

\item set your incoming username and password on pyserver to be your actual
  login name and password on pyserver(!)

\item set your outgoing (SMTP) email server to be {\tt pyserver.swan.ac.uk}

\item set your outgoing username and password on pyserver to be your actual
  login name and password on pyserver(!)

\item you should select {\tt imap} as the email protocol to connect to
  pyserver using {\tt SSL} with authentication via {\tt password} (on
  the default port {\tt 993}).

\item set your email address to be the one given to you by our
  systems administrator.

For postgrads it will be in the form:

{\tt 123456@swan.ac.uk} where {\tt 123456} is your student number

For postdocs and staff it will be in the form:

{\tt a.einstein@swan.ac.uk} where {\tt a.einstein} is your name..

\end{itemize}

%}}}

Here's some more information about email:

%{{{ Reading your email via a web browser from anywhere

\subsection*{Reading your email via a web browser from anywhere}

<a href="https://pyserver.swan.ac.uk">https://pyserver.swan.ac.uk</a>
is the portal for reading email from our mailserver (pyserver). You
can link to this page from any web browser anywhere in the world
(windows or linux). To log in to this email portal, you should enter
your pyserver username name and password. You should be able to view
your email folders etc as if you were accessing from a local email
client and you can set various preferences using the {\tt Options}
button (at the middle top of the page).

Note that it is a ``Secure'' (https) web page, i.e. it is

{\bf https://pyserver.swan.ac.uk} $\;\;\;\;\;\;$and not

\ http://pyserver.swan.ac.uk

Don't forget to {\bf Sign Out} (top right-hand-side) when you have finished,
especially if you are in a internet cafe!!!

%}}}

%{{{ Sending email to theory group members

\subsection*{Sending email to theory group members}

The following email lists/aliases have been defined on pyserver:


\begin{itemize}
\item {\tt pystaff}
\item {\tt pypostdocs}
\item {\tt pystudents}
\item {\tt pyothers}
\item {\tt pyall}
\end{itemize}

with {\tt all} defined as

{\tt pyall = pystaff + pypostdocs + pystudents + pyothers}

(The category {\tt pyothers} is for e.g. visiting academics etc.)

So, if you want to send an email to, e.g. all current theory group
postdocs, then

(i) make sure you are on a local UWS machine (e.g. logged onto your
desktop PC in the department)

(ii) use your mail client to send the email to {\tt pypostdocs@pyserver}

{\bf NOTE that this will not work if you are sending the email from a
machine outside Swansea}

%}}}

%}}}

%{{{ www

\section*{WWW}
\label{sec:proxy}

The URL for the Physics Department Home Page is
www.swan.ac.uk/physics

If your computer has been assigned an ip number in the range
{\tt 137.44.146.*}
then you'll need to set up your proxy server using the following instructions:

\subsection*{General Browser}

\begin{itemize}
\item In the preferences of your browser, find the proxy setting (it
  may be in an ``Advanced Settings'' tab
\item set the HHTP proxy to {\tt wwwcache.swan.ac.uk port 3128}
\end{itemize}

\subsection*{Microsoft Internet Explorer}

I believe, though I haven't checked that you should do something like:

\begin{itemize}
\item Begin by starting Internet Explorer
\item Go to the {\tt Tools} menu item and select {\tt Internet Options}
\item Go to the {\tt Connections} tab
\item Near the bottom, click on the {\tt LAN Settings...} button
\item In the Proxy server section, put {\tt wwwcache.swan.ac.uk}
in the {\tt Address:} box, and put
{\tt 3128} in the {\tt Port:} box.
\item Click {\tt OK} to everything to exit
\end{itemize}

That's all you need to do!!

%}}}

%{{{ ssh

\section*{SSH}

To log-in to a different computer within Swansea Physics, you should use ssh.
The syntax from a unix machine is:

{\tt ssh username@pc_name.swan.ac.uk}

{\bf Note: you cannot directly access Theory Group machines
from outside the Swansea Physics Department. See \ref{sec:access}
for how to do this.}

%}}}
%{{{ copying files between computers

\section*{Copying Files Between Computers}
\label{scp}

You can copy files between machines within the theory group (assuming that
both are running linux) using ``scp''. This is the secure version of ftp.
(If you want to know how to copy files between your computer while it is running
windows and another computer which is running linux, see \ref{sec:windows}
for details.)

I'll now give the example of copying a file from your desktop PC
to pyserver, the syntax is (assuming you are logged onto your desktop PC):

{\tt scp filename pyuser@pyserver:}

Note ``pyuser'' is your username on pyserver.
(You will be prompted for your pyserver password.)

If you are logged onto pyserver, then the same thing as above can be
achieved as follows:

{\tt scp pyuser@pydesktop:filename .}

This will copy the file ``filename'' on pydesktop to the local directory
of pyserver.

You can modify the above by adding directory structures, eg.

{\tt scp pyuser@pydesktop:tex/latest_paper/figure1.eps .}

%}}}
%{{{ Accessing theory group machines from outside Department

\section*{Accessing Theory Group Machines From Outside the University}
\label{sec:access}

{\bf Without using VPN}

If you are outside the Unviersity and you are not using the VPN, then
you will not be able to {\bf directly} access theory group machines.
The only exception to this is pyserver.  So, if you wish to access,
e.g. your desktop, log-in first to pyserver and connect from there.

{\bf Using the Swansea University VPN}

The University's VPN service can enable you to directly access theory
group machines (in particular your deskopt). This VPN service is available
for:

\begin{itemize}

\item wireless laptop internet connections {\em on campus}

\item home PC's accessing the internet via broadband

\end{itemize}

See <a href=http://www.swan.ac.uk/lis/swis/ >here</a> for details
about how to register with this VPN service. Since this system is run
by the University, and not the department/group, most of the technical
assistance for this should be obtained from the LIS in the University.

%}}}
%{{{ Accessing Linux Machines while running Windows

\section*{Accessing Linux Machines while running Windows}
\label{sec:windows}

If you want to access our machines from a windows machine, then you
should download the 
<a href=http://www.openssh.org/windows.html >
PuTTY Programme </a>

{\bf Note: you cannot directly access Theory Group machines
from outside the Swansea Physics Department. See \ref{sec:access}
for how to do this.}

If you want to copy files between a windows machine and a theory
group (linux) machine, then you
should download the 
<a href=http://winscp.net/eng/index.php >
WinSCP Programme </a>

%}}}

%{{{ printing files

\section*{Printing Files}

These commands are appropriate for the linux PC's.

{\bf Converting you postscript file to two-pages per sheet:}

Note if you want to convert your postscript file to a two-pages per sheet
postscript file, (thereby saving paper when you print it) issue the command:

{\tt psnup -2 file.ps file2.ps}

where file.ps is your original postscript file, and file2.ps is the
two-pages per sheet file.

{\bf Print commands:}

We have two working postscript printers in {\bf Room 518}, one
black\&white and one colour. There are other black\&white printers
on the 4th and 6th floors.

{\bf Problems:}

If the printer runs out of paper, contact Ray Squires in Room 617B.

%}}}

%{{{ symbolic manipulation

\section*{Symbolic Manipulation}

We have a site license for Mathematica. Just type

{\tt Mathematica}

If the Mathematica license has run out, then you'll need our License Number which is:

{\tt L2430-2506}

If you have problems, contact Dave Payne.
(See here \ref{sec:pydave} for his contact details.)

We also have some machines with Maple. Contact Dave Dunbar for access to these.

%}}}

%{{{ Computer Technician

\section*{Computer Technician}
\label{sec:pydave}

Dave Payne is our Departmental Computer Technician who can help you with
hardware and software issues relating to 

\begin{itemize}
\item the workstation on your desk
\item pyweb (the department's web server)
\item pyserver1
\item registering computers on the network
\end{itemize}

He can be contacted on his cordless phone which works almost anywhere on campus
(extn 8018). His office is room 614. His email address is
{\tt d.payne@swan.ac.uk}

For problems/queries relating to pyserver, please see Chris Allton.

%}}}

\end{document}
