From Fedora Project Wiki
(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

  • 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.

  1. Install Matahari agent
    # yum install matahari\*
    
  2. Start Matahari broker
    # systemctl start matahari-broker.service
    
  3. Start Matahari agent
    # systemctl start matahari-<agent>.service
    
  4. Test 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"
    
  5. 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.

Documentation

Release Notes

Comments and Discussion