Virtual Machine Builds

Build an OPS VM

The OPS is distributed on pre-built VM's. These must be built when changes are made.

Template VM

The OPS template VM is called ops.base.ova and is available here.

This VM has CentOS Linux installed, a few additional packages.

Create a new build from the template VM

• Import and boot the template VM
• Run and login to the VM. Default login information: username: ops, password: pubOps
• Open a terminal and enter the following code:

sudo -i
yum update -y
mkdir /vagrant && cd /vagrant
git clone https://github.com/cresis/OPS.git .
reboot

• After the VM is rebooted log in and open the terminal, enter the following code:

sudo -i
cd /vagrant
sh conf/provisions.sh
reboot

You will be prompted for a database user/password. Accept the defaults (admin and pubAdmin) by pressing enter. At some point you will be asked to accept two JAVA license agreements. A [MORE] prompt will appear. You can use your space bar to skip to the YES/NO (hit it until you see YES/NO). Type yes for both.

Next, you will be prompted to add django admins. There can be zero or more admins that will be emailed error information if/when django encounters errors. It is recommended that at least one person be on the admin list to receive and deal with such errors.

Finally, you will be asked if django should operate in debug mode. The answer to this question should always be 'no' in a production environment. If working in a development environment, however, activating django's debug mode may provide insight to errors encountered during development. You can change to and from debug mode later by editing /var/django/ops/ops/settings.py and setting DEBUG to true or false.

• Should you want to preload a portion of the database (i.e. for a field deployment), start the process here instead.

• If one wants to have the eclipse IDE pre-installed and configured for the build, follow these instructions.

• You will need to create an anonymous user for the system to work properly: username: "anonymous", email: "[email protected]", password: "anonymous". First edit the createUserExample.py file with the new user information. This file is located at "/vagrant/conf/tools/" on your virtual box. Then follow the instructions in the header of createUserExample.py to run python. From within python, run "execfile('createUserExample.py')".

• Run the OPS tests to verify Django is operational. Next, open MATLAB (cresis only) and run the following command: opsTests.

• Before testing, make sure the virtual box network environment is set up to use 192.168.111.222. See Virtualbox installation for directions on how to set this up.

• If all tests pass the OPS VM is provisioned and running. Finally you can make sure the GeoPortal is working by visiting 192.168.111.222 on your host machine (your computer, not the VM).

• Secure the geoserver by:

  • Logging into the geoserver (192.168.111.222/geoserver/web/)
  • log in as the administrator (username: root password: pubMaster)
  • Navigate to the Passwords tab (left hand bar)
  • Click on Change password and change it to the standard CReSIS OPS password

• To finish up the process enter the following commands in a new terminal (close all others):

sudo -i
yum clean all
history -c
exit
history -c
sudo -i
shutdown -h now

• In Oracle VirtualBox VM Manager right-click on the bare VM and rename the VM (in settings).

ops.build.yyyy.mm.dd (eg. "ops.build.2014.05.15")

• In Oracle VirtualBox VM Manager select File > Export Appliance and select the renamed VM. Select the /cresis/scratch1/projects/ops/builds/[ouputName].ova as the directory and OVF 1.0 as the format.