Installing from WW2.9 Ubuntu14.04 Vanilla Virtual Machine Image

These instructions cover the installation of the Ubuntu Linux 14.04.2LTS 64 bit operating system and WeBWorK 2.9 using the WeBWorK Virtual Machine Image.

The WeBWorK Virtual Machine Image is an .ova file which is an "open, secure, portable, efficient and extensible format for the packaging and distribution of software to be run in virtual machines" (see http://en.wikipedia.org/wiki/Open_Virtualization_Format) and is supported by VMware, VirtualBox, etc. This image file has been tested on VMware Player 6 and VirtualBox 4.

This "vanilla" version of the server should work fine for smaller installations (say a 1000 users or less). There will be a "production" version that adds things like lighttpd, log rotations, etc that are useful for larger installations and/or slower servers. Note that you can always start with the vanilla version and make additions or changes after setting up your server.

Installing from WW2.9 Ubuntu14.04 Vanilla Virtual Machine Image

Overview

After installing from the WeBWorK Virtual Machine Image, you will have a full fledged Ubuntu 14.04 LTS system with WeBWorK, Apache2, MySQL, etc. installed and configured. If your network uses DHCP, networking will be automatically configured for your system. If it uses static IP addresses, you will have to configure networking. Also it is imperative that you CHANGE THE PASSWORDS for the OS user wwadmin (which has sudo privileges), for the MySQL users root and webworkWrite, and for the WeBWorK user admin which has professor privileges (see below).

There are more detailed instructions for Ubuntu 14.04 and WeBWorK 2.9 at Installation_Manual_for_2.9_on_Ubuntu_14.04

Download the ova image

There is only a 64 bit distribution. The 64 bit distribution should work with most modern cpu's. Download the md5 check sum and .ova file from either of the sites below. Download WW2.9_Ubuntu14.04_Vanilla.ova.md5 and WW2.9_Ubuntu14.04_Vanilla.ova . The ova is a 2.2 GB file.

Rochester

MAA

Verify the MD5 checksum of your downloaded file agrees with the above. For information on how to verify the MD5 checksum, see e.g. https://help.ubuntu.com/community/HowToMD5SUM

Installing the WeBWorK Virtual Machine Image

Import the file WW2.7_Ubuntu12.04_Vanilla.ova into your virtualization software package (e.g. VMware, VirtualBox). The ova file was created on VirtualBox and has been tested on VirtualBox and WMware Player. Note on WMware Player you will get a warning message but on retry it will work. After importing, your virtual WeBWorK server will be identical to a system created from the WW2.9 Ubuntu14.04 Vanilla LiveDVD.

Note that on other virtual environments, you may need to take additional actions. See the section Other Virtual Environments below.

Install the Ubuntu package texlive-latex-extra

We need to install one extra package that was not included on the WeBWorK Virtual Machine Image. Open a terminal window and run the command

sudo apt-get install texlive-latex-extra
[sudo] password for wwadmin: <wwadmin password>

Continue the installation

You are exactly at the stage in the installation described in Installing_from_WW2.9_Ubuntu14.04_Vanilla_LiveDVD#Boot_your_server.

Continue Installation

Go to Installing_from_WW2.9_Ubuntu14.04_Vanilla_LiveDVD#Boot_your_server and follow the instructions there. Note that if your server will be accessible from the internet, it is imperative that you follow the instructions for changing passwords.

-- Main.ArnoldPizer - 31 July 2014

Installing from WW2.9 Ubuntu14.04 Vanilla Virtual Machine Image

Contents