SUSE Manager/SubscriptionCounting

From MicroFocusInternationalWiki
Revision as of 07:54, 7 January 2016 by SilvioMoioli (Talk | contribs) (Gather Information about Foreign Virtual Hosts)

Jump to: navigation, search

How to match Subscriptions to Systems

SUSE Manager 3 automatically generates nightly reports with the matching status of your SUSE subscriptions with all the registered systems.

Those reports are stored in /var/lib/spacewalk/subscription-matcher in CSV format and can be opened with any spreadsheet application such as LibreOffice Calc.

If you want to schedule those reports to be produced at a different time, with a different frequency or if you want to schedule a one-off execution you can do it by editing the Taskomatic settings for the gatherer-matcher bunch:

Admin -> SUSE Manager Configuration -> Task Schedules -> gatherer-matcher-default

Gather Information about Foreign Virtual Hosts

A pre-requirement to match subscriptions to systems is to have complete information about which virtual system runs on which virtual host. SUSE Manager gets this information without any further configuration if the hypervisor is a registered system running on SUSE Linux Enterprise Server or RedHat Enterprise Linux. Third party hypervisors, like VMware or Hyper-V, need configuration described in this page.

Third party hypervisors and hypervisor managers such as VMWare vCenter are called "Virtual Host Managers" (VHM) in SUSE Manager, as they are able to manage one or multiple virtual hosts, which in turn may contain virtual guests.

SUSE Manager 3 ships with a tool (virtual-host-gatherer) that can connect to VHMs using their API, request information about virtual hosts. This tool is automatically invoked via Taskomatic every night - you just need to configure your VHMs via XMLRPC APIs.

virtual-host-gatherer has the concept of optional modules - each module enables a specific Virtual Host Manager "type" to be used (eg. VMware).

Available virtual-host-gatherer modules

  • VMWare: supports VMware products running on the vSphere operating system, currently VMware ESX, ESXi and vCenter
  • File: read data from a plain json file which could be obtained from another virtual-host-gatherer instance (typically from a different disconnected network which has direct access to VHMs) or created manually. See the man page for a specification of the expected json format.

In future more modules might be made available, for example to support Microsoft Hyper-V.

Coexistence of the virtual-host-gatherer and poller

virtual-host-gatherer shouldn't be used for gathering the data from hypervisors that are registered systems in SUSE Manager (running SLES or RES). Information from such hypervisors is already retrieved using the poller utility and having the redundant information from virtual-host-gatherer may cause problems.

Configuring Virtual Host Managers from the Web UI

The Web UI for configuring the Virtual Host Managers can be found under:

 Systems => Virtual Host Managers

If you select it, you will see a list of already configured VHMs. To add a new VHM you can select the links in the top right corner. E.g. Add VMware-based Virtual Host Manager or Add File-based Virtual Host Managers. After you selected the module, you see the configuration fields. Some maybe pre-filled with typical values for this module.

The VHM is created when you click on the Add Virtual Host Manager Button.

The new VHM should now be listed in the Overview page. If you click on the name, you can see the configuration details of this VHM and you can delete it by clicking on Delete Virtual Host Manager button or trigger a refresh by clicking on the Refresh data from this Virtual Host Manager.

At the end of a successful run, you should see your Virtual Host Managers in the Systems list.

Configuring Virtual Host Managers via XMLRPC API

The following APIs allow you to get a list of available virtual-host-manager modules and the parameters they require:

  • virtualhostmanager.listAvailableVirtualHostGathererModules(session)
  • virtualhostmanager.getModuleParameters(session, moduleName)

The following APIs allow you to create and delete VHMs. Take care that the module parameter map must match the map returned by virtualhostmanager.getModuleParameters to work correctly:

  • virtualhostmanager.create(session, label, moduleName, parameters)
  • virtualhostmanager.delete(session, label)

The following APIs return information about configured VHMs:

  • virtualhostmanager.listVirtualHostManagers(session)
  • virtualhostmanager.getDetail(session, label)

Running virtual-host-gatherer

The virtual-host-gatherer is a tool which connects to VHMs and returns information about the virtual hosts and virtual systems running on them. In SUSE Manager 3 there is a Taskomatic job executing it nightly.

You can manually start it via the WebUI as with any Taskomatic job:

 Admin => Task Schedules => gatherer-bunch => Single Run Schedule

Additionally you can go to the VHM Overview page at

 Systems => Virtual Host Managers

Behind every item there is a Refresh button which will run the virtual-host-gatherer only for this VHM.

The Subscription Matcher

To match Subscriptions to System we implemented a tool called subscription-matcher. It gets information about systems, subscriptions and pinned matches (fixed customer defined subscriptions to systems mapping) as input and returns the best possible match according to the SUSE Terms and Conditions.

The subscription-matcher is also able to write some CSV Reports:

  • Subscription Report - Subscriptions data with its usage
  • Unmatched Systems Report - Systems where a match to a subscription could not be found
  • Error Report - a list of errors raised during the matching