<commit_before>
# EPrints v3.3.15 Install Notes

This vagrant file setups up Ubuntu 14.04 LTS because that is the last one that
has clear install instructions for EPrints v3.3.15. When testing Ubuntu 16.04
problems were not resolved by the linked version on the [wiki instruction page](http://wiki.eprints.org/w/Installing_EPrints_on_Debian/Ubuntu).

Make sure you running the latest Vagrant. Clear out any stale cached boxes if
necessary.


## Inline steps taken by the Vagrant file

Installs a vanilla Ubuntu 14.04 LTS machine. Additionall it does add the eprints
debian repository to /etc/apt/sources.lists.d/eprints.list
and runs `apt-get update`. This could be done manually.


## The Final Steps

These are the steps you need to take after VM is running.

### Create EPrints user/group

```shell
    sudo useradd eprints
```        

Now you should be ready to install eprints v3.3.15 and its required software.
After `vagrant ssh` run `sudo apt-get install eprints`. Answer 'Y' when prompted
about installing software and accepting an unsigned package.

This will install a bunch of software. Some, like MySQL, will prompt for
additional inputs. Accept the defaults. Then proceed to update your local
/etc/hosts on both your dev box and vagrant VM so the rest of EPrints'
install process will work easily.

Make a note of the usernames/password setup during the installation process
for your MySQL and EPrints installation.

In a development environment isolated from the rest of the internet you can
also leverage setting up sudousers and a local .my.cnf for moving around the
system without getting prompted for passwords at every turn.

### Additional Options for your vagrant Host machine

In the _epadmin create_ process you'll create the MariaDB database setup but
also generate the Apache Virtual Host include information. It is important that
these be visible on your network.  On my dev box I needed to add the IP address
assigned by Virtual Box to my /etc/hosts on both the vagrant instance and my
development machine. In my case the ip address was 172.28.128.3 and I had
named my repository host lemurprints.local. On my vagrant host I did

```
    sudo su
    echo "172.28.128.3 lemurprints.local lemurprints" >> /etc/hosts
    exit
```

Then on my local development I also did

```<commit_msg>Quick Save<commit_after>
# EPrints v3.3.15 Install Notes

This vagrant file setups up Ubuntu 14.04 LTS because that is the last one that
has clear install instructions for EPrints v3.3.15. When testing Ubuntu 16.04
problems were not resolved by the linked version on the [wiki instruction page](http://wiki.eprints.org/w/Installing_EPrints_on_Debian/Ubuntu).

Make sure you running the latest Vagrant. Clear out any stale cached boxes if
necessary.


## Inline steps taken by the Vagrant file

Installs a vanilla Ubuntu 14.04 LTS machine. Additionall it does add the eprints
debian repository to /etc/apt/sources.lists.d/eprints.list
and runs `apt-get update`. This could be done manually.


## The Final Steps

These are the steps you need to take after VM is running.

### Install Eprints 

```shell
    vagrant ssh
    sudo useradd eprints
    sudo apt update
    sudo apt upgrade
    sudo apt-get install eprints
```        

Now you should be ready to install eprints v3.3.15 and its required software.
After `vagrant ssh` run `sudo apt-get install eprints`. Answer 'Y' when prompted
about installing software and accepting an unsigned package.

This will install a bunch of software. Some, like MySQL, will prompt for
additional inputs. Accept the defaults. Then proceed to update your local
/etc/hosts on both your dev box and vagrant VM so the rest of EPrints'
install process will work easily.

Make a note of the usernames/password setup during the installation process
for your MySQL and EPrints installation.

In a development environment isolated from the rest of the internet you can
also leverage setting up sudousers and a local .my.cnf for moving around the
system without getting prompted for passwords at every turn.

### Additional Options for your vagrant Host machine

In the _epadmin create_ process you'll create the MariaDB database setup but
also generate the Apache Virtual Host include information. It is important that
these be visible on your network.  On my dev box I needed to add the IP address
assigned by Virtual Box to my /etc/hosts on both the vagrant instance and my
development machine. In my case the ip address was 172.28.128.3 and I had
named my repository host lemurprints.local. On my vagrant host I did

```shell
    sudo su
    echo "172.28.128.3 lemurprints.local lemurprints" >> /etc/hosts
    exit
```

Then on my local development I also did

```shell
{'fraction_non_alphanumeric': 0.048366567670767927, 'fraction_numerical': 0.017819261773440814, 'mean_word_length': 3.952731092436975, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 4, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5862656', 'n_tokens_mistral': 1385, 'n_tokens_neox': 1242, 'n_words': 702}