Preliminary.md

Initial setup

1. GitHub

   • 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
     

   • 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/fdac19/students)
        - Add your utk net id as NETID.md (click on '+' - add 
           new file next to the https//github.com/fdac19/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
   • Walk through workflow

Typical workflow

1. To start, fork the repository for the test project (found under github.com/fdac19)
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 da0
        hostname da0.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 da0

  • Or ssh directly

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

• Windows 10 has ubuntu subsystem: use that please https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_overview

• Putty is an ssh client for earlier versions of windows, please avoid if you have Win10 or later

• 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 yournetid.key

  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