Difference between revisions of "SUSE Manager/SubscriptionCounting"

From MicroFocusInternationalWiki
Jump to: navigation, search
(minor fixes)
Line 3: Line 3:
 
==Gather Information about Foreign Virtual Hosts==
 
==Gather Information about Foreign Virtual Hosts==
  
A pre requirement to match subscriptions to systems is to have complete information about which virtual system run on which virtual host.
+
A pre-requirement to match subscriptions to systems is to have complete information about which virtual system runs on which virtual host.
SUSE Manager already gets this information if the hypervisor is running on SLES or RedHat.
+
SUSE Manager gets this information without any further configuration if the hypervisor is a registered system running on SLES or RedHat Enterprise Linux. Third party hypervisors, like VMware or Hyper-V, need configuration described in this page.
  
In SUSE Manager 2.1 we could not get these information from third party hypervisors like VMware or Hyper-V. In SUSE Manager 3 we have a
+
Third party hypervisors and hypervisor managers such as VMWare vCenter are called "Virtual Host Managers" in SUSE Manager, as they are able to manage one or multiple virtual hosts, which in turn may contain virtual guests.
tool (virtual-host-gatherer) which can connect to several hypervisors using their API, request the required information and store them
+
into the SUSE Manager database.
+
  
==Configure Virtual Host Managers==
+
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.
  
A Virtual Host Manager is a system/program that manages virtual hosts. It has an API which can be used from outside to get information about
+
virtual-host-gatherer has the concept of optional modules - each module enables a specific Virtual Host Manager "type" to be used (eg. VMware).
one or more virtual hosts managed by it.
+
  
In SUSE Manager 3 you can configure virtual host manager to regularly get information about your virtual hosts and virtual systems in your
+
===Configuring Virtual Host Managers via XMLRPC API===
environment.
+
  
===XMLRPC API for the Virtual Host Manager===
+
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.listAvailableGathererModules(session)
 
* virtualhostmanager.getGathererModuleDetail(session, moduleName)
 
 
* virtualhostmanager.listVirtualHostManagers(session)
 
* virtualhostmanager.listVirtualHostManagers(session)
 
* virtualhostmanager.getDetail(session, label)
 
* virtualhostmanager.getDetail(session, label)
* virtualhostmanager.create(session, label, moduleName, parameter)
 
* virtualhostmanager.delete(session, label)
 
  
==Run the virtual-host-gatherer==
 
  
The virtual-host-gatherer is a small tool which connect to hypervisors and return information about  
+
==Running virtual-host-gatherer==
the virtual hosts and virtual systems run on them. In SUSE Manager 3 there is a taskomatic job executing
+
 
this once per day.  
+
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 the job while clicking in the WebUI on
+
You can manually start it via the WebUI as with any Taskomatic job:
  
 
   Admin => Task Schedules => gatherer-bunch => Single Run Schedule
 
   Admin => Task Schedules => gatherer-bunch => Single Run Schedule

Revision as of 15:16, 15 October 2015

How to match Subscriptions to Systems

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 SLES 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" 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).

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