# fermi-kerberized-ssh

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

## Features

Installed with this VM are:

   openssh 
   kerberos configfiles for Fermi 

## Main Installation of base products

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

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

Download and install Vagrant from https://www.vagrantup.com/downloads.html

NOTE NOTE NOTE
NOTE NOTE NOTE

     You need version 1.8.4 of Vagrant as there is a BUG in 1.8.5 .

NOTE NOTE NOTE
NOTE NOTE NOTE

Suggest that you make a directory for just this Vagrant install

   mkdir "someplace you like"    
   cd "someplace you like"
  
Download the customized "fermi-kerberized-ssh" Vagrant config file from

   ftp://sldist.fnal.gov/linux/fermi/contrib/vagrant/fermi-kerberized-ssh/Vagrantfile  

## Provision Virtual box using Vagrant

Provisioning means to install and configure the VM to make it usable for what you want to do.  In this case it is to be able to use "ssh" to login to Fermi Kerberized computers. 

Bring up the VM with provisioning (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.

     vagrant up

The virtual machine is now ready. 

TO LOGIN 

 `vagrant ssh` to log in for text mode.
 kinit "your kerberos principal"
 ssh <your kerberos principal>@<some fermi kerberized computer running sshd>

or  for Windows users

 Start up your VirtualBox App (the GUI). Locate your new VM (called `fermi-kerberized-ssh` ). 

TO SHUTDOWN


     Exit from the "vagrant ssh" with "exit"

  On your host computer

     vagrant halt

  To start up again 

     vagrant up
     vagrant ssh
     or
     Start Virtual box gui