The BOINC server virtual machine

This VM is for use as a BOINC server. It has all the BOINC server prerequisites installed, the BOINC software installed and compiled, and user accounts and permissions set up. It's ready to run ~/boinc-trunk/tools/make_project and go.

The VM image is for ​VirtualBox, an open-source VM system. It is a 64-bit image; you need a 64-bit processor to run it.

The OS is Debian 6 "Squeeze" (64-bit).

The BOINC software version is 25883.

Download (366 MB)

Notes:

• The passwords can be found in the file README-vmware-image that is part of the zip file. The root (or su) password is 'rootpw'. There is a user account 'boincadm' with password 'boincadmpw'; build software under this account. Change these passwords immediately.

• The BOINC software on this VM is not necessarily the latest version. If you want the latest version, run

  $ cd ~/boinc-trunk
  $ svn update
  $ cd ..
  $ ~/configure_server.sh
  $ ~/make_server.sh
  

• The Linux/PHP/MySQL/Apache software on this VM is not necessarily the latest version. If you want the latest version, use 'apt-get update' and 'apt-get upgrade'.

• The "sudo" command is available as user "boincadm" and there is an OpenSSH server running by default.

Network Access

VMware provides two ways to access the network from the VM: Bridged Ethernet and NAT (Network Address Translation). These are selected using the pulldown menu below "Ethernet" in the VMware player. We recommend that you start with Bridged Ethernet.

The first time you boot the VM, log on as root and, if present, delete the file

/etc/udev/rules.d/z25_persistent-net.rules

General info about network configuration under Debian is in the ​Debian Reference.

Bridged Ethernet

In this mode, the VM will act like a separate machine on your network. Scanning the network will reveal two machines, your host and the VM. Outgoing and incoming connections are possible.

We recommend that you give the VM a static IP address. To do this, edit /etc/network/interfaces. For example:

# The primary network interface
auto eth0

iface eth0 inet static
address 141.142.234.9
netmask 255.255.255.0
gateway 141.142.234.1
dns-search yourdomain.edu
dns-nameservers a.b.c.d

Where a.b.c.d is your DNS server IP address (you can supply more than one).

Edit /etc/resolv.conf to include

nameserver a.b.c.d

where a.b.c.d is the DNS server IP address

You should also add the IP address and hostname of the VM to your hosts file. To do this edit C:\Windows\system32\drivers\etc\hosts (if the host is Windows) or /etc/hosts (as root; if the host is Unix) with an editor, and add for example:

141.142.234.9 debian.localdomain

With this you can connect a client from your host machine to your VM. If you're using a proxy to access the internet you should add 'debian.localdomain' to your list of exceptions in your browser. You won't need a proxy to resolve a local address.

Alternatively, you can get an IP address via DHCP. We don't recommend this because clients will get confused if the IP address changes. To do this, edit /etc/network/interfaces to include:

iface eth0 inet dhcp

This will work if your network has a DHCP server configured to issue IP address to new hosts.

At this point, for the network changes to take effect, you may want to restart the Linux instance:

shutdown -rF now

If you're running the VM on Windows and networking stops working, try the following. In a Windows command window:

net stop vmnetbridge
net start vmnetbridge

Then restart the VM's network as well, with:

sudo ifconfig eth0 down
sudo ifconfig eth0 up

If that still doesn't work, reboot your machine and try the same process again.

NAT

In this mode, the VM shares the IP address of the host machine in order to make outgoing connections (access Internet sites from within the VM). Scanning the network will only reveal one machine. Incoming connections to the VM are generally not possible, so this mode is not recommended.

However, this limitation can be circumvented using port forwarding (not available with the free VMware player). To do this, use the VMware virtual network editor (Edit > Virtual Network Settings > NAT > Edit > Port Forwarding). More information in ​Configuring a Virtual Network. On Windows, if NAT is to be used and not already set, do the following to get network access in the VM:

Start | Programs | VMware | VMware Server | Manage Virtual Networks
(Virtual Network Editor):
Host Virtual Network Mapping:
VMnet0: Bridged to an automatically chosen adapter.
VMnet8: VMware Network Adapter VMnet8
In the NAT tab: VMnet host: VMnet8