Manage IQ – Setup/ Issues encountered

A colleague of mine recently introduced me to the open source version of RHEL’s CloudForm, – Manage IQ .. While I wasn’t sure what exactly I could use it for at first (the idea just sounded cool) I got this thing setup and within 2 hours was giving a pitch to the management team on a lot of its functionality and show casing that it worked completely cross platform due to its HTML 5 capabilities for the console (friggen VMWare and their love of flash) and we could consolidate our many Vsphere environments into a single pane of glass which was AWESOME for me as I am all about streamlining and automation. I could go on and on about the functionality and stuff I am planning to add to it but for now I will keep it simple and write on those subjects later on.

So any way, a quick over view of the general setup and things that should be done once you get this appliance deployed.

  • First things first hop on over to http://manageiq.org/download/vmware/ and grab the appliance.. It is roughly 1.2 gb so give yourself some time to download this (coffee breakkkk!)
  • Deploy .ova template to vSphere Environment (File -> Deploy OVF Template) again give yourself about 15 minutes here for the deployment to finish
  • Power on the appliance and wait for a full boot up

Now this is where things started to fall apart in the documentation provided by Manage IQ for me. I noticed that during the deployment of my ova template that there was only 1 vlan available to select. Which in itself was not a big issue as we could just change this later when its finished. But during this next step we will be taking care of setting up the network so I figured I would mention this.. If you are not familiar with how to set a new vlan on the NIC simply right click on the appliance click “Edit Settings”  in the left pan click “Network adapter 1” and the in the bottom right select the correct vlan from the “Network Label” and click “OK”.. Alright off my soap box.

  • Open the console in vmware (Select the VM from the pane on the left -> Console tab)
  • Enter user credentials which by defaults are admin/smartvm
  • This will bring you to your configuration screen. setup your network, hostname, TZ etc etc here is what it looks like (it pretty much walks you through everything)

manageIQ

  • After this is all set up to your liking you can just log right into the webconsole @ https://yourIPhere/ using the same “admin” and “smartvm” credentials.

Now this will bring you to dashboard by default with no info on it yet (don’t worry it will populate shortly) lets not worry just yet about the pretty little graphs and such that your management is going to want to drool over(it will look like this in due time).

ManageIQDB

  • Click on “Configure” in the top right hand corner of your screen
  • In the left pane select your “Zone” and fill in its details (company name, host name etc etc)
  • On this same page scroll down to the “Server Control” and assign the server roles.. You will notice there are some defaults already selected.. Save your self the trouble and  select them all ahead of time, assess what functionality you need and just scale back instead of pondering why a feature is greyed out later on down the line.

manageIQRoles

 

  • While you are on this screen now just fill out all the information on the right for your local smtp settings , and your ntp servers then click on the blue “Save” button on the bottom of the page.
  • From the top menu select the “Infrastructure” menu option. You will see configuration button with a sprocket that will drop down a few more menu options. Click on “Add a new Infrastructure Provider”
  •  Now this screen is where you will add your vCenter  instances. Give it a name, select the type of  provider (vmware in my case), give it the IP of your vcenter and add your root credentials and then click on the “Validate” button to make sure a connection is possible using the provided information. If all is good click “Add”.. Repeat this step for every separate Vcenter instance you run into.

ManageIQProvidersTake a little break at this point and let ManageIQ discover all of your hosts, vm’s , datastores etc etc.

  • After you have given Manage IQ some time to do what it does head back over to the “Configure” menu and select “Configuration” from the sub menu below. In the left pane select the “CMFE Region”  menu with the little globe to the left of it.
  • On the right click the menu ” C & U Collection” This is where you select which items you want to collect performance and utilization information on. I personally checked “Collect for all Clusters” and “Collect for all Datastores”  and then click on “Save” in the bottom right.
  • Now time to change the password to something more secure.. In the left pane there are a few other options click the one that says “Access Control”
  • Under “Users” select “Administrator” Click “Configuration” and “Edit this User” enter in a password in the appropriate field and click on “Save”
  • Now that we have everything set up head over to the “Infrastructure” Menu and click on “Hosts” in the left filter for “ALL” on the bottom right adjust the results per page to accommodate the amount of hosts you have. in the top left click “Check all”  then click the “Configuration” Option and select “Edit these hosts” (little pencil icon) add your ROOT credentials in these fields.. Choose the host to validate again and make sure they work and then click “Save” in the bottom right.
  • The last Item I will have you do is to go to the “Infrastructure” Menu and click on the “Virtual Machines” Menu and browser through the folders to locate your appliance (The VM you deployed earlier). Once you find it click on it and then click the “Configuration” Button and “Edit Management Engine Relationship”. And then select  the appliance name in the drop down and click save at the bottom.

Now you have a basic functioning Manage IQ instance… However I was interested checking out the Smartstate Analysis … And it turns out that the version botvinnik-1.20150629103140_eb92001 comes with a bugged version of the VixDiskLib library.. Which will give your errors in your “Tasks” (This is located in the “Configuration” menu under the sub menu “Tasks”) which look like this:

 

ManageIQVixDiskLib

So there are two things I needed to do to resolve these issues…

1. Install a new version of VDDK (seems to be fixed in 5.5.4) You can get the installer from here https://my.vmware.com/web/vmware/details?downloadGroup=VDDK554&productId=396

a. Place the .gz in a working directory

b. untar the .gz

 

[root@MIQSRV ~]# tar xzvf VMware-vix-disklib-5.5.4-2454786.x86_64.tar.gz
vmware-vix-disklib-distrib/
vmware-vix-disklib-distrib/include/
vmware-vix-disklib-distrib/include/vixMntapi.h
vmware-vix-disklib-distrib/include/vixDiskLibPlugin.h
vmware-vix-disklib-distrib/include/vm_basic_types.h
vmware-vix-disklib-distrib/include/vixDiskLib.h
vmware-vix-disklib-distrib/lib64/
vmware-vix-disklib-distrib/lib64/libvmomi.so
vmware-vix-disklib-distrib/lib64/libgmodule-2.0.so.0
vmware-vix-disklib-distrib/lib64/libcurl.so.4
vmware-vix-disklib-distrib/lib64/libvixMntapi.so.1
vmware-vix-disklib-distrib/lib64/libvixDiskLibVim.so.5
vmware-vix-disklib-distrib/lib64/libtypes.so
vmware-vix-disklib-distrib/lib64/libglib-2.0.so.0
vmware-vix-disklib-distrib/lib64/libdiskLibPlugin.so
vmware-vix-disklib-distrib/lib64/libgobject-2.0.so.0
vmware-vix-disklib-distrib/lib64/libvmacore.so
vmware-vix-disklib-distrib/lib64/libvixMntapi.so.1.1.0
vmware-vix-disklib-distrib/lib64/libssl.so.0.9.8
vmware-vix-disklib-distrib/lib64/libvixDiskLib.so
vmware-vix-disklib-distrib/lib64/libexpat.so.0
vmware-vix-disklib-distrib/lib64/libvixDiskLibVim.so
vmware-vix-disklib-distrib/lib64/libvixDiskLib.so.5
vmware-vix-disklib-distrib/lib64/libxml2.so.2
vmware-vix-disklib-distrib/lib64/libvixMntapi.so
vmware-vix-disklib-distrib/lib64/libvixDiskLib.so.5.5.0
vmware-vix-disklib-distrib/lib64/libgthread-2.0.so.0
vmware-vix-disklib-distrib/lib64/libvixDiskLibVim.so.5.5.0
vmware-vix-disklib-distrib/lib64/libcrypto.so.0.9.8
vmware-vix-disklib-distrib/lib64/libgvmomi.so.0
vmware-vix-disklib-distrib/FILES
vmware-vix-disklib-distrib/bin64/
vmware-vix-disklib-distrib/bin64/vmware-vdiskmanager
vmware-vix-disklib-distrib/bin64/vmware-uninstall-vix-disklib.pl
vmware-vix-disklib-distrib/etc/
vmware-vix-disklib-distrib/etc/installer.sh
vmware-vix-disklib-distrib/installer/
vmware-vix-disklib-distrib/installer/services.sh
vmware-vix-disklib-distrib/doc/
vmware-vix-disklib-distrib/doc/topics.html
vmware-vix-disklib-distrib/doc/intro.html
vmware-vix-disklib-distrib/doc/open_source_licenses.txt
vmware-vix-disklib-distrib/doc/intro_toc.html
vmware-vix-disklib-distrib/doc/foundrydoc.css
vmware-vix-disklib-distrib/doc/samples/
vmware-vix-disklib-distrib/doc/samples/diskLib/
vmware-vix-disklib-distrib/doc/samples/diskLib/vixDiskLibSample.cpp
vmware-vix-disklib-distrib/doc/samples/diskLib/Makefile
vmware-vix-disklib-distrib/doc/types/
vmware-vix-disklib-distrib/doc/types/VixDiskLibDiskType.html
vmware-vix-disklib-distrib/doc/types/typesList.html
vmware-vix-disklib-distrib/doc/types/VixDiskLibHwVersion.html
vmware-vix-disklib-distrib/doc/functions/
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Shrink.html
vmware-vix-disklib-distrib/doc/functions/removedfunctionList.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Cleanup.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_ReadMetadata.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Grow.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_GetInfo.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_ListTransportModes.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_GetMetadataKeys.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Attach.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Defragment.html
vmware-vix-disklib-distrib/doc/functions/supportGuest.html
vmware-vix-disklib-distrib/doc/functions/supportMatrix.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_GetErrorText.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_EndAccess.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_FreeInfo.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_PrepareForAccess.html
vmware-vix-disklib-distrib/doc/functions/handleclassList.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Connect.html
vmware-vix-disklib-distrib/doc/functions/deprecatedfunctionList.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_SpaceNeededForClone.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Read.html
vmware-vix-disklib-distrib/doc/functions/opclassList.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Exit.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Rename.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_InitEx.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_CreateChild.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_WriteMetadata.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_FreeErrorText.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Create.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Disconnect.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Init.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_GetTransportMode.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_ConnectEx.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Unlink.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Open.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Write.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Clone.html
vmware-vix-disklib-distrib/doc/functions/functionList.html
vmware-vix-disklib-distrib/doc/functions/VixDiskLib_Close.html
vmware-vix-disklib-distrib/doc/errors/
vmware-vix-disklib-distrib/doc/errors/errorsList.html
vmware-vix-disklib-distrib/doc/errors/foundrydoc.css
vmware-vix-disklib-distrib/doc/errors/errors.html
vmware-vix-disklib-distrib/doc/index.html
vmware-vix-disklib-distrib/doc/EULA
vmware-vix-disklib-distrib/doc/copyright.html
vmware-vix-disklib-distrib/vmware-install.pl

 

c. Move to the newly extracted folder and run the perl script that’s in there (this is quick and painless)

[root@MIQSRV ~]# cd vmware-vix-disklib-distrib/
[root@MIQSRV vmware-vix-disklib-distrib]# ls
bin64  doc  etc  FILES  include  installer  lib64  vmware-install.pl
[root@MIQSRV vmware-vix-disklib-distrib]# ./vmware-install.pl

2. Setting the proper port for the smartproxy

a. Back on the web console head over to the “Configure” -> “Configuration” Menu

b. On the left pane underneath “Zone” select “Server: (Zone name here) ”

c. On the right now (in the main pane not the top menu) select the tab that says “Smart ProxY” and change the default of “1139” to “902” and click save.

 

Notes:

If you made it this far you are a trooper.. I wanted to take some time to give credit where credit is due to the sources where I got my information from

http://talk.manageiq.org/t/smartstate-analysis-on-vmware-virtual-machines-not-working/105/13

https://www.youtube.com/watch?v=xRMP8M4JHzs

https://my.vmware.com/web/vmware/details?downloadGroup=VDDK554&productId=396

http://manageiq.org/documentation/top-tasks/

https://www.youtube.com/watch?v=qYPFktkWoCQ

 

 

Leave a Reply

Your email address will not be published.