2007-06-01
Vmware Unnoc Appliance
http://unnoc.org


This is a brief document to tell you how to get started with the VMware
Unnoc Appliance.

	1. Installation
	2. Configuration

First, the VM was created with VMware Workstation 5.5.2, but should work
on any of these products:

	VMware Workstation 5, 6
	VMware Server 1.x
	VMware Player 1, 2

For ESX 3, you need to use vmkfstools to clone the disk first
	
	vmkfstools -i

For ESX 2.5, you need to use VMware Converter to convert it from VMWare
Workstation to ESX 2.5 format


1. Installation

First, download the latest VMDK file from http://unoc.org#download

Next, bunzip the vmdk file

	# bunzip2 unnoc-1.0.10.1.vmdk.bz2

The appliance is packaged as a VMDK file, or a VMware virtual disk.  It
is essentially a hard drive with an OS already installed and configured,
all you have to do is create a Virtual Machine inside of your VMware
application and tell it to use this hard drive instead of using a new
hard drive.

The following instructions are for VMware Workstation 5.5.2, although
the concept is the same for all VMware products.

	1. Add a "Custom" VM, choose "New - Workstation 5"
	2. Use "Linux, Other 2.6.x Linux"
	3. Go through Processor and Memory choices,
	4. Choose SCSI, LSI Logic adapter
	5. Use an existing virtual disk
	6. choose "unnoc-1.0.10.1.vmdk"

For ESX 3, you have to clone the disk first (because ESX needs it in a
little bit of a different format):

	vmkfstools -i /path/to/unnoc-1.0.10.1.vmdk new-filename.vmdk

For ESX 2.5, download the VMware Converter to convert the file to ESX
2.5 disk format.

	http://www.vmware.com/products/converter/

2. Configuration

Once you have bunziped the VMDK file and created a VM for it, go ahead
and boot it up and then login.  The credentials are:

	username: root
	password: unnoc123

Unnoc is already running in daemon mode, all you have to do is add your
hosts to the unnoc.conf file and then reload the daemon.

	# vi /var/www/unnoc/etc/unnoc.conf
	(add all of your configured hosts)

	# /etc/init.d/unnocd reload

See the following documents for adding hosts:

   Linux/UNIX/Microsoft		README.add_hosts, README.hosts
   Network Appliances		README.netapp
   VMware VI3			README.vmware
   EM01 Environment Sensor	README.em01
   Barracuda SPAM Firewalls	README.barracuda-spam-firewall
   Apple Airports		README.apple-airports
   Cisco Aironets		README.aironets
   APC products			README.apc

   OpenLDAP monitoring		README.openldap
   MySQL monitoring		README.mysql
   PostgreSQL monitoring	README.postgresql

   All others (generic)		README.add_hosts, README.hosts

There are example config files located in the /root/unnoc-1.0.10.1
directory.

There are also example index and config files located for the unnoc demo
online:

	http://unnoc.org/demo/
	http://www.unnoc.org/demo_files/




vim:tw=72:wm=1