From Fedora Project Wiki
Line 46: Line 46:
* Test example of <code>cgconfig.conf</code> from <code>scripts/doc/howto.txt</code> does not work.
* Test example of <code>cgconfig.conf</code> from <code>scripts/doc/howto.txt</code> does not work.
* Changing <code>/etc/cgconfig.conf</code> while cgconfig is running leads to a bunch of error messages if you try to restart it.
* Changing <code>/etc/cgconfig.conf</code> while cgconfig is running leads to a bunch of error messages if you try to restart it.
== User Experience ==
For now libcgroups package has several bug - so they  have to be fixed at first
<!-- If this feature is noticeable by its target audience, how will their experiences change as a result?  Describe what they will see or notice. -->
== Dependencies ==
Depends on kernel > 2.6.24 which is already in fedora and libcgroups which is (the last version 0.32.2) in fedora - the package is there from f-9.
<!-- What other packages (RPMs) depend on this package?  Are there changes outside the developers' control on which completion of this feature depends?  In other words, completion of another feature owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate?  Other upstream projects like the kernel (if this is not a kernel feature)? -->
== Contingency Plan ==
At first there have to be tested libcgroups to finds bugs and create more stable package - then there could be created any
<!-- If you cannot complete your feature by the final development freeze, what is the backup plan?  This might be as simple as "None necessary, revert to previous release behaviour."  Or it might not.  If you feature is not completed in time we want to assure others that other parts of Fedora will not be in jeopardy.  -->
== Documentation ==
* kernel documentation is: http://www.mjmwired.net/kernel/Documentation/cgroups.txt
libcg package -
* upstream sites: http://libcg.sourceforge.net/
* libcg: design and plans: http://lwn.net/Articles/271788/
== Release Notes ==
<!-- The Fedora Release Notes inform end-users about what is new in the release.  Examples of past release notes are here: http://docs.fedoraproject.org/release-notes/ -->
<!-- The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns.  If there are any such changes involved in this feature, indicate them here.  You can also link to upstream documentation if it satisfies this need.  This information forms the basis of the release notes edited by the documentation team and shipped with the release. -->
== Comments and Discussion ==
<!-- * See [[Talk:Features/YourFeatureName]]  <!-- This adds a link to the "discussion" tab associated with your page.  This provides the ability to have ongoing comments or conversation without bogging down the main feature page -->
----
[[Category:FeaturePageIncomplete]]
<!-- When your feature page is completed and ready for review -->
<!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler -->
<!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete-->
<!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process -->

Revision as of 13:27, 20 January 2009

?Feature? Name

ControlGroups

Summary

Improve the existing tools where necessary and feasible and/or to create new ones e.g. to create or modify persistent cgroups configuration (using libcgroups package).

Owner

Current status

  • Targeted release:
  • Last updated: 2009-01-19
  • Percentage of completion: 0%

Detailed Description

Since kernel 2.6.24, Linux has so called control groups as a means to partition available resources between running processes. Libcgroups makes that functionality available to programmers and contains two tools, cgexec and cgclassify, to start processes in a control group or move existing processes from one control group to another.

Our goals are to improve the existing tools where necessary and feasible and/or to create new ones e.g. to create or modify persistent cgroups configuration. At the beginning the focus will be on command line tools, but we'll keep in mind that in the long term we'll likely want to have graphical tools. These would offer similar functionality and we should try to make sure that any non-UI code written is usable from both kinds of frontends.

Benefit to Fedora

Libcgroups handles the new kernel features which are able to restrict the sources for tasks. This project should help the user to make the best of this feature.

Scope

currently in process

How To Test

For now it is necessary to have a kernel with cgroups support (Documentation/cgroups.txt) and the libcgroups package.

Start the cgconfig service:

  • Create the /etc/cgconfig.conf configuration file (the example is in the /samples section, the initscript from version 0.32.2 is able to create the mount point itself and mount the filesystem to it).
  • For each mount point create the relevant directory and mount it. The filesystem type is cgroup, so an fstab line would look like this:
cgroup                   <mount-point>                cgroup  defaults        0 0

or you can mount it manually with this command:

mount -t cgroup cgroup <mount-point>

(see scripts/doc/howto.txt - this mentions that the script would mount it but this doesn't seem to work, probably a problem in the cgroup init script)

  • Then you can start the service:

/sbin/service cgconfig start

Problems (in 0.32.2)

  • Test example of cgconfig.conf from scripts/doc/howto.txt does not work.
  • Changing /etc/cgconfig.conf while cgconfig is running leads to a bunch of error messages if you try to restart it.

User Experience

For now libcgroups package has several bug - so they have to be fixed at first

Dependencies

Depends on kernel > 2.6.24 which is already in fedora and libcgroups which is (the last version 0.32.2) in fedora - the package is there from f-9.

Contingency Plan

At first there have to be tested libcgroups to finds bugs and create more stable package - then there could be created any

Documentation

libcg package -


Release Notes

Comments and Discussion