Files
sics/site_ansto/manual/db5sics_login.xml
Nick Hauser cbcd98c10c Manual copied from ANSTO branch and committed to RELEASE-3_0 branch.
This directory was accidentally omitted from the merge-release branch during the PSI code merge.
2013-10-28 11:22:59 +11:00

100 lines
5.1 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rng" type="xml"?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0">
<info><title>SICS status and login</title><author>
<personname>Kirrily Rule</personname>
</author>
<date>2013-04-09 16:47</date>
</info>
<sect1 xml:id="status">
<title>Login to the SICS computer from a PuTTy terminal</title>
<para>Before you can control the instrument, there are 2 programs that need to be running,
SICS and Gumtree. SICS should already be configured and set running by the local
contact. This procedure allows you to check this.</para>
<orderedlist>
<listitem>
<para>On the Microsoft Windows computer in the instrument cabin, find the putty
program. <figure>
<title>PuTTy icon on the Microsoft Windows desktop </title>
<mediaobject>
<imageobject><imagedata align="left" width="30mm" fileref="putty.jpg"
/></imageobject>
</mediaobject>
</figure></para>
</listitem>
<listitem>
<para>Choose the ICS computer from the list of Saved Sessions</para>
</listitem>
<listitem>
<para>Load and open</para>
</listitem>
<listitem>
<para>Use your NBI username and password, supplied by the Bragg Institute User
Office</para>
</listitem>
<listitem>
<para>You will now have a command prompt to a Linux operating system</para>
</listitem>
</orderedlist>
</sect1>
<sect1>
<title>Check SICS status</title>
<para>Normally SICS will be running. You can check if SICS is running by using the PuTTy
window and at the Linux operating system command prompt type</para>
<para><command>&gt; runsics status</command>
</para>
<para>If the status shows that SICS is not running, or if there is a change in the SICS
configuration files e.g. a piece of sample environment has been added, you should
contact your local contact. </para>
<para>If the local contact has confirmed it is OK to restart SICS, then in the PuTTy window
type </para>
<para><command>&gt; runsics stop</command>
</para>
<para><command>&gt; runsics start</command>
</para>
</sect1>
<sect1>
<title>Login to SICS using the putty session</title>
<para>In the previous section, you logged into the ICS (instrument control server) computer
using putty. At the Linux operating system command prompt, you will run a program that
will give you a sics command prompt. </para>
<para>For most cases, you won't have to do this. A SICS command prompt is available in
Gumtree. </para>
<para>At the Linux operating system command prompt type </para>
<para><command>&gt; sicsclient</command></para>
<para>You should see <computeroutput>OK</computeroutput> on the screen.</para>
<para>You now have a SICS command prompt. It may look strange since the cursor will be on a
blank line. You will not have access to the Linux operating system command prompt until
you log off.</para>
<para>Next step is to login to sics by typing</para>
<para><command>&gt; user password</command> where user is literally the word "user" and the
password will be supplied by the local contact</para>
<para>You can replace user with spy. The spy login provides read-only access to SICS.
</para>
</sect1>
<sect1>
<title>Login to SICS from Gumtree</title>
<figure>
<title>Gumtree connected to SICS </title>
<mediaobject>
<imageobject><imagedata align="center" width="160mm" fileref="taipanGumtree2.jpg"
/></imageobject>
</mediaobject>
</figure>
<para>Normally, Gumtree will be connected to SICS, as in the figure above. </para>
<para>In Gumtree you reconnect to SICS if you restart SICS. This is done by clicking on the
little man at the bottom of the Gumtree screen when logged in to SICS. He will be
standing still, and you will see the word Disconnected when not connected. He will be
running when connected as in the figure. You will then need to start a new Sics terminal
in Gumtree. From the left screen, in the project explorer window, Right click on SICS
and choose the option to start a new “SICS telnet terminal”. </para>
<note>
<para>Reconnection won't work properly if SICS has changed configuration e.g. you've
added a piece of sample environment. In this case, when you restart SICS you should
also restart Gumtree </para>
<para/>
</note>
</sect1>
</chapter>