Skip to content

Installing on a Windows 10 System

Harry Goldschmitt edited this page Nov 1, 2020 · 12 revisions

Install Prerequisites


Log into your system as a user that has Admin privileges.

The GMAT2020_box has three host prerequisites, a git client, Virtual Box and Vagrant.

Git Client

See Git Client, above.

VirtualBox

Get the VirtualBox Installation Files

Open a browser window to the Virtual Box download page. Select the VirtualBox Extension Pack to download the platform independent .extpack file. Then select the link to Windows hosts. Select Download to download the .msi file to your Downloads directory.

Install VirtualBox

Use File Explorer to find the Virtual Box .msi file in the Downloads directory. Double click on the .msi file and follow the instructions to install VirtualBox.

Install VirtualBox Extensions

Double click on the Extension Pack file in your Downloads directory, and start it.

Verify VirtualBox is Installed and Can Perform Commands

Add VBoxManage To Your PATH

Enter env in the search box at the bottom left of your display and press enter. You will be given a choice of matches, double click on "Edit environment variables for your account." Under "User variables for [user id]" select "Path" and click on the Edit... button. Select the "New" button. Enter "C:\Program Files\Oracle\VirtualBox" and select the "OK" button.

Verify VBoxManage Is Installed

Vagrant does not use the Virtual Box GUI, but uses the console VBoxManage command, instead. Open a command prompt window. Verify the installation by entering:

vboxmanage --version

The output of this command should match the version just installed from the Virtual Box web site.

Verify Virtual Box can run a virtual machine by entering:

vboxmanage createvm --name temporary --ostype Ubuntu_64 –-register  
vboxmanage startvm temporary --type headless

Look for the message "VM temporary has been successfully started". Delete the temporary VM by issuing the following commands:

vboxmanage controlvm temporary poweroff
vboxmanage unregistervm --delete temporary

Install Vagrant

Open a browser to the Vagrant download page.

Download the Windows 64 bit version of Vagrant.

Use File Explorer to open your Downloads folder and double click on the vagrant .msi file.

Follow the prompts to install Vagrant.

After Vagrant finishes installing, you will be prompted to restart your system. Please do so.

Vagrant is a command line system, so you will have to use the Command Prompt window to invoke it.

Verify Vagrant Install

Verify vagrant is installed by opening a Command Prompt window and entering

vagrant --version

The version should match the version downloaded from the Vagrant web site.

Congratulations, you have installed Vagrant on your Windows machine. Please skip to the section on [obtaining the Digital Sats repository](#5.Obtain the Digital Sats Repository|outline).