X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/blobdiff_plain/9b6e1c533955c4a278b830548d27695644b18ebb..16bd9fc469a24b025443a3ae57e032635d15a161:/doc/using-athena.mdwn diff --git a/doc/using-athena.mdwn b/doc/using-athena.mdwn index 587053e..06cd122 100644 --- a/doc/using-athena.mdwn +++ b/doc/using-athena.mdwn @@ -1,10 +1,23 @@ # Using Athena -For this series of tutorials, weâre going to assume that youâre familiar with the basics of how to use the command line. +**Intended Purpose:** + +* This article will help you answer the question âhow can I have a website with an MIT domainâ? +* The website youâre making is static (otherwise [scripts](scripts.mit.edu) might be a better option!) +* To be below the level of [afs-and-you](https://sipb.mit.edu/doc/afs-and-you/) + +**Prerequisites:** + +* Familiarity with using a terminal (experimented with basic commands like cd, ls, mkdir, etc.) + ## Connecting to Athena -The use of SSH (Secure Shell) allows a computer to remotely login into another computer/server, while making use of adequate security features. Thankfully, most operating systems have an SSH program already built in and no additional installs are needed on your machine. You can SSH into Athena by following these steps. +SSH (Secure Shell) allows a computer to remotely login into another computer/server while making use of adequate security features. Thankfully, most operating systems have an SSH program already built in and no additional installs are needed on your machine. You can SSH into Athena by following these steps. + + +**Note:** If your computer does not have `ssh`, you could also use shellinabox, an online terminal for using Athena that can be found [here](https://athena.dialup.mit.edu/.) Though, itâs not ideal as it will log you off if youâre idle for a few minutes (which is probably not what you want when youâre following a guide like this). + First, open your OSâs respective terminal. Then enter @@ -12,9 +25,10 @@ First, open your OSâs respective terminal. Then enter ssh [kerberos]@athena.dialup.mit.edu ``` -but replacing `[kerberos]` with your Athena username. So, for example, if your username is `aphacker`, you would type into the terminal `ssh aphacker@athena.dialup.mit.edu`. -If successful, ssh will tell you (in your _first_ time): +but replacing `[kerberos]` with your kerberos/Athena username. So, for example, if your username is `aphacker`, you would type into the terminal `ssh aphacker@athena.dialup.mit.edu`. + +If successful, ssh will tell you (on your _first_ connection): ``` Host key not found from the list of known hosts. @@ -23,43 +37,41 @@ Are you sure you want to continue connecting (yes/no)? Type `yes', and now it will respond: -``` + ``` Host 'athena.dialup.mit.edu' added to the list of known hosts. aphacker's password: ``` -Type your password and press Enter. Note, you will not see any characters as you type your password; this is a security feature. +Type your password and press Enter. Note, you will not see any characters appear as you type your password; this is a security feature. -Now youâll be prompted to complete two-factor authentication via Duo. +Now youâll be prompted to complete two-factor authentication via Duo. ``` Enter a passcode or select one of the following options: - 1. Duo Push to XXX-XXX-0000 - 2. Phone call to XXX-XXX-0000 - 3. SMS passcodes to XXX-XXX-0000 + 1. Duo Push to XXX-XXX-1234 + 2. Phone call to XXX-XXX-1234 + 3. SMS passcodes to XXX-XXX-1234 Passcode or option (1-3): ``` -Type an option number and press Enter. Do your two-factor authentication. With luck, the terminal will print a bunch of startup text, finally ending with a line like +Type an option number and press Enter. Complete your two-factor authentication. With luck, the terminal will print a series of startup text, finally ending with a line that reads ``` aphacker@scrubbing-bubbles:~$ ``` -You have now been dropped into an Athena shell. Like the terminal on your computer, you can type commands and they will execute. For example, you can type `pwd` and see +You have now been dropped into Athena! Like the terminal on your computer, you can type commands and they will execute. For example, you can type `pwd` and see ``` aphacker@scrubbing-bubbles:~$ pwd /afs/athena.mit.edu/user/a/p/aphacker ``` -**Note:** If your computer does not have `ssh`, you could also use shellinabox, an online terminal for using Athena that can be found [here](https://athena.dialup.mit.edu/). Itâs not ideal, though, as it will log you off if youâre idle for a few minutes. (Which is probably not what you want when youâre following a guide like this.) - ## Serving a website from AFS -Now that youâre in Athena, you can access the files in AFS. Right now, you are in your home directory for AFS. There are several subdirectories in your home directory, but the important one to focus on right now is `~/www`. +Now that youâre in Athena, you can access the files in MITâS AFS. Right now, you are in your home directory for MITâs AFS. There are several subdirectories in your home directory, but the important one to focus on right now is `~/www`. -Files in your `~/www` directory are available on the internet through a URL, and more specifically of the form factor `https://web.mit.edu/aphacker/www/`. If you go to that URL right now though, you wonât see anything (besides a error). We can change that by making a small web page under that directory. +Files in your `~/www` directory are available on the internet through a URL, specifically via the form factor of `https://web.mit.edu/aphacker/www/`. If you go to that URL right now though, you wonât see anything (besides an error). We can change that by populating that directory with the content that makes up a small web page. First, `cd` into the `www` directory. @@ -68,25 +80,25 @@ aphacker@scrubbing-bubbles:~$ cd www aphacker@scrubbing-bubbles:~/www$ ``` -Then, run the following command to make a file named `index.html` with a simple HTML5 template +Then, run the following command to make a file named `index.html` with a simple HTML5 template like so ``` aphacker@scrubbing-bubbles:~/www$ echo '