<commit_before>Creating BCE VMs with Vagrant
=============================

For the Vagrant approach, run:

	$ BCE_PROVISION=BCE  vagrant up

When the build is complete, the builder may connect to the VM by running
"vagrant ssh" or by connecting with an RDP client to port 53389. The default
username and password for the VM are both "oski".

We're working on an approach with Packer also:

	$ packer build BCE-14.04-amd64.json

Both approaches will retrieve a minimal Ubuntu 14.04 vagrant box and provision it
utilizing the bootstrap-bce.sh script. The BCE\_PROVISION environment variable
serves as a hint to the bootstrap script so that different authors can create
different VMs using the same build framework.

Note that it should be possible to attach the bundled ISO for guest additions
using something like the following in the JSON "vboxmanage" section:

```json
[
  "storageattach",   "{{.Name}}",
  "--storagectl",    "IDE Controller",
  "--port",          "1",
  "--device",        "0",
  "--type",          "dvddrive",
  "--medium",        "additions"
]
```<commit_msg>reorganized HOWTO.md a bit<commit_after>Overview
=============================

Both approaches outlined below will retrieve a minimal Ubuntu 14.04 box and provision it utilizing the bootstrap-bce.sh script. The BCE\_PROVISION environment variable serves as a hint to the bootstrap script so that different authors can create different VMs using the same build framework.  

Creating BCE VMs with Packer
=============================

For a Virtualbox VM, run:

    $ BCE_PROVISION=BCE packer build BCE-14.04-amd64.json

This creates a virtual machine in the OVA format that can be imported into Virtualbox on Windows, Mac, or UNIX.

To create an Amazon EC2 AMI, run:

    $ BCE_PROVISION=BCE packer build BCE-14.04-amd64-ec2.json

Note that currently when you start up a VM from the resulting AMI, you'll need to first login as the 'ubuntu' user and set up SSH keys for the 'oski' user, which is the user provisioned by BCE.

Creating BCE VMs with Vagrant
=============================

For the Vagrant approach, run:

	$ BCE_PROVISION=BCE  vagrant up

When the build is complete, the builder may connect to the VM by running
"vagrant ssh" or by connecting with an RDP client to port 53389. The default
username and password for the VM are both "oski".

Note that it should be possible to attach the bundled ISO for guest additions
using something like the following in the JSON "vboxmanage" section:

```json
[
  "storageattach",   "{{.Name}}",
  "--storagectl",    "IDE Controller",
  "--port",          "1",
  "--device",        "0",
  "--type",          "dvddrive",
  "--medium",        "additions"
]
```
{'fraction_non_alphanumeric': 0.11672862453531599, 'fraction_numerical': 0.015613382899628252, 'mean_word_length': 3.788256227758007, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, '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': '1267105', 'n_tokens_mistral': 817, 'n_tokens_neox': 737, 'n_words': 359}