Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Edits made based on good suggestions from Nick Ruest

...

This will open up a console in a new window giving you command line access to the Islandora VM. Once the VM is done loading, it will prompt you for a username and password: both are ‘vagrant’. After logging in, you will be in the home directory of the running Islandora VM. You can find the VM’s Drupal instance by navigating to ‘/var/www/drupal/htdocs/’, Fedora, Solr and Tomcat are at ‘/usr/share/fedora’, ‘/usr/share/solr’ and ‘/usr/share/tomcat6’, respectively. Access the web interface by opening a browser and going to http://localhost:8181/. If you have SSH available on your local machine, you can log in to the virtual machine directly with ‘ssh -p 2222 vagrant@localhost’ and entering the password ‘vagrant’ (this is helpful if you dislike the black and white VirtualBox shell interface, or prefer to use your own terminal emulator).

Using Vagrant

If you prefer to work from the command line or your want to easily create customized virtual Islandora instances to share with the community, consider using Vagrant. Vagrant requires VirtualBox to run, so after installing VirtualBox download and install Vagrant and learn the basic commands. You can find the latest Islandora Vagrantfile and provisioning scripts at https://github.com/Islandora-Labs/islandora_vagrant; follow the instructions in the README.md file to get it up and running. Downloading and installing all Islandora’s components will take some time. Grab a coffee while you wait!

Once you have the Islandora Vagrant VM running, you will find Drupal at ‘/var/www/html/drupal’. Fedora, Solr and Tomcat are at ‘/usr/local/fedora’, ‘/usr/local/solr’ and ‘/var/lib/tomcat7’, respectively. Individual components of the Islandora stack are installed as individual with shell scripts in the repo’s scripts folder.

If you would like ; to create a your own customized instance of Islandora to share with others simply fork this repo and and/or test a specific use case, make a fork of the islandora_vagrant repo, modify the scripts and Vagrantfile to accommodate whatever customizations you require and share the new repo’s GitHub URL with others. If you make changes to a customized Islandora Vagrant repo and would like to contribute those changes back to the original author, be a good neighbor and submit them with a pull request.