Installation

ole--vagrant-community gives you the ability to install your own community BeLL (Basic e-Learning Library), including all its dependencies, on your system. To install it, please follow the directions for your OS.

Windows

We wrote two different scripts to install the community BeLL and its dependencies on your computer. They are equivalent, so if you run Windows 8.1 or above, you can use either of the two. If you like, you can also try both and provide us with feedback on which one worked better for you. It is not required to try both, but we would be grateful if you decide to do so. To run the script, just copy and paste one of the lines below in a Command prompt opened as administrator.

Windows 8.1 and above

@powershell -Command "(New-Object Net.WebClient).DownloadFile('https://raw.githubusercontent.com/dogi/ole--vagrant-community/master/windows/install.ps1', 'install.ps1')" && @powershell -NoProfile -ExecutionPolicy Bypass -Command ".\install.ps1"

Windows 7 and above

powershell -Command "(New-Object Net.WebClient).DownloadFile('https://raw.githubusercontent.com/dogi/ole--vagrant-community/master/windows/install.bat', 'install.bat')" && start install.bat && exit

To run your community BeLL at the end of the installation, please, find the MyBeLL icon on your desktop and double click on it. It will open a Firefox browser and take you directly to your community BeLL webpage.

Dependencies

These programs will be automatically installed on your computer:

• Chocolatey Chocolatey is a package manager for Windows that we use to install/uninstall all the other programs in a simple and reliable way.
• Bonjour Bonjour is used to implement zero-configuration networking on your computer.
• Git Git is an open source version control system that we use for communication and management for our software. More specifically, we use gitter.im for communication and github.com for software management.
• VirtualBox Virtualbox allows you to install a software virtualization package as an application on your OS.

Note: if you already have VirtualBox installed on your computer and have existing VMs on virtualbox already, running the command above to reintall VirtualBox won't affect/wipe out your existing VMs; it will just add the OLE VM to the ones you have.

• Vagrant Vagrant is an open source tool for building development environments.
• Firefox Firefox is a popular browser, which is guaranteed to work nicely with your community BeLL.

MacOS(X)

Open your Terminal. We assume that brew is already installed.

    brew install git 
    brew cask install vagrant
    brew cask install virtualbox

Ubuntu

    sudo apt-get install git
    sudo apt-get install virtualbox
    sudo apt-get install vagrant

MacOS(X) and Ubuntu ONLY

Install a communityBeLL on your OS

In your Terminal or Command Prompt, type:

git clone https://github.com/dogi/ole--vagrant-community.git
cd ole--vagrant-community
vagrant up

You now have a working communityBeLL on your OS. It is advisable to use Firefox to access your community BeLL, so if you don't have it already on your system, you may want to download it.