Common Tasks

• Start the VM if it's not running

  1. Open a new terminal window
  2. Change directory to the directory with your Vagrantfile in it
  3. Type vagrant up

• Connect to the VM

  1. Type vagrant ssh from the directory with your Vagrantfile in it

• Editing files

  1. This tutorial assumes that you run the examples within your virtual machine from the /vagrant/ohsu2018 directory
  2. The entire /vagrant directory in your virtual machine (guest) is shared to your laptop (host), so you can use your favorite editor or IDE to edit files easily at path-you-copied-to-on-your-host-system/vagrant/ohsu2018
  3. Inside the guest machine, you can also use linux editors like vim and nano to edit files.

• Start a rails console

  1. Make sure you're connected to the VM
  2. Type cd /vagrant/ohsu2018 to change directory to the root of your rails application
  3. Type rails console to enter the console (or rails c for shorthand)
  4. Type exit when you're done to return to the command line

• Start solr, fedora, and web servers

  1. You'll generally want to open a separate terminal and connect to a new ssh session where you can leave the servers running
  2. Type cd /vagrant/ohsu2018 to change directory to the root of your rails application
  3. Type rails hydra:server to start Solr, Fedora, and the Web server

• Fix Solr if you get an error like "ERROR: Core 'hydra-test' already exists!"

  1. Clear the test solr instance using rm -rf tmp/solr-development/server/solr/hydra-test
  2. Try bundle exec rake ci again and things should work; if not, ask for help.

• Wipe everything out and start over

  1. On your host system, open a terminal window and switch to your vagrant directory
     cd [path-on-your-local-system]/vagrant
  2. Kill the Vagrant virtual machine vagrant destroy - answer 'y' when prompted
  3. OPTIONAL WITH FIRE
     Remove the base virtual machine
     vagrant box remove --all camper
  4. Follow the Initial Vagrant Setup instructions again