nblair / vagrant-broadleaf

A project to spin up an instance of the Broadleaf Commerce DemoSite.

vagrant-broadleaf

This project aims to provision a simple Broadleaf instance using Vagrant and Puppet.

This project specifically is an alternative to list of instructions documented in Broadleaf's Getting Started. Rather than downloading Eclipse and a JDK, running some specific ant targets, Vagrant and Puppet automate those steps.

Requirements

Warning: The virtual machine that will be provisioned by vagrant will have 2 GB of RAM.

1. Install VirtualBox
2. Install Vagrant
3. Clone or download this repository to the root of your project directory: git clone https://github.com/nblair/vagrant-broadleaf.git
4. In your project directory, run vagrant up

Be prepared to wait; the first launch of the site may take a good 15 minutes.

Using

To access the site, point your browser at http://localhost:8080. To access the admin console, point your browser at https://localhost:8444/admin. Log in with username admin and password admin.

Debugging

The first lauch can take a very long time to start up, but if something does seem amiss, you can check that the service is running and look at its log for problems.

1. Use vagrant ssh to login to the virtual machine.
2. Verify that broadleaf is running: pgrep -lf jetty
3. Its output can be found in /vagrant/eclipse-workspace/DemoSite/site/stdout.log

vagrant-broadleaf's Issues

The 'site' and 'admin' modules do not start automatically.

Try to create services for the site and admin sub-projects so they start automatically with 'vagrant up'.