From Fedora Project Wiki
< Features
(Test plan) |
|||
| Line 28: | Line 28: | ||
More detailed informations How To Test Matahari can be found in [https://github.com/matahari/matahari/wiki/TestPlan the Matahari Test Plan]. We are interested in a general community testing of currently available agents and core Matahari - for both local (DBus) and remote sides (QMF). We do not offer any special instruction for testing, just try to use Matahari for your tasks and report possible issues/enhancements. | More detailed informations How To Test Matahari can be found in [https://github.com/matahari/matahari/wiki/TestPlan the Matahari Test Plan]. We are interested in a general community testing of currently available agents and core Matahari - for both local (DBus) and remote sides (QMF). We do not offer any special instruction for testing, just try to use Matahari for your tasks and report possible issues/enhancements. | ||
<ol> | |||
<li/> Install Matahari agent | |||
<pre> | |||
# yum install matahari\* | |||
</pre> | |||
<li/> Start Matahari broker | |||
<pre> | |||
# systemctl start matahari-broker.service | |||
</pre> | |||
<li/> Start Matahari agent | |||
<pre> | |||
# systemctl start matahari-<agent>.service | |||
</pre> | |||
<li/> Test D-Bus interface <br /> | |||
For example get hostname from the Host agent | |||
<pre> | |||
$ dbus-send --system --dest=org.matahariproject.Host --print-reply /org/matahariproject/Host org.freedesktop.DBus.Properties.Get string:org.matahariproject.Host string:hostname | |||
</pre> | |||
Result should contain your hostname | |||
<pre> | |||
method return sender=:1.73 -> dest=:1.85 reply_serial=2 | |||
variant string "localhost.localdomain" | |||
</pre> | |||
<li/> Test QMF interface | |||
<pre> | |||
$ qmf-tool localhost:49000 | |||
qmf: list agents | |||
</pre> | |||
<pre> | |||
QMF Agents: | |||
Id Vendor Product Instance Epoch | |||
================================================================================== | |||
* 1 apache.org qpidd 971e8d8b-38f8-45ad-9ccf-f82ea85e3ed7 4 | |||
2 matahariproject.org host d0175049-b186-41a7-a10b-11589107c20a 4 | |||
3 matahariproject.org net 97e02c72-8ac4-4fd5-901b-77574af3d45c 2 | |||
4 matahariproject.org service bbf07d98-be32-4046-bf7b-c1d162b0611d 2 | |||
</pre> | |||
To verify the agents actually work we'll do some interactions with one. | |||
<pre> | |||
qmf: set default 2 | |||
</pre> | |||
<pre> | |||
Default Agent: matahariproject.org:host:d0175049-b186-41a7-a10b-11589107c20a | |||
</pre> | |||
<pre> | |||
qmf: query Host org.matahariproject | |||
</pre> | |||
<pre> | |||
Data Objects Returned: 1: | |||
Number Data Address | |||
============================================== | |||
1 26205118-e589-44ca-969d-d79b8ae40b2a | |||
qmf: show 1 | |||
Properties: | |||
Name Value | |||
===================================================== | |||
load {'1': 0.1, '5': 0.22, '15': 0.23} | |||
hostname localhost.localdomain | |||
... | |||
</pre> | |||
You should see properties with correct values for your system. | |||
</ol> | |||
<!-- This does not need to be a full-fledged document. Describe the dimensions of tests that this feature is expected to pass when it is done. If it needs to be tested with different hardware or software configurations, indicate them. The more specific you can be, the better the community testing can be. | <!-- This does not need to be a full-fledged document. Describe the dimensions of tests that this feature is expected to pass when it is done. If it needs to be tested with different hardware or software configurations, indicate them. The more specific you can be, the better the community testing can be. | ||
Revision as of 09:15, 8 July 2011
Matahari
Summary
Matahari is a collection of generically useful APIs accessible over a remote and local interfaces via a collection of Agents, and a framework for adding small set of Agents & APIs.
Owner
- Name: Jaroslav Reznik, Andrew Beekhof and the Matahari team
- Email: jreznik@redhat.com, andrew@beekhof.net and matahari@lists.fedorahosted.org
Current status
- Targeted release: Fedora 16
- Last updated: 2011-07-07
- Percentage of completion: 25%
Detailed Description
Benefit to Fedora
Scope
Currently Matahari scope is isolated as we're now working mostly on agents/interfaces side.
How To Test
More detailed informations How To Test Matahari can be found in the Matahari Test Plan. We are interested in a general community testing of currently available agents and core Matahari - for both local (DBus) and remote sides (QMF). We do not offer any special instruction for testing, just try to use Matahari for your tasks and report possible issues/enhancements.
-
Install Matahari agent
# yum install matahari\*Start Matahari broker
# systemctl start matahari-broker.serviceStart Matahari agent
# systemctl start matahari-<agent>.serviceTest D-Bus interface
For example get hostname from the Host agent
$ dbus-send --system --dest=org.matahariproject.Host --print-reply /org/matahariproject/Host org.freedesktop.DBus.Properties.Get string:org.matahariproject.Host string:hostname
Result should contain your hostname
method return sender=:1.73 -> dest=:1.85 reply_serial=2 variant string "localhost.localdomain"Test QMF interface
$ qmf-tool localhost:49000 qmf: list agents
QMF Agents: Id Vendor Product Instance Epoch ================================================================================== * 1 apache.org qpidd 971e8d8b-38f8-45ad-9ccf-f82ea85e3ed7 4 2 matahariproject.org host d0175049-b186-41a7-a10b-11589107c20a 4 3 matahariproject.org net 97e02c72-8ac4-4fd5-901b-77574af3d45c 2 4 matahariproject.org service bbf07d98-be32-4046-bf7b-c1d162b0611d 2
To verify the agents actually work we'll do some interactions with one.
qmf: set default 2
Default Agent: matahariproject.org:host:d0175049-b186-41a7-a10b-11589107c20a
qmf: query Host org.matahariproject
Data Objects Returned: 1:
Number Data Address
==============================================
1 26205118-e589-44ca-969d-d79b8ae40b2a
qmf: show 1
Properties:
Name Value
=====================================================
load {'1': 0.1, '5': 0.22, '15': 0.23}
hostname localhost.localdomain
...
You should see properties with correct values for your system.
User Experience
Dependencies
The dependencies are Qpid with QMFv2 (Qpid Management Framework).
Contingency Plan
As no packages in Fedora currently depends on Matahari we will continue with the development efforts in Rawhide.