Working With Systems
--------------------

Systems are the representation of physical build hosts known as 'workers'.  
These are systems that are running the worker daemon, and handle build tasks
when assigned to them by the regulator process.

Systems are not generally created manually, but rather created and updated
on the fly by the worker daemon when the process is started, and cycles.


Creating a System
^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf system create -l <label> --etc --etc
    
*Note: As mentioned, systems are created by the worker daemon logging in from
that system.*


Updating a System
^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf system update <label> --etc --etc
    

Deleting a System
^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf system delete build00


Listing Systems
^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf system listall
    build00
    build01
    build02
    build04
    
    $ mf system listall -f 04
    build04
    


There is also a quick view display for systems:

.. code-block:: text

    $ mf system quickview
    
    system                            load          tasks    status
    --------------------------------  ------------  -------  ---------------------
    build00                           10.8  / 16.0  6        Online/Enabled
    build01                           1.3   / 4.0   2        Online/Enabled
    build02                           1.1   / 2.0   1        Online/Enabled
    build03                           0.0   / 8.0   0        Offline/Disabled
    

*Note: The 'load' displays the 'current_load / max_load' where in if the 
current load is more than the max load allowed for that system, no more tasks
will be assigned to it.  The status is made up of 'online/status' where if
the system is no longer checking then Online because Offline.  If a system
is Offline for an amount of time it will be automatically disabled (per the
settings to do so on the server).*


Showing Data For a System
^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf system show build00
    
              Label | build00                                                        
           Hostname | build00.example.com
                 IP | 127.0.0.1                                                          
           Platform | Linux-2.6.35.6-48.fc14.x86_64-x86_64-with-fedora-14-Laughlin     
         Created By | mf-system                                                          
         Created On | 2010-11-30 19:12:58                                                
        Last Update | 2010-12-01 08:20:11                                            
       Last Checkin | 2010-11-30 21:57:31                                            
             Status | Enabled                                                          
             Online | True                                                            
       Current Load | 0.8                                                                
           Max Load | 8.0                                                                
        Build Count | 2134521                                                                  

              Archs | i386
                      x86_64
                  
     Build Handlers | generic_build
                      mock
                  
              Tasks | php52-5.2.14-12.1.el5.i386
                      mysql-5.1.51-2.fc14.x86_64