GOAL

An easy solution for users to login to Fermi kerberized computers via ssh.
Solution uses Vagrant to provision a VirtualBox VM that provides kerberized ssh.

-------------------------------------------------------------------------------


# fermi-kerberized-ssh

This repository has a "Vagrantfile" for building an equivalent to SLF6 as a Virtual Machine suitable for access to Fermi kerberized computers via ssh. 

## Features

Installed with this VM are:

   openssh 
   kerberos config file for Fermi 

## Main Installation of base products

Note that the installation requires some downloads from Fermi and other sites.

0)   Tested Vagrant vs VirtualBox Version Matrix 

     Host OS 	   Vagrant   VirtualBox   Status
     -------   	   -------   ----------	  ------
     SL 6	    1.8.7	5.1.8	  Works
     SL 7           1.8.7 	5.1.8	  Works
     MAC 10.10.5    1.8.7 	5.1.8	  Works
     Windows 7      1.8.7	5.1.8	  Works
     Windows 10     1.8.7 	5.1.8     Works
     Ubuntu 16.04   1.8.7	5.1.8	  Probably Works
     Ubuntu 16.04   1.8.4	5.0.24	  Works
    
1)
  Download and install Vagrant from https://www.vagrantup.com/downloads.html

2)

  Download and install VirtualBox from http://www.virtualbox.org/
  Download and install VirtualBox extentions from http://www.virtualbox.org/

         Mac may need "parallels" stopped before VirtualBox will start.

3)

  Suggest that you make a directory for just this Vagrant install

     mkdir "someplace you like" or equivalent for Windows    
     cd "someplace you like"    or equivalent for Windows

4)
  
  Download the customized "fermi-kerberized-ssh" Vagrant config file from

   http://sldist.fnal.gov/linux/fermi/contrib/vagrant/fermi-kerberized-ssh/Vagrantfile  
   
  Make sure the Vagrantfile downloaded is in the directory you made earlier .

5)

## Provision Virtual box using Vagrant via the "command line"

  Provisioning means to install and configure the VM to make it usable for 
  what you want to do.

  The following will bring up the VM so as to provision it (it may take many minutes to run)

  This will update to latest versions of packages.  
  Add/Update Virtual Box Guest Additons.  
  Turn off not needed network services.  
  Kerberize ssh for use at Fermilab.

     'vagrant up'

  The virtual machine has now been provisioned. 

6)

## LOGIN 

  TO LOGIN 

   `vagrant ssh` to log in via text mode.
   kinit "your kerberos principal"
   ssh <your kerberos principal>@<fermi kerberized computer running sshd that you have access to>

  or  for Windows users

   Start up your VirtualBox App (the GUI). 
   Locate your new VM (called `fermi-kerberized-ssh` ) and start it.  
   Login with user 'vagrant' and password 'vagrant' 

7)

  TO SHUTDOWN


     Exit from the "vagrant ssh" with "exit"

    On your VM host computer

       vagrant halt

    To start up again 

       vagrant up
       vagrant ssh

     or

       Start Virtual box gui and start "fermi-kerberized-ssh"