Preliminary.md

Initial setup: to be done by Aug 24

1. GitHub

   • Learn about git and github

   • Make sure

   • Sign up for GitHub if not already signed up. Pick default (free plan).

   • Create ssh key

        - Do steps 1, 2, 4, and 5
        - Do Not Share Your Private Key in id_rsa
     

   • set up git

   • Make sure you can go over the basic git tutorial

   • Fork and create a pull request on students repository so I can add you to the to the GitHub group for the course.

        - Start by [**forking** the students repository](https://github.com/fdac18/students)
        - Add your utk net id as NETID.md (click on '+' - add 
           new file next to the https//github.com/fdac18/students/+ link)
        - Add your UTK netid and publickey key (in id_rsa.pub) to
           NETID.key
        - Click on Create Pull Request (do not create NETID.md, but replace NETID by your netid in all lowercase)
     

2. Familiarize yourself with GitHub workflow
   • Go through workflow below

Typical workflow

1. To start, fork the repository for the test project (found under github.com/fdac18)
2. Clone the repository to your computer.
3. View, create, and edit your files
4. commit changes to complete your solution.
5. Push/sync the changes up to GitHub.
6. Create a pull request on the original repository

Feedback will be given in the pull request, so please respond with your thoughts and questions! You are welcome to open the pull request as the work is still in-progress if you are stuck and want to ask a question – just mention @audris with the question to make sure I know to look at it sooner.

Initial setup: to be done by Aug 27 on or after Aug 24

Configuring ssh

• On linux/mac either

  • create .ssh/config

    1. create ~/.ssh/config

     host da2
        hostname da2.eecs.utk.edu
        port YOURPORT #from students/ports.md
        user YOURNETID
        LocalForward 8888 127.0.0.1:8888
        IdentityFile ~/.ssh/id_rsa
        StrictHostKeyChecking no
        UserKnownHostsFile /dev/null
    

    1. place your private key in ~/.ssh/id_rsa
    2. Make sure permissions are right

     chmod -R og-rwx ~/.ssh
    

    1. ssh da2

  • Or ssh directly

     ssh -pYOURPORT -L8888:localhost:8888 -i ~/.ssh/id_rsa [email protected]
    

• Putty is a common ssh client for windows

• Instructions on how to generate ssh key running windows

  1. Also see this issue (thanks @mkramer6)

  2. Save the private key and use it in your putty ssh session

  3. Copy the public key (highlited in the image) to add to the list.txt

  4. Now work on creating and saving session: start putty and go to connection/ssh/tunnels, enter source and destination and click add

  5. 

  6. Go to go to connection/ssh/Auth and browse for your private key

  7. 

  8. Go to go to session enter hostname and YOUR PORT from ports.md in fdac/students

  9. 

  10. Don't forget to save the session before clicking open