Unnoc VMware Appliance v2.0

Finally a lightweight appliance to monitor your VMware Infrastrcuture.


Changelog

What's new in v2.0?

Well i listened to all you guys out there in the vmware forums, and tried to make this appliance much simplier to install & set up.

  • Now based on a Fedora 8
  • Should be about 250/300Mo footprint (Compressed)
  • Added this little appliance page to ease your setup ;)

If you can support my work with a little donation (top right of this page) would truely be great ! PS: mail me for any VMware Appliances you would like to see, I'll look to what i can do !

Virtual Machine Specs

Specifications:

Virtual Machine Hardware:

  • 1 vCPU
  • 512 Mo Ram
  • 5Go Hard Disk (SCSI Controller: lsilogic)
  • 1 Network adapter (DHCP default)

Virtual Machine Software:

  • fedora 8 Operating System (i386)
  • httpd-2.2.6-3
  • mysql-server-5.0.45-4.fc8
  • viperltoolkit (svn trunk)
  • unnoc perl pre-requisites
  • unnoc (svn trunk)
  • VMwareTools-7240-59824

Virtual Machine Credentials:

SSH is enabled on this appliance, so you can login directly by network if DHCP is configured on your network.

  • user: root
  • pass: unnoc123

PS: You should change the password once you login for security purposes.

STEP 1: Networking

How to configure your network ?

DHCP IP Configuration (default)

If DHCP is ok for you then check the current ip address:

# ifconfig eth0

-> Goto STEP 2

STATIC IP Configuration

To configure static IP address:

# system-config-network
(set up your network configuration)

# service network restart
(restart network services)

STEP 2: Unnoc Configuration

The only unnoc file to edit is this one:

# vi /var/www/html/unnoc/etc/unnoc.conf
(Goto the end of that file until you find "VMware Appliance Configuration")

I posted some configuration samples, just uncomment one that suits you and modify the main values (ip/user/pass/snmp community if needed)

PS: interval = 2 (is the polling period before fetching new data = 2 minutes)
interval = 5 should be a fine value too.

Once you finished, save the file and exit.

STEP 3: Some configuration informations (optional)

This step shouldn't be needed but we will do it to ensure you understand what's going on after that. (it's activated is this appliance)

There are several services that are critical for unnoc to work. Here is the list:

  • mysql server (contains unnoc database)
  • httpd server (the one deserving the web interface)
  • unnoc daemon (itself that will fetch statistics data)

The next steps have already be done:
Ensure httpd/mysqld/unnocd services will be started at boot time:

# chkconfig httpd on
# chkconfig mysqld on
# chkconfig unnocd on

Ensure each service is started/running.

# service httpd status
# service mysqld status
# service unnocd status

If not running you could use the following command to start the service:

# service servicename start (servicename could be for example: "httpd")

STEP 4: Updating appliance (optional)

New features are out, and i want them !

##
## WARNING: You must know what you are doing
## WARNING: when trying to update this appliance.
## If it works as you like just don't do this ;)
##

Updating OS (Fedora 8)

Just use the normal way ;)

# yum update

If you have a proxy you could use the following commands:
# export http_proxy="http://user:pass@ip:port"
# yum update

Updating Unnoc

I bundled this appliance with the trunk version of the svn repository so you should be able to update it easily using the following command:

# svn up /usr/share/unnoc

##
## WARNING: Check on unnoc website (http://www.unnoc.org)
## If some specific upgrade process (database mostly) or else is needed
## you could DAMAGE your current data otherwise.
##

Updating Viperltoolkit

Same as unnoc, i bundled it using the trunk revision of the svn repository.
Use the following command:

# svn up /usr/share/viperltoolkit

##
## WARNING: Same as unnoc if anything changes in the API, the
## DAMAGE could be great for unnoc (not fetching data anymore)
## so it would become an useless appliance.
##

STEP 5: Done !

Everything should be fine right now

Open your favorite browser to the following url:

http://unnoc_server_ip/unnoc

If you can support my work, I would really appreciate (for the hosting fees)


Download Appliance
MD5: 8ccc2ff6eeb1b1d8069dc254c514afcb