How to use this box with Vagrant:

Vagrant.configure("2") do |config|
  config.vm.box = "cnodp/wolves"
end
vagrant init cnodp/wolves
vagrant up

This version was created about 2 years ago.

Description

This is a pre-configured VM specifically built for CNODP pre-core. It has all the tools and configurations pre-loaded to ensure that there are minimal issues related to environment or setup. It is not required to be utilized throughout the course, however may prove useful.

Requirements

  • virtualbox, vmware-workstation, or libvirt
  • vagrant (see install instructions below)
  • An x86_64 host machine that can handle at least a 2 vCPU and 4 GB virtual machine. The M1 Mac is only supported via libvirt/qemu however it is considered a tier 2 supported product for us.
  • 10 GB to download the base image.
  • At least 40 GB for each instance of the box running
    • This is configurable either larger or smaller in either virtualbox/vmware/qemu or the vagrantfile
    • The base setup will expect at least 40 GB of disk space free.

Install

Manual Nix

If your host machine is a linux machine install the vagrant package. Web Directions

# For ubuntu/debian based distros
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt-get update && sudo apt-get install -y vagrant
# If you don't have VirtualBox or Vmware already installed
sudo apt-get install -y virtualbox

If you do have vmwware-workstation and would like to use it for this setup you must run the following as well:

# Instructions: https://www.vagrantup.com/docs/providers/vmware/vagrant-vmware-utility
wget -nv -O vagrant-vmware-utility.zip https://releases.hashicorp.com/vagrant-vmware-utility/1.0.21/vagrant-vmware-utility_1.0.21_linux_amd64.zip
sudo mkdir -p /opt/vagrant-vmware-desktop/bin
sudo unzip -d /opt/vagrant-vmware-desktop/bin vagrant-vmware-utility.zip
sudo /opt/vagrant-vmware-desktop/bin/vagrant-vmware-utility certificate generate
sudo /opt/vagrant-vmware-desktop/bin/vagrant-vmware-utility service install
# Instructions: https://www.vagrantup.com/docs/providers/vmware/installation
vagrant plugin install vagrant-vmware-desktop

Manual Winderps

If you are on a windows machine the following commands must be run in an Administrative Powershell environment in order to ensure that you have the necessary tooling to run the box on a windows environment.

# Install the chocolatey package manager 
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
cinst vagrant
# If you do not already have VirtualBox or VMWare installed
cinst virtualbox

If you do have vmwware-workstation and would like to use it for this setup you must run the following as well:

# Instructions: https://www.vagrantup.com/docs/providers/vmware/vagrant-vmware-utility
# Download and install the following package: 
## https://releases.hashicorp.com/vagrant-vmware-utility/1.0.21/vagrant-vmware-utility_1.0.21_x86_64.msi
net.exe start vagrant-vmware-utility
# Instructions: https://www.vagrantup.com/docs/providers/vmware/installation
vagrant plugin install vagrant-vmware-desktop

Manual Mac

# Install libvirt/kvm/qemu via brew
brew install qemu libvirt
vagrant plugin install vagrant-libvirt

Web references:

Initial Setup & Configuration

The box may be run with either Virtualbox, VMWare Workstation, or QEmu/Libvirt.

Manual Setup

The following commands should be run in the directory where you want your vagrant box definitions to be downloaded and stored. These two commands will initiate the environment by downloading a Vagrantfile which can be used to define things like the amount of CPU and Memory to allocate to the box.

vagrant init cnodp/wolves

The above command creates a basic Vagrantfile in the directory it was run in. You may run with the default Vagrantfile (although it may hide the Virtualbox or VMWare GUI to the VM by default.) If you would like to see the VM on screen by default as well as adjust things like vCPUs and RAM for the VM. You may replace th e contents of the Vagrantfile with the following:

Vagrant.configure("2") do |config|
  config.vm.box = "cnodp/wolves"

  config.vm.provider "virtualbox" do |vb|
    vb.gui = true
    vb.memory = 8192
    vb.cpus = 4
  end

  config.vm.provider "vmware_desktop" do |vb|
    vb.gui = true
    vb.vmx["memsize"] = "8192"
    vb.vmx["numvcpu"] = "4"
  end
end

Finally in order to download and bring up the VM you may run the following command. This command can take anywhere from 15-20 min depending on your internet connection as it needs to download the initial 10 Gig image onto your box. Subsequent runs will simply copy the base box to the proper directory from your local filesystem and should be much faster (30 sec to 1 min). In order to pull updates to the box you will need to run a different command detailed later in this guide.

vagrant up --provider virtualbox

QEmu/Libvirt Manual Starting

If vagrant up --provider libvirt does not work on your machine directly you may need to start the box manually. The easiest of these ways is to run a qemu-system-x86_64 box with the default box.img file. Follow the steps below in order to get up and running.

# Find the vagrant box.img that has been downloaded
find $HOME/.vagrant.d/boxes/cnodp-VAGRANTSLASH-wolves/2022.2.0/libvirt

# Expand the size of the qcow2 image file so that it can be booted
qemu-img resize box.img 50G

# Run the qemu-system-x86 comand with the appropriate options
qemu-system-x86_64 -m 4096 -smp 2 -drive format=qcow2,file=box.img

Login Credentials

Username: vagrant
Password: vagrant

Shutdown and restart the machine

In order to shutdown the machine you may run the following:

vagrant down 

If you would like to bring the machine back up you may run the following:

vagrant up

You may of course use either virtualbox/vmwares gui to shutdown and restart the box as well.

Destroy Instance

In order to completely remove the instance and all associated data on the machine you have been utilizing you may run the following command:

vagrant destroy -f

Subsequent runs of the following two commands will check for updates to our customized image (but not download/install them by default) and will boot a fresh copy of the local image currently installed. If there has been an update it will signal that you can download the new image via another command (see below).

vagrant init -f cnodp/wolves
vagrant up --provider virtualbox
# Or vmware provider
vagrant up --provider vmware_desktop

Update

This will pull in any updates for the specified box in your Vagrantfile.

vagrant box update
2 providers for this version.
  • virtualbox
    unknown Hosted by Vagrant Cloud (9.91 GB)
  • vmware_desktop
    unknown Hosted by Vagrant Cloud (9.85 GB)

This version was created about 2 years ago.

Description

This is a pre-configured VM specifically built for CNODP pre-core. It has all the tools and configurations pre-loaded to ensure that there are minimal issues related to environment or setup. It is not required to be utilized throughout the course, however may prove useful.

Requirements

  • virtualbox, vmware-workstation, or libvirt
  • vagrant (see install instructions below)
  • An x86_64 host machine that can handle at least a 2 vCPU and 4 GB virtual machine. The M1 Mac is only supported via libvirt/qemu however it is considered a tier 2 supported product for us.
  • 10 GB to download the base image.
  • At least 40 GB for each instance of the box running
    • This is configurable either larger or smaller in either virtualbox/vmware/qemu or the vagrantfile
    • The base setup will expect at least 40 GB of disk space free.

Install

Manual Nix

If your host machine is a linux machine install the vagrant package. Web Directions

# For ubuntu/debian based distros
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt-get update && sudo apt-get install -y vagrant
# If you don't have VirtualBox or Vmware already installed
sudo apt-get install -y virtualbox

If you do have vmwware-workstation and would like to use it for this setup you must run the following as well:

# Instructions: https://www.vagrantup.com/docs/providers/vmware/vagrant-vmware-utility
wget -nv -O vagrant-vmware-utility.zip https://releases.hashicorp.com/vagrant-vmware-utility/1.0.21/vagrant-vmware-utility_1.0.21_linux_amd64.zip
sudo mkdir -p /opt/vagrant-vmware-desktop/bin
sudo unzip -d /opt/vagrant-vmware-desktop/bin vagrant-vmware-utility.zip
sudo /opt/vagrant-vmware-desktop/bin/vagrant-vmware-utility certificate generate
sudo /opt/vagrant-vmware-desktop/bin/vagrant-vmware-utility service install
# Instructions: https://www.vagrantup.com/docs/providers/vmware/installation
vagrant plugin install vagrant-vmware-desktop

Manual Winderps

If you are on a windows machine the following commands must be run in an Administrative Powershell environment in order to ensure that you have the necessary tooling to run the box on a windows environment.

# Install the chocolatey package manager 
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
cinst vagrant
# If you do not already have VirtualBox or VMWare installed
cinst virtualbox

If you do have vmwware-workstation and would like to use it for this setup you must run the following as well:

# Instructions: https://www.vagrantup.com/docs/providers/vmware/vagrant-vmware-utility
# Download and install the following package: 
## https://releases.hashicorp.com/vagrant-vmware-utility/1.0.21/vagrant-vmware-utility_1.0.21_x86_64.msi
net.exe start vagrant-vmware-utility
# Instructions: https://www.vagrantup.com/docs/providers/vmware/installation
vagrant plugin install vagrant-vmware-desktop

Manual Mac

# Install libvirt/kvm/qemu via brew
brew install qemu libvirt
vagrant plugin install vagrant-libvirt

Web references:

Initial Setup & Configuration

The box may be run with either Virtualbox, VMWare Workstation, or QEmu/Libvirt.

Manual Setup

The following commands should be run in the directory where you want your vagrant box definitions to be downloaded and stored. These two commands will initiate the environment by downloading a Vagrantfile which can be used to define things like the amount of CPU and Memory to allocate to the box.

vagrant init cnodp/wolves

The above command creates a basic Vagrantfile in the directory it was run in. You may run with the default Vagrantfile (although it may hide the Virtualbox or VMWare GUI to the VM by default.) If you would like to see the VM on screen by default as well as adjust things like vCPUs and RAM for the VM. You may replace th e contents of the Vagrantfile with the following:

Vagrant.configure("2") do |config|
  config.vm.box = "cnodp/wolves"

  config.vm.provider "virtualbox" do |vb|
    vb.gui = true
    vb.memory = 8192
    vb.cpus = 4
  end

  config.vm.provider "vmware_desktop" do |vb|
    vb.gui = true
    vb.vmx["memsize"] = "8192"
    vb.vmx["numvcpu"] = "4"
  end
end

Finally in order to download and bring up the VM you may run the following command. This command can take anywhere from 15-20 min depending on your internet connection as it needs to download the initial 10 Gig image onto your box. Subsequent runs will simply copy the base box to the proper directory from your local filesystem and should be much faster (30 sec to 1 min). In order to pull updates to the box you will need to run a different command detailed later in this guide.

vagrant up --provider virtualbox

QEmu/Libvirt Manual Starting

If vagrant up --provider libvirt does not work on your machine directly you may need to start the box manually. The easiest of these ways is to run a qemu-system-x86_64 box with the default box.img file. Follow the steps below in order to get up and running.

# Find the vagrant box.img that has been downloaded
find $HOME/.vagrant.d/boxes/cnodp-VAGRANTSLASH-wolves/2022.2.0/libvirt

# Expand the size of the qcow2 image file so that it can be booted
qemu-img resize box.img 50G

# Run the qemu-system-x86 comand with the appropriate options
qemu-system-x86_64 -m 4096 -smp 2 -drive format=qcow2,file=box.img

Login Credentials

Username: vagrant
Password: vagrant

Shutdown and restart the machine

In order to shutdown the machine you may run the following:

vagrant down 

If you would like to bring the machine back up you may run the following:

vagrant up

You may of course use either virtualbox/vmwares gui to shutdown and restart the box as well.

Destroy Instance

In order to completely remove the instance and all associated data on the machine you have been utilizing you may run the following command:

vagrant destroy -f

Subsequent runs of the following two commands will check for updates to our customized image (but not download/install them by default) and will boot a fresh copy of the local image currently installed. If there has been an update it will signal that you can download the new image via another command (see below).

vagrant init -f cnodp/wolves
vagrant up --provider virtualbox
# Or vmware provider
vagrant up --provider vmware_desktop

Update

This will pull in any updates for the specified box in your Vagrantfile.

vagrant box update
3 providers for this version.
  • libvirt
    unknown Hosted by Vagrant Cloud (10.5 GB)
  • virtualbox
    unknown Hosted by Vagrant Cloud (10.6 GB)
  • vmware_desktop
    unknown Hosted by Vagrant Cloud (10.6 GB)

This version was created over 2 years ago.

Student VM for CNODP pre-core

2 providers for this version.
  • virtualbox
    unknown Hosted by Vagrant Cloud (10.7 GB)
  • vmware_desktop
    unknown Hosted by Vagrant Cloud (12.1 GB)