README.md

   1 # README #
   2
   3 Repo for installing & running prebuilt distribution of TM351 (production) D2 VM:
   4
   5 * vagrant files etc
   6
   7 This is the package intended for distribution to students.
   8
   9 ## Usage
  10
  11 Install Virtualbox.
  12 Install vagrant.
  13
  14 To launch the virtual machine:
  15
  16 `vagrant up`
  17
  18 in the directory containing the Vagrantfile. Wait until the process finishes; this can take quite a long time on the first run, but is usually quicker subsequently.
  19
  20 You should be able to go to:
  21
  22 * `http://127.0.0.1:8888` to see the notebooks
  23 * `http://127.0.0.1:3334` to see the OpenRefine
  24 * `http://127.0.0.1:3000` to see an ssh client
  25
  26 If the services don't seem to be running:
  27
  28 `vagrant provision`
  29
  30 To see a full list of vagrant commands:
  31
  32 `vagrant`
  33
  34 To power down the virtual machine:
  35
  36 `vagrant suspend` or `vagrant halt`
  37
  38 in the directory containing the Vagrantfile. Then use `vagrant up` again to restart.