Differences

This shows you the differences between two versions of the page.

--- tardis_beginner_tutorials:1 [2013/10/12 19:57] – Text replace - "^" to "<div style="width:55%;margin:0 auto;border:2px solid;border-left:20px solid;border-color:#d9534f;text-align:center;padding:5px;font-weight:bold;">This page is out of date and needs rewriting.<br /> _hayden
+++ tutorials:1 [2023/05/29 19:34] – tcmal
@@ Line 1: / Line 1: @@
-{{OODNotice}}
+======= 1. Logging in to Tardis =======
-=Tutorial 1: Logging in to Tardis=
-The first thing you need to do is actually connect to Tardis and log in. If you are reading this I am assuming you already have an account, and hence know your username and password. If for whatever reason you do not know either your username or password, consult with the friendly admins in [[irc://irc.imaginarynet.org.uk/|%23tardis #tardis]] on [[irc_service|IRC]] or email the admins at [[mailto:support@tardis.ed.ac.uk|support@tardis.ed.ac.uk]]
-For shell access, Tardis only runs [[http://en.wikipedia.org/wiki/Secure_Shell|Secure Shell]] (SSH). Telnet sends passwords as well as all connection data in plain text over the Internet, and is simply not sufficiently secure in the modern world. This means that to log into Tardis you will need an SSH client. On Linux you simply need <code>ssh username@ssh.tardis.ed.ac.uk</code> where username is - you guessed it - your username! For macs, MacOSX comes with an ssh client out of the box, so check your documentation for how to use it to connect to <code>ssh.tardis.ed.ac.uk</code>.
+The first thing you need to do is actually connect to Tardis and log in.
+If you are reading this, hopefully you already have an account. If not, check [[https://tardisproject.uk|our website]] for how to get one.
+If for whatever reason you do not know either your username or password, contact an admin and we'll reset it for you.
-Windows however does not come with an SSH client built in, like it does with Telnet, and you will have to download one. I recommend [[http://www.chiark.greenend.org.uk/~sgtatham/putty/|PuTTY]] - it is powerful and easy to set up and use. It is a very small executable that doesn't need any special installation - just download from that link and run. In the window that comes up, type <code>ssh.tardis.ed.ac.uk</code> in the "host name or ip address" box, and make sure the SSH protocol is selected below. Then type a name for it in the "saved sessions" box such as "tardis" and click save - this way you can select this connection from the list in future and just double-click. Then click "open", and type your username and password when prompted.
+For our web services (such as this wiki), you should get redirected to our single-sign-on provider. You can enter your username and password as normal, and then you should be logged in to all of our web services. For some services, you'll need to select 'Login with tardis account' or similar. This is the main way you'll get into things that are already running.
-Congratulations, you are now logged in on your Tardis shell account! If you are new to Linux the lack of graphical interface can be quite intimidating, but don't worry - these tutorials will hold your hand and walk you through it! By the time you finish these, you should feel quite confident in using your account.
+If you want to run your own things or use certain services, you'll need shell access. Here a shell just means a command line - don't worry if you've not used one before.
-First off though, you might want to change your password from the one given to you. To do this type <code>passwd</code> and answer the prompts. Congratulations, you just ran your first program! Now click next to learn about how to run other programs under Linux, and move around the filesystem.
+To get a shell remotely, we use [[http://en.wikipedia.org/wiki/Secure_Shell|Secure Shell]] (SSH). This has the advantage of:
-**Next: [[tardis_beginner_tutorials:2|Using Bash]]**
+  - Encrypting everything you type (including your password) in transit
+  - Verifying you're connecting to us and not someone else
+  - (Optionally) verifying your identity without using a password.
+First, you'll need to open a terminal emulator.
+If you're using Windows, we recommend installing the [[https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701?hl=en-gb&gl=gb|Windows Terminal]] app to get an easier to use terminal - the built in ones are limited in many aspects.
+Alternatively, you can use the built-in 'Command Prompt' or 'Powershell' applications.
+If you're using Mac OS or Linux, you should already have a decent terminal emulator installed - You can hit Ctrl+Alt+T on lots of linux distros, or search your mac for 'Terminal'.
+Once you're in your terminal, type or paste ''ssh username@tardisproject.uk''. You should see something like this:
+<code>
+The authenticity of host 'tardisproject.uk (217.169.13.63)' can't be established.
+ED25519 key fingerprint is SHA256:fKa5lxKbFlavJR0bzWZNLpJTsfO29Tqs9DizNst+qak.
+This key is not known by any other names
+Are you sure you want to continue connecting (yes/no/[fingerprint])?
+</code>
+This looks scary, but all it's asking us to do is make sure the fingerprint is correct. The one you want is ''SHA256:fKa5lxKbFlavJR0bzWZNLpJTsfO29Tqs9DizNst+qak'' - paste this in and it will compare them, making sure you're connecting to us and not someone else. It will also remember the fingerprint, so you should only see this once.
+You should now see something like ''tcmal@tardisproject.uk's password:'' - enter your password (nothing will show up, this is normal).
+If you see some ASCII art and statistics then Congratulations, you are now logged in on your Tardis shell account! If you are new to Linux the lack of graphical interface can be quite intimidating, but don't worry - these tutorials will hold your hand and walk you through it! By the time you finish these, you should feel quite confident in using your account.
+First off though, you might want to change your password from the one given to you. To do this type <code>kpasswd</code> and answer the prompts. Congratulations, you just ran your first program! Now go to the next tutorial to learn about how to run other programs under Linux, and move around the filesystem.