This repository contains code and instructions to set up a local blank copy of the EWA website on a desktop computer

Steps:

1. Download and install Virtualbox, Vagrant, and git.

• IMPORTANT: On Windows, during the installation of Git, a screen will appear asking you to configure line ending conversions, choose the second option, Checkout as-is, commit Unix-style line endings. There is a screenshot within the root of this repository.

2. Open the command prompt/console/terminal. If using Windows, the command prompt needs to be 'run as administrator'. Instructions for this can be found online and will vary according to the version of Windows being used.

3. Install vagrant-hostsupdater plugin by running vagrant plugin install vagrant-hostsupdater.

4. Choose a location on your machine and clone the repository: git clone https://github.com/ox-it/ewa. Git will automatically checkout the repository to a new ewa folder.

5. Copy ewa/puppet/hieradata/ewa.vm.yaml.dist to ewa/puppet/hieradata/ewa.vm.yaml. Open this file for editing, go to the bottom and insert the provided credentials in ewa::svn::username: and ewa::svn::password: (Please ensure there is a space between the name and the value, i.e. ewa::svn::username: myusername instead of ewa::svn::username:myusername)

6. cd into the ewa/vagrant directory.

7. Run the following command: git submodule update --init --recursive

8. Copy Vagrantfile.dist to Vagrantfile

9. Enter the command vagrant up. Wait a few minutes for the provisioning process to complete.

10. Navigate to ewa.vm in your web browser.

11. Database access is available at http://ewa.vm/phpmyadmin. The username is ewa and the password is password

12. To shut the virtual machine down, run vagrant halt

Steps:

1. Copy the contents of the puppet directory to /etc/puppet on the server
2. cd into /etc/puppet, make the install_puppet.sh script executable and run it as root or via sudo: sudo ./install_puppet.sh
3. Copy /etc/puppet/hieradata/ewa-dev.oucs.ox.ac.uk.yaml.dist to a file that reflects the actual hostname of the machine, for example my-ewa-dev.co.uk.yaml, open the file for editing and populate the security credentials at the bottom
4. cd into /etc/puppet and run sudo puppet apply manifests/site.pp. Wait a few minutes for the process to complete.
5. Navigate to http://DOMAIN_NAME/ in your web browser.
6. Database access is available at http://DOMAIN_NAME/phpmyadmin. The credentials are in the hieradata/yaml file