Sufia-vagrant is a turnkey Hydra-based repository application that builds atop Sufia, providing self-deposit functionality and more. It runs in a virtual machine powered by Vagrant and VirtualBox.
First install all of the dependencies (Git, VirtualBox, Vagrant), then run sufia-vagrant.
To grab a copy of sufia-vagrant, which is hosted on github.com, you'll need git, the distributed version control system. Here are instructions on installing git.
You will also need VirtualBox installed to run the virtual machine that runs sufia-vagrant. Download packages and installation instructions can be found at https://www.virtualbox.org/wiki/Downloads.
If you don't have Vagrant installed, here's how to remedy that:
- Windows: follow the installation instructions on Vagrant's downloads page.
- Mac: With homebrew
brew tap phinze/cask; brew install brew-cask; brew cask install vagrantor follow the installation instructions on Vagrant's downloads page. - Linux: use your favorite package manager to install packages for vagrant.
Pull down a copy of sufia-vagrant and change into its directory:
$ git clone https://github.com/projecthydra-labs/sufia-vagrant
$ cd sufia-vagrantFire up sufia-vagrant:
vagrant up
vagrant upwill take some time to complete the first time you launch it -- no, really, maybe grab a cup of coffee and wait for this to complete! This step downloads the vagrant box, installs system packages, downloads and installs FITS for file characterization, installs the Ruby dependencies, builds a relational database, and starts Fedora Commons, Solr, and Redis.
Finally, browse to http://localhost:3000 and you should see the Sufia homepage, at which point you can sign up for an account, upload some files, and cruise around..
Note: It may take a few moments for the included Fedora Commons and Solr instances to come online. If you see Connection refused - Unable to connect to Solr instance, wait a few moments and reload the page.
That's it! Enjoy!
When you are done, you can shut down sufia-vagrant with:
vagrant haltIf you'd like to set up your own environment (e.g., on a development server), see the commands in the Vagrantfile as guidance or get in touch with the Hydra development community.
There are numerous ways to get help. You can reach the folks who work on Hydra and sufia-vagrant here:
- hydra-tech Google Group
- sufia-vagrant GitHub repository
- #projecthydra IRC channel
You now have a working sandbox to try out Hydra and Sufia, and a perfectly good development environment to boot. Here's how to dig deeper. Start by connecting to the virtual machine and changing into the directory that contains the sufia-vagrant code:
vagrant ssh
cd /vagrantOnce you're connected, you can type exit to get out.
Interested in making sufia-vagrant better? See our instructions for contributing.