- 1 How to match Subscriptions to Systems
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).
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.
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.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.getDetail(session, label)
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