Warning: This page has not been updated in over over a year and may be outdated or deprecated.
installation:vagrant
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
vufind2:vagrant [2014/07/11 12:08] – demiankatz | installation:vagrant [2024/02/08 18:23] (current) – [Getting Started] demiankatz | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Vagrant ====== | ====== Vagrant ====== | ||
- | [[http:// | + | [[http:// |
+ | |||
+ | ===== Getting Started ===== | ||
+ | |||
+ | The software ships with a default [[https:// | ||
+ | |||
+ | ==== Setting Up the Virtual Machine ==== | ||
+ | |||
+ | To get started, make sure that [[http:// | ||
+ | |||
+ | vagrant up | ||
+ | |||
+ | This will take quite some time to install and set up everything. Once the installation completes, VuFind®' | ||
+ | |||
+ | You will have to do a bit of manual work to get everything running.... | ||
+ | |||
+ | === Completing the Installation === | ||
+ | |||
+ | Access the web-based installation process at < | ||
+ | |||
+ | === Managing Solr and Indexing Records === | ||
+ | |||
+ | To log into the virtual machine to run commands, you can execute: | ||
+ | |||
+ | vagrant ssh | ||
+ | |||
+ | You will need to run: | ||
+ | |||
+ | cd $VUFIND_HOME; | ||
+ | |||
+ | to get Solr running for the first time. You can then use the standard ./ | ||
+ | |||
+ | If you want to view Solr in a web browser on your host machine, it should be port-mapped to port 4568, so you can view the admin at < | ||
+ | |||
+ | == Notes for Windows Users == | ||
+ | |||
+ | :!: For Windows users, the '' | ||
+ | |||
+ | :!: Windows users may also encounter errors about the inability to create symbolic links (especially when indexing MARC records). This problem is caused by permission issues related to symlink creation and can be worked around by running Vagrant from a command prompt with administrative rights. If you continue to have problems after correcting permissions, | ||
+ | ==== Notes on File Mapping / Locations ==== | ||
+ | |||
+ | Your host machine' | ||
+ | |||
+ | Because Apache does not have write access to the special mounted /vagrant directory, the system is using / | ||
+ | |||
+ | ==== Managing the Virtual Machine ==== | ||
+ | |||
+ | Once everything is set up, you can issue a few commands to control the VM: | ||
+ | |||
+ | * vagrant suspend - save the current state of the VM, but stop it from running until you issue " | ||
+ | * vagrant halt - shut down the VM; it will boot back up the next time you issue " | ||
+ | * vagrant destroy - completely destroy the VM; you will have to reinstall it (see above) if you want it back. | ||
- | Mark A. Duffy has contributed a VuFind 2.x Vagrant configuration [[https:// | ||
---- struct data ---- | ---- struct data ---- | ||
+ | properties.Page Owner : | ||
---- | ---- | ||
installation/vagrant.1405080505.txt.gz · Last modified: 2014/07/11 12:08 by demiankatz