<<Anchor(top|scroll to the top of the page)>>
= First login =
<<TableOfContents(2)>>

New users, Welcome!!!

Now you have got an account on the MIB system, you should make sure that everything works fine for you.

In here you will find information about how to log into our servers from MIB and outside MIB (home,...)


== How to log in to the MIB system ==

We use the SSH protocol to login to our machines systems, the authentication relies on a '''global''' MIB authentication server.
 service/protocol:: ssh
 host name:: potato.wurnet.nl

== Requirements ==

* You need to be on WUR network, either by using WUR VPN or by using the workstations in Helix building.

* Unix terminal, for windows putty or '''mobaXterm''' can do the job

* An account on the server [[Request an account]]

=== Using Windows ===

Several software can be used to make a ssh connection, we recommend to use ''MobaXterm'' as it comes with a friendly user interface. Follow this link to download [[https://mobaxterm.mobatek.net/download-home-edition.html|MobaXterm|target="_blank"]]. For this tutorial we use the portable version.

{{attachment:mobaXterm-download.PNG}}

{{{
# Open MobaXterm
# Click on '''Start Local Terminal'''
}}}

{{attachment:mobaXterm-open.PNG}}

{{{
# When the terminal opens, '''take the time to read the prompted message'''
# Log in to potato with the following command, (replace <your_username> with your username)
ssh <your_username>@potato
}}}

{{attachment:mobaXterm-normal-login.PNG}}

We recommend setting up ssh keys for more security, this is how to do so, (this step is Optional)

{{{
# Run the following commands one by one and make sure no error message is prompted
# The next command makes a folder, where the key will be created feel free to adapt it
mkdir -p //WURNET.NL/Homes/homa001/AppData2/mobaxterm/ssh/

# The next command creates ssh key files in the designated path 
# You will be asked to enter a passphrase which you will need everytime you log in using that key file.
# Be carefull as the passphrase does not replace your password
ssh-keygen -t rsa -b 4096 -f //WURNET.NL/Homes/homa001/AppData2/mobaxterm/ssh/potato.wur

# The next step is to copy the public file on the server so that it accepts your key, (replace <your_username> with your username)
ssh-copy-id -i //WURNET.NL/Homes/homa001/AppData2/mobaxterm/ssh/potato.wur <your_username>@potato
}}}

{{attachment:mobaXterm-keygen.PNG}}

Create a new session to avoid typing the ssh command everytime, here is how to do it.
{{{
# On the top menu, click on the button '''Session''' to open the session settings
# Then choose '''SSH'''
# In the '''Basic SSH settings''' tab fill
# Remote Host: potato
# Tick the box '''Specify Username''' and replace all the text in the text box with your username

# Optional but recommended
# Then click on '''Bookmark settings'''
# Tick the box '''Customize Tab Color''' and select a uniq color for that session
# Set a suitable session name

# If you are using a private key
# Then click on '''Advanced SSH settings'''
# Tick the box '''Use private key''' and specify the path to your private key (//WURNET.NL/Homes/homa001/AppData2/mobaxterm/ssh/potato.wur)
# Click '''OK''' to save the session and try loging in

# If you log in using a ssh key you should see a similar prompt to '''Passphrase for OPENSSH private key'''
# Otherwise use your password
}}}

{{attachment:mobaXterm-session-advanced.PNG}}

{{attachment:mobaXterm-session-bookmark.PNG}}

{{attachment:mobaXterm-login-sshkey.PNG}}

=== Using Mac OS ===

Make sure you have access to a terminal and install the software XQuartz to be able to open graphical windows.
You need to set up the VPN to able to login outside WUR environment.

=== TO LOG IN ===

Enter the following command in a terminal to start the login process.

Replace '''<your_username>''' with the username you have chosen.

{{{
ssh <your_username>@potato.wurnet.nl
}}}

OR to enable X server,

{{{
ssh -Y <your_username>@potato.wurnet.nl
}}}

When connecting to the system for the first time, SSH will ask you to confirm your wish to login to the machine. Enter yes. Then you will be asked for a password every time you log in.
We recommend setting up a ssh key to secure your connection the server, see below.

=== To change your password ===

After loging in use the command ```passwd``` to change your password.

=== TO LOG OUT ===

Choose one of the following commands to log out.

{{{
exit
#OR
logout
}}}


== Quick links ==

 1. [[Computers description]]
 2. [[Request an account]]
 3. [[storage description]]
 4. [[First login]]
 5. [[Receiving sequencing data]]
 6. [[transferring data]]
 7. [[Submitting jobs]]
 8. [[Monitor jobs]]
 9. [[Install tools]]
 10. [[Space management]]

[[#top]]