= Installing a Physical Allocation Auctioneer =

A physical allocation auctioneer manages a group of physical servers. It assigns the servers to users according to economic mechanims and installs and configures operating system images.

Note that this process will allow you stay up to date with the latest code by doing "{{{yum -y update}}}" periodically.

If you have not already done so, follow the directions in the [http://tycoon.hpl.hp.com/~tycoon/doc/users_manual_en/ch-tutorial.html Tycoon User's Manual] to create a Tycoon bank account. This will be the account that owns the providing hosts. Funds earned by the hosts will be deposited in the owner account. 

1. Configure the auctioneer's owner by copying the host's owner's "{{{~/.tycoon}}}" directory to root's home directory (usually "{{{/root}}}"). The owner must have already created a Tycoon bank account as described in the Tycoon User's Manual [http://tycoon.hpl.hp.com/~tycoon/doc/users_manual_en/ch-tutorial.html" tutorial] up to step 4. For example, Alice would do:
{{{
[root@alicehost ~]# cp -a /home/alice/.tycoon /root
}}}

2. Download the package repository configuration file. This will allow you to automatically download package dependencies and to easily upgrade the Tycoon packages later. Run the following command for Redhat Enterprise Linux derived distributions (including Scientific Linux and CentOS):
{{{
[root@alicehost ~]# cd /etc/yum.repos.d
[root@alicehost ~]# wget http://tycoon.hpl.hp.com/~tycoon/dl/yum/tycoon_el.repo
}}}
For Fedora distributions, use the following:
{{{
[root@alicehost ~]# cd /etc/yum.repos.d
[root@alicehost ~]# wget http://tycoon.hpl.hp.com/~tycoon/dl/yum/tycoon_f.repo
}}}

3. Use {{{yum}}} to download and install the Tycoon auctioneer RPMs.  Run the following to install a Xen auctioneer for Redhat and Fedora distributions: 
{{{
[root@alicehost ~]# yum -y install tycoon_aucd_physical
}}}
The installation process also configures the auctioneer to be started automatically when the machine is booted, 2) the auctioneer log file to be periodically rotated, and 3) the owner to receive credits earned by the host.

4. Configure DHCP server for PXE booting. A DHCP server should already be installed as a result of installing the Tycoon RPMs. You still need to configure DHCP by hand because the configuration varies for each site. Follow the directions at [http://syslinux.zytor.com/wiki/index.php/PXELINUX#How_Should_I_Setup_My_DHCP_server.3F PXELINUX documentation on setting up a DHCP server].

5. Download and mount operating system ISOs. A TFTP server and basic PXE files should already be installed as a result of installing the Tycoon RPMs. You still need to add configuration for the operating system distributions that you want to be installed for the managed servers. For example, for CentOS 5.3, you need to download the DVD ISO "{{{CentOS-5.3-x86_64-bin-DVD.iso}}}". Mount the iso:
{{{
[root@alicehost ~]# mkdir /mnt/CentOS-5.3-x86_64
[root@alicehost ~]# mount -t iso9660 -o loop CentOS-5.3-x86_64-bin-DVD.iso /mnt/CentOS-5.3-x86_64
}}}
For Ubuntu 9.04, you need to download the DVD ISO "{{{ubuntu-9.04-dvd-amd64.iso}}}". Mount the iso:
{{{
[root@alicehost ~]# mkdir /mnt/Ubuntu-9.04-x86_64
[root@alicehost ~]# mount -t iso9660 -o loop ubuntu-9.04-dvd-amd64.iso /mnt/Ubuntu-9.04-x86_64
}}}

6. Copy installation files from the mounted ISOs to the HTTP directory. For CentOS worker nodes, do the following:
{{{
[root@alicehost ~]# cp -a /mnt/CentOS-5.3-x86_64 /var/www/html/tycoon_aucd_physical
[root@alicehost ~]# umount /mnt/CentOS-5.3-x86_64
}}}
For Ubuntu worker nodes, no additional work is required in this step.

7. Copy installation files from HTTP directory to the TFTP directory. For CentOS worker nodes, do the following:
{{{
[root@alicehost ~]# cp -a /var/www/html/tycoon_aucd_physical/CentOS-5.3-x86_64/images/pxeboot/* \
/tftpboot/linux-install/CentOS-5.3-x86_64/
}}}
For Ubuntu worker nodes, 
{{{
[root@alicehost ~]# mkdir /tftpboot/linux-install/Ubuntu-9.04-x86_64
[root@alicehost ~]# cp -a /mnt/Ubuntu-9.04-x86_64/install/netboot/ubuntu-installer/amd64/* /tftpboot/linux-install/Ubuntu-9.04-x86_64
[root@alicehost ~]# umount /mnt/Ubuntu-9.04-x86_64/
}}}

8. Setup HTTPD to start automatically.
{{{
[root@alicehost ~]# chkconfig httpd on
}}}

9. Generate SSL certificates for apache. See these [http://www.tc.umn.edu/~brams006/selfsign.html directions]. After generating server.crt and server.key, copy them to the apache directories for RHEL:
{{{
[root@alicehost ~]# mv ssl_keys/server.crt /etc/pki/tls/certs/opencirrus.crt
[root@alicehost ~]# mv ssl_keys/server.key /etc/pki/tls/private/opencirrus.key
}}}