Administrative VM

The default username and password is occpadmin:0ccpadmin

The Administrative VM contains the OccpAdmin program that is designed to ease installation of a scenario into a given hypervisor. The official Administrative VM comes with some additional packages and configurations specifically for the OccpAdmin program. Depending on your hypervisor your Administrative VM may house scenario content directly or have access to it. See the remaining sections for installation notes.

Installation

Note: If you want to use hypervisor(s) other than the one your AdminVM is installed on, see the SetupVPN.

  1. Download the AdminVM.
  2. Import the OVA into your hypervisor.
  3. See the below sections for additional steps for your hypervisor.

VirtualBox 5+

NOTE: The version of VirtualBox matters. It must be >5.0 version.

  1. Ensure that the first NIC is connected to an interface that can reach the Internet. Bridged or NAT will generally work.
  2. Ensure that the second NIC is connected to an "Internal Network" named OCCP_Setup
  3. Ensure that both NICs are using the Adapter Type "Intel PRO/1000 MT Desktop"
  4. Create a folder on your host computer at C:\OccpShared\
    This folder will be where you store scenarios. This folder's full path will be known as the Import Directory.
  5. Edit the Admin VM - Add this folder as a shared folder to your VM and make sure to select Auto Mount

VMware

More specific details will be available soon. However, NIC 1 should be connected to a network that can reach the Internet and NIC 2 should be connected to an internal network named "OCCP_Setup".

Updates (IMPORTANT)

It is recommended that once you have the Administrative VM setup that you perform the following steps to bring the software up-to-date:

  1. Boot the VM
  2. Login (credentials are at the top of this page)
  3. Run the following commands:
    pushd ~/occp/source
    git pull && make
    popd
    

Developer Tools

Each AdminVM ships with some developer tools. Developers can X11 forward eclipse and import the ant file. Additionally, vim has been configured to work with puppet files.

Configuration Summary

Installed Packages:

  • ant
  • bridge-utils
  • dnsmasq
  • eclipse-egit
  • eclipse-jdt
  • git
  • make
  • ntp
  • puppetmaster-passenger
  • openjdk-7-jdk
  • openjdk-7-jre-headless
  • openssh-server
  • openvpn
  • squid3
  • virtualbox-guest-utils

Additional Configurations:

  • Passwordless sudo for
    • /sbin/brctl
    • /usr/sbin/dnsmasq
    • /sbin/ifconfig
    • /usr/bin/pkill
    • /usr/bin/openvpn
  • Allows IPv4 forwarding and sets up ufw to use NAT forwarding. This is so it can act as a router for the setup network to reach the internet to pull packages.
  • Installation of the OCCPAdmin Program
  • vim configurations/tools for puppet

Build Notes

The Admin App read me page contains https://github.com/OpenCyberChallengePlatform/OccpAdmin contains information on how to build a new VM. The Base VM upgrade procedures and instructions on how to build the VM from scratch can be found there.

The Admin App includes a Puppet content pack for configuring the Admin VM. This content pack may require modification when upgrading or changing operating systems.