I253 Presessional Informatics

2017-09-04T10:20:02Z

Sahuts: /* Fourth session: Git ja SSH keys */

==General information==

Oh no, I am not cyber warrior! No worries, just head over to [https://wiki.itcollege.ee/index.php/I253_Informatika_eelkursus Estonian translation] of the same course.

ECTS : 2
4
Grading: Test + homework

Lecturer: Lauri Võsandi with tutors Arti Zirk, Marvin Martinson, Kristjan Peterson, Taavi Teearu, Mohanad Aly

==Prerequisites and target audience==

Course aims to prepare freshmen for lectures read during fall-semester and to familiarize themselves with IT college's infrastructure. Powerusers are probably able to learn everything on the fly. It is advised to fill your voluntary subject points from other subjects.

==Course goals and content==

Topics aren't nescessarily in correct order, but to pass this course you should know following things:

* ITC technical manuals, printing, e-mail forwarding and using enos web server.
* Basics of computer hardware, so you know which computer to purchase.
* Keyboard shortcuts [https://support.microsoft.com/en-us/kb/126449 for Windows users], [https://help.ubuntu.com/community/KeyboardShortcuts for Ubuntu users] - it's a bit embarrasing if you are using mouse like a savage instead of Alt + Tab.
* Managing files [https://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/app_win_explorer.mspx?mfr=true in Windows], in Ubuntu. You know how to copy, move, delete files. Distinguish files from folders. Can switch on showing file extensions and hidden files.
* Using text editor [https://notepad-plus-plus.org/ Notepad++] in Windows, [https://wiki.gnome.org/Apps/Gedit Gedit] in Ubuntu. Use correct indentation, line breaks and charset (UTF-8).
* Using SSH to manage servers and other computers via command line (access, copy, relocate, delete, modify files) [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY] and for GUI access via SFTP [https://winscp.net WinSCP]
* Basics of version control systems, can distinguish software from service e.g. [https://git-scm.com/ Git] vs [https://github.com/ GitHub]. Knows how to add files to version control system (add-commit-push) and open ones code on GitHub.
* Basics of virtualization, can dual-boot between Windows and Ubuntu in a virtual machine and can manage doing the same to personal computer. Has heard of assigning resources to virtual machines, knows the difference between B, KiB, kB, B, MiB, MB, GiB, Gb.
* Can figure out what is connected to where inside the computer (PCI, USB, SATA).
* There will be additional bits and pieces here in the future...

==Grading==

In order to pass the course:

* Set up a web page in enos web server
* Store your homepage files in Git repository at GitHub
* Set up GitHub authentication using SSH keys
* Set up passwordless authentication between your personal computer and school servers (enos, doris) to access command-line and transfer files
* Set up software necessary to do homework in other courses eg Java 8, Intellij, Eclipse, PuTTY, Git Bash, notepad++, Atom.io, Sublime, Ubuntu, web server etc.
* Complete a test online, cybersecurity students 16:00 18. october 2016
* Gotten familiar with virtualization, has installed Windows and Ubuntu into a virtual machine in one of the labs
* [http://enos.itcollege.ee/~lvosandi/check.html Grading bot] checks your progress once an hour

==Homework==

Go through following CodeAcademy tracks:

* [https://www.codecademy.com/learn/learn-the-command-line command-line]
* [https://www.codecademy.com/learn/web HTML & CSS]
* [https://www.codecademy.com/learn/learn-git Git]

==Lectures/labs==

===First session: Introduction to Windows and personalisation of enos homepage===
In windows you can log in using user: "kylaline" and password:"kylaline". Log in with ID-card using Chrome or Firefox and reset your password [http://ois2.ttu.ee SIS]. ID-card does not work with Microsoft Edge! Write down your IT College (ITC) username, which you can find from "My Data". Log out of your guest account and try to log in using the username and password which you obtained from SIS. After that check whether you are able to log in to [http://wiki.itcollege.ee Wiki] as well as [https://mail.ttu.ee e-mail server]. When logging into outlook, username is using format "username@itcollege.ee". All necessary links can be found [http://www.itcollege.ee/ IT College homepage] top left corner.

In Windows 'This PC' should have four drives in it:

* C: - Location of running Windows. SSD - not much space, but it's fast
* D: - This is regular HDD, lots of space but slower. Virtual machines should go there in the future.
* H: - This contains everything you have in enos.itcollege.ee server, also contains public_html folder that can be accessed from a web browser using address http://enos.itcollege.ee/~username/
* U: - This is public folder, using which you can share files with one-another. Only for public content - no pirates allowed.

Create a file called index.html onto H: drive into public_html folder. Create content that introduces you - Who are you? Where are you from? Add a picture. Example can be found [http://enos.itcollege.ee/~arzirk/ here].
To create index.html get yourself a decent text editor. For example [https://notepad-plus-plus.org/download/v6.9.2.html Notepad++], choose portable version in .zip file, because you have no rights to install software to the system.
Microsoft word is for word processing. It IS NOT a text editor.
Notepad++ should be installed during next week.
Since you have no previous knowledge of HTML, don't worry, that's why you are here. You will have a course explaining everything regarding web application development in spring semester.

For now, you can use following code to make yourself an introductive web page:
<source lang="html5">
<html>
<head>
<meta charset="utf-8"/>
</head>
<body>
<p>Hey, I'm Lauri from Tallinn, Estonia</p>

<img src="https://d1qb2nb5cznatu.cloudfront.net/users/18344-large?1405448591"/>
<img src="//d1qb2nb5cznatu.cloudfront.net/users/18344-large?1405448591"/>


<img src="http://enos.itcollege.ee/~lvosandi/pics/lauri.jpeg"/>
<img src="//enos.itcollege.ee/~lvosandi/pics/lauri.jpeg"/>
<img src="/~lvosandi/pics/lauri.jpeg"/>
<img src="pics/lauri.jpeg"/>


<img src="/home/lvosandi/public_html/pics/lauri.jpeg"/>
<img src="H:\public_html\pics\lauri.jpeg"/>
<img src="pics\lauri.jpeg"/>
</body>
</html>
</source>

If you have done all of the above, try to access files on enos server using FileZilla. FileZilla is preinstalled in Windows. You can also install it to your personal computer or use WinSCP. If you want to mount your private folder as it has been mounted on Windows workstations you can use [http://www.swish-sftp.org/ Swish].

Connecting FileZilla:
* hostname: enos.itcollege.ee
* username: <your-SIS-username>
* password: <your-SIS-password>
* port: 22

Make sure you can access your folder, try to upload/download files-

To access the command line from Windows you can use [https://the.earth.li/~sgtatham/putty/latest/x86/putty.exe PuTTY]. Use [https://the.earth.li/~sgtatham/putty/latest/x86/puttygen.exe PuTTYgen] to generate public/private key pair, make sure you save the private file in a file. Log in to server using PuTTY, type your username after "log in as:" then enter the password. Copy the public key from PuTTYgen window, run <code>cat >> .ssh/authorized_keys</code>, paste the public key, hit Enter to add newline and hit Ctrl-D twice to end the input.

To select generated key in PuTTY select on the left hand panel Connection -> SSH -> Auth -> Privater key file for authentication and click Browse... to select the generated file. Also set the username under Connection -> Data -> Auto-login username. Finally save these configuration changes by going back to Session section, selecting Default Settings and hitting Save.

===Second session: Introduction to Ubuntu and creating virtual machines===

Boot your computer to Ubuntu, if computer is in Windows restart it and while in dualboot menu select Ubuntu (NOT advanced option). You should be able to log in with the same username and password as in SIS, Outlook and Windows environment. In case of emergency keep calm and use username: "student" and password: "student" In that case drive H: will not be attached and you have no access to your files in school server.

In Ubuntu, your home folder will be at /home/username. There are no drives C:, D: or H:, because all those rescources will be attached to folders. Drive H: familiar from Windows will be accessable in folder /home/username/Dokumendid and drive U: will be at /home/username/Avalik and D: can be found at /shared .

To open terminal use Ctrl + Alt + T

Some commands cherry-picked from last years I600 course:

* Use <code>lsb_release -a</code> command to see what exact linux version are you running
* Use <code>uname -sr</code> command to see what kernel version is your computer running
* Use <code>cat /proc/cpuinfo</code> command to see everything there is to know about the processor your computer is running on. What's the model and how many cores does it have?
* Use <code>arch</code> to see whether running configuration is 32- or 64 bit
* Use <code>cat /proc/meminfo</code> command to see memory information. How much RAM does your computer have?
* Use <code>lspci -t -v -nn</code> command to see which PCI and PCI Express devices are connected. Try to understand what is where.
* Use <code>lsusb</code> and <code>lsusb -t</code> command to show all USB devices. Try to understand what is where.
* Use <code>lsblk</code> command to show all drives, how much capacity does your computer's HDD/SSD have?
* Use <code>xrandr</code> command to list all video output connectors. Which resolutions are available, which one is in use?
* Use <code>cat /proc/asound/cards</code> command to list all audio devices.
* Use <code>dmidecode</code> to get more information about your computer. For example which frequency is your RAM running on and which socket are they using? In case you need to shop for more RAM. The cheapest upgrade possible for a computer.
* Use <code>ifconfig -a</code> or <code>ip addr list</code> commands to list network adapter settings
* Use <code>htop</code> command to list all processes

Download Windows 10 ISO and install it to a virtual machine created with VirtualBox. Assign 8GB of RAM and 100 GB of HDD which is located under /shared. Otherwise SSD will be filled. Download Ubuntu MATE 16.04 ISO and install it to the same virtual machine. During installation choose "Install alongside Windows". If no such option was presented, Windows in the virtual machine was not correctly shut down. If Ubuntu should freeze while booting try to assign more cores to the virtual machine, that model of the processor does not exist with a single core.

===Third session: Hello world in different programming languages===

Try to create "Hello, World!" in different programming languages using Ubuntu.
Try to add functionality to the program. Add asking name and let the program greet user using inserted name.
Why is running programs so different in different languages?
Name strenghts and weaknesses of used programming languages?
Restart your computer, boot into Windows and try to do the same in Visual Studio using C#.

====Python====
Open <code>gedit</code> text editor, and save the following content into file <code>hello.py</code>.

<source lang="python">
#!/usr/bin/env python
print "Tere maailm"
</source>

Open command line Ctrl + Alt + T and run file you just saved:

<source lang="bash">
python hello.py
</source>

====Ruby====

Create file <code>hello.rb</code>:

<source lang="ruby">
#!/usr/bin/env ruby
puts "Hello, world!"
</source>

Run the program on the command line:

<source lang="bash">
ruby hello.rb
</source>

====Bash====
Create file <code>hello.sh</code>:

<source lang="bash">
#!/bin/bash
echo "Hello, world!"
</source>

Run program on command line:

<source lang="bash">
bash hello.sh
</source>

====C====
Create file <code>hello.c</code>:

<source lang="c">

#include <stdio.h>
void main() {
printf("Hello, world!\n");
}
</source>

Compile program on the command line:

<source lang="bash">
gcc hello.c -o hello
</source>

Run program in file hello:
<source lang="bash">
./hello
</source>

====Java====
Create file <code>HelloWorld.java</code>:

<source lang="java">
class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello World!");
}
}
</source>

Compile on command line:

<source lang="bash">
javac HelloWorld.java
</source>

Run compiled Java bytecode in file <code>HelloWorld.class</code>

<source lang="bash">
java HelloWorld
</source>

===Fourth session: Git and SSH keys===

This time we'll take a look how Git works and how to set up public key authentication between your personal computer, GitHub and enos.

Proceed to do the development portion of your homepage on your computer:

* If necessary install Git on your Ubuntu box: <code>apt install git tig gitg</code>, Windows users can check out [https://git-for-windows.github.io/ Git Bash]
* Register account at GitHub
* Create a repository for your homepage at GitHub
* Set up SSH authentication between your own computer and GitHub server using <code>ssh-keygen -t ecdsa -P ""</code>, dump public key on the terminal using <code>cat ~/.ssh/id_ecdsa.pub</code> and paste it to GitHub web page (Settings -> SSH and GPG keys), detailed instructions [https://help.github.com/articles/generating-an-ssh-key/ here]
* Clone the repository to your computer using <code>git clone git@github.com:username/repo.git</code>, <code>cd repo</code>
* Add files to newly created directory, eg index.html and some images
* Tell Git to keep track of the files <code>git add index.html</code>
* Configure your full name for Git commits: <code>git config --global user.name "Lauri Võsandi"</code>
* Configure your e-mail for Git commits: <code>git config --global user.email lauri.vosandi@gmail.com</code>
* Make your first commit using <code>git commit</code>, Git asks for the description, this should answer to question "what was added/changed/deleted?"
* Publish your changes using <code>git push</code>

Now proceed to do the administration portion on enos.itcollege.ee by setting up your homepage there so it is connected to the Git repository

* Set up SSH public key authentication between your computer and enos.itcollege.ee using <code>ssh-copy-id username@enos.itcollege.ee</code>
* Set up public key authentication between your account on enos.itcollege.ee and GitHub, the same way you did for your computer above.
* Move the old webpage with: <code>mv ~/public_html ~/homepage_backup</code>
* Clone the repository to enos: <code>git clone https://github.com/username/repo/ ~/public_html</code>
* Check that your homepage is back up and running by going to http://enos.itcollege.ee/~school-user-account

Now after all the stuff has been set up, the daily development cycle looks like this:

* In your development machine edit files, use <code>git add filename</code> to tell Git to remember these changes, make a commit using <code>git commit</code> and publish changes using <code>git push</code>
* In your production environment, that is the enos server you just do <code>git pull</code>

Get on the track with Git, manual isn't very helpful. Instead try to follow some [http://rogerdudler.github.io/git-guide/ Git for newbies] guide.

Git should track *only* source code files, any kind of temporary/compiled/generated garbage does not belong to Git repo. Use <code>.gitignore</code> file to tell Git to ignore such files:

<source lang="ini">
# Text editor backup files
*~
*.swp
*.bak
*.tmp

# Java project
build/
*.class

# Python project
*.pyc

# C/C++ project
*.so
*.o
</source>

Do not just copy-paste the whole thing, consider what kind of project you're working on.

===Fifth session: Importing virtual appliances===

There is a lot of software available as virtual appliances (*.ova files). This means that a piece of software has been packaged as a virtual machine harddisk image plus the accompanying metadata which includes network configuration etc.
Many lecturers as well provide a *.ova file to work on the labs.

In this example we'll download a Ubuntu server virtual appliance from http://upload.itcollege.ee/ova/lamp.ova
to practice more with playing around with SSH and accessing resources on a server.

Before importing it to VirtualBox create a host-only adapter in VirtualBox by clicking Preferences in the VirtualBox main windows' menu:

[[File:Add-host-adapter.png]]

From VirtualBox's main windows' menu select Import Appliance ... and point to the file you just downloaded.

Start the virtual machine and once it has booted up try to:

* In web browser open up http://192.168.56.101
* Try to access MySQL server web interface, username root, password student: http://192.168.56.101/phpmyadmin
* Try to log in: <code>ssh student@192.168.56.101</code>
* Change the password of user student: <code>passwd</code>
* Change the password of MySQL administrator
* Try to access files via sftp://student@192.168.56.101
* Make the web server files editable by user student with: <code>sudo chown student -R /var/www/html</code>

For practice try to set up your homepage in the virtual machine as we did on enos.itcollege.ee

If you didn't change the password then [https://www.youtube.com/watch?v=PivpCKEiQOQ think again], many virtual machines ship with default passwords that can allow hackers to get in. Be careful when downloading stuff off the internet, virtual machines downloaded from arbitrary websites might have malware bundled with them.

===Sixth session: Keyboard shortcuts===

Unplug the mouse from your computer and deal with it. [[Keyboard shortcuts]] are on a separate page.

ICO wiki - User contributions [en]

I253 Presessional Informatics