User:Jsmoeller

Revision as of 16:05, 21 March 2011

Using the OBS Appliance

The OBS Appliance provides an easy and scalable way to start using OBS. This setup scales from workstation only to workgroup size and allows migration to enterprize size lateron.

Prerequisites:

Hardware:

• recent CPU (with vmx/smt , 64bit is plus but currently no requirement)
• >= 4GB RAM (the more the better!)
• fast disks
• 30GB diskspace (initial footprint is < 4GB , but scales depending on use)

Software

• VirtualBox (or VMware / Qemu , but instructions are VirtualBox-centric atm)
• OBS Appliance (will be downloaded in the tutorial)
• OBS Data storage disk with LVM volumes (we'll setup, this is YOUR data store)
• openSUSE 11.4 live cd (for LVM volume setup)
• network with dhcp (required!)
• network with dns-server and dhcp client resolution (option)

The steps on this tutorial were collected on an openSUSE 11.3 system.

Fetching needed files

Lets create a folder "obs-appliance-downloads".

mkdir -p ~/obs-appliance-downloads
cd ~/obs-appliance-downloads

VirtualBox

Install VirtualBox (as root) for your Distribution from http://www.virtualbox.org/wiki/Linux_Downloads or use your package manager to install VirtualBox. At time of writing, VirtualBox 4.0.4 was used.

OBS Appliance

The openSUSE Build Service Appliance is developed and hosted by the openSUSE project. We use the "vmx.tar.bz2" image.

The latest stable version is available here:

http://download.opensuse.org/repositories/openSUSE:/Tools/images/

The latest unstable version is available here:

http://download.opensuse.org/repositories/openSUSE:/Tools:/Unstable/images/

At the time of writing (--Jsmoeller 14:57, 21 March 2011 (UTC)) we used:

wget -nd "http://download.opensuse.org/repositories/openSUSE:/Tools:/Unstable/images/obs-server.x86_64-2.2.60-Build17.1-vmx.tar.bz2"
#
# ATTENTION !  link changes !

openSUSE 11.4 live cd

For the initial setup of the data storage LVM disk, we use openSUSE 11.4 with yast2 . If you know how to do this with $YOUR_DISTRO, you can replicate the steps. The livecd can be downloaded here:

wget -nd "http://download.opensuse.org/distribution/11.4/iso/openSUSE-11.4-KDE-LiveCD-i686.iso"

Creating the virtual machine

Make sure the vboxdrv is loaded and all needed components installed for VirtualBox to run!

Fire up VirtualBox:

VirtualBox

Create a new Appliance (click "New" on top left)

Click on "Next" and fill in the name of the new appliance. OS is "Linux" and Version is "openSUSE(64 bit)".

Note: We'll use 64bit, but currently for MeeGo the 32bit Appliance would work, too.

Click on "Next" and assign ~3G RAM (as always, more is better ;) - it should work with 2G ).

Click on "Next". Now, select to create a new disk:

Click on "Next" - this will open a new wizard to create a disk image:

We'll use a "Dynamically expanding storage" sized 28 GB (your choice - min is ~15GB).

"Finish" will take us back to the first wizard which holds the summary of our new appliance:

Click on Finish. Your new appliance is now ready.

In the next step, we'll boot up once into the live system to create the persistent storage partitions.

Creating the persistent LVM data storage

First step is to create your persistent data storage which is hosted on a set of logical volumes of a "OBS" volume group.