README.md

# Linux Basics 101 and GitLab R3 Workshop

## How to connect to a remote Session
***

### 1. My terminal is better than yours?

> Definition: A terminal is an interface in which you can type and execute text based commands.

#### Download your Terminal if you don't have one already.


+ Windows
  + PuTTy (use Windows installer) [download](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html)
  + MobaXterm [download](http://mobaxterm.mobatek.net/download-home-edition.html)
+ Mac
  + iTerm2 [download](https://www.iterm2.com/downloads.html)
  + Terminal
+ Linux
  + Terminal


### 2. Generate your SSH key

#### Background information

+ What is SSH?
* What is a SSH key pair?

#### Key generation

+ Windows
  + PuTTyGEN [follow tutorial](https://hpc.uni.lu/users/docs/access.html#ssh-key-generation-on-windows)
+ Mac / Linux
  + ssh-keygen

        ```bash
        vagrant@vagrant-ubuntu-trusty-64:~$ ssh-keygen
        Generating public/private rsa key pair.
        Enter file in which to save the key (/home/vagrant/.ssh/id_rsa):
        Enter passphrase (empty for no passphrase):
        Enter same passphrase again:
        Your identification has been saved in /home/vagrant/.ssh/id_rsa.
        Your public key has been saved in /home/vagrant/.ssh/id_rsa.pub.
        The key fingerprint is:
        ac:d7:36:ee:74:f6:34:d1:ff:ee:dd:bc:d5:ee:70:36 vagrant@vagrant-ubuntu-trusty-64
        The key\'s randomart image is:
        +--[ RSA 2048]----+
        |                 |
        |                 |
        |                 |
        |       .       . |
        |        S     . .|
        |       . .     .o|
        |      . . = o +E*|
        |       . + + o B*|
        |         .o   .=@|
        +-----------------+
        ```

### 3. Create LUMS account

This task has been done already by your awesome R3 team.


### 4. Add SSH key to LUMS (**L**CSB **U**ser **M**anagement **S**ystem)

1. Attach SSH key to your LUMS account
2. Go to https://lcsb-ipa.uni.lu
3. Login with first.lastname and password linuxwork2015

    > (Note: Use your password for existing LUMS account)

### 5. Connecting to Virtual Machine

* Windows

  Enter the details into PuTTy

  <img src="images/screen1.png" width=400>

  Don't forget to add your SSH key

  <img src="images/screen2.png" width=400>

* Linux
  * Open your terminal
  * Connect to the workshop virtual machine

        ```bash
        ssh {first}.{lastname}@10.79.2.191 -p 8022
        ```

## Discover your surroundings
***
* In which folder am I? (Hint: pwd)
* What is the contents of the current folder? (Hint: ls)
* Creating my first file (Hint: touch)
* Creating my first folder (Hint: mkdir)
* How do I enter my folder? (Hint: cd)
* Moving my first file to the new folder (Hint: mv)
* Copying **** (Hint: cp)

## Learn more about any *nix command
***
* Go to your home folder (Hint: cd <no arguments>)
* Are there any hidden files in my home folder? (Hint: man ls)
* How do I get such nice documentation for other unix commands? (Hint: man <mycommand>)

## Copy files to the VM or from the VM (only using console!!)
***
* Logout of the VM (Hint: logout)
* Go to training folder (./linux-training) (Hint: cd)
* Copy file1.txt to “my first folder” on the VM (Hint: scp –P 8022 first.lastname@1079.2.191:/myfirstfolder/)

## Start a simple program:
***
* Intro to command, parameters
* How to zip my folder? Unzip?
* wget -> untar -> changes -> re-pack

## Text editor
***
* nano [Tutorial](http://www.howtogeek.com/howto/42980/the-beginners-guide-to-nano-the-linux-command-line-text-editor/)
* Others, like vim, emacs, Atom, Sublime, etc…

## File System explore
***
### Midnight Commander `mc`
* [Tutorial](http://linuxcommand.org/lc3_adv_mc.php)
* if function keys do not work, use `Esc`+`1` for `F1`, `Esc`+`2` for `F2`, ..., `Esc`+`9` for `F9` and `Esc`+`0` for `F10`
* if you do not have an `Insert` key (e.g. on Apple keyboards) use `Ctrl`+`t` for (un-)selecting files and folders

## Scripts – bash
***
* Simple `bash` scripting [Tutotial](http://linuxconfig.org/bash-scripting-tutorial)

## Basic git (source control)
***
* add
* commit
* push
* pull