From Fedora Project Wiki
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
= cron-to-systemd-time-units =
= cron to systemd time units =


== Summary ==
== Summary ==


Introducing new systemd documentation feature along with various units cleanups.
Fix dependency on crontab in packages containing cron jobs as well as migrate cron jobs that are applicable to native systemd timer units.


== Owner ==
== Owner ==
Line 13: Line 13:
* Targeted release: [[Releases/Fedora 21 | Fedora 21 ]]  
* Targeted release: [[Releases/Fedora 21 | Fedora 21 ]]  
* Last updated:  
* Last updated:  
* Percentage of completion: 21
* Percentage of completion: 20


== Detailed Description ==
== Detailed Description ==


 
Add dependency on crontab in packages containing cron jobs as well as migrate cron jobs that are applicable to native systemd timer units in packages that already depend on systemd.


== Benefit to Fedora ==
== Benefit to Fedora ==


Adding the Documentation Field will bring more informational status output to our users base which links to the relevant man pages for the daemon/service.
Proper dependency in packages shipping cron jobs.
 
Better systemd integration in the distribution.
EnvironmentalFiles that reside in /etc/sysconfig directory are Fedora specific which makes those unit not upstream feasible and work against the de-balkanization of the Linux platform.
 
If it's truly necessary for those environment files to be continued to be used which is rather exception than a rule since users/administrator should be using [https://fedoraproject.org/wiki/Systemd#How_do_I_customize_a_unit_file.2F_add_a_custom_unit_file.3F  How_do I customize a unit file ] when altering daemon/service startup, they should be placed in a subdir directly in /etc with the name of the package/subsystem and the environment file reference point to that instead.
 


== Scope ==
== Scope ==


* Adjust packaging guidelines to fix dependency in cron packages [[Packaging/CronFiles| Package Cron Files]] DONE
* Adjust packaging guidelines to fix dependency in cron packages [[Packaging/CronFiles| Package Cron Files]] DONE
* Fix spec files in packages that are not applicable for migration [[ Tracker bug]]  
* Fix spec files in packages that are not applicable for migration [https://bugzilla.redhat.com/show_bug.cgi?id=947037 Fix Cron Dependency Tracking Bug]
* Review and migrate if applicable cron jobs shipped in packages that already depend on systemd
* Adjust packaging guidelines to mention migration of cron jobs to timer units for packages that already depend on systemd
*  
* Review and migrate if applicable cron jobs shipped in packages that already depend on systemd [https://bugzilla.redhat.com/show_bug.cgi?id=991679 Timer Migration Tracking Bug]
* Update systemd wikipage to contain timer units example


== How To Test ==
== How To Test ==


*Install/update to the package that contains the new native systemd unit file.
* Install the package that contains the new native systemd timer unit file.
**Check if the update process happened cleanly
* Check if the the time trigger ran
**Check if the service starts cleanly after install
**check if the service stops cleanly after and install
**Check if the service reloads cleanly correctly if applicable
**Check if the service status output contains reference to the relevant man pages
 
*Enable the service then restart
**check if the shutdown process happened cleanly with the service enabled
**check if the service started cleanly at startup


== User Experience ==
== User Experience ==


Other than the added informative documentation field in the units status output the user should not notice any change.
Administrators will have better time trigger in units compared to cron jobs like for example when administrator stops a service/daemon the timer unit will stop as well etc.  


== Dependencies ==
== Dependencies ==
Line 58: Line 47:
== Contingency Plan ==
== Contingency Plan ==


Continue to ship the cron jobs as is
Continue to ship the cron jobs as is.


== Documentation ==
== Documentation ==


* It's recommended that documentation for relevant applications that contained and used EnvironmentFile reference points users to [https://fedoraproject.org/wiki/Systemd#How_do_I_customize_a_unit_file.2F_add_a_custom_unit_file.3F  How_do I customize a unit file ] use instead when altering daemon/service startup.
* updated guidelines and systemd wiki page


== Release Notes ==
== Release Notes ==
Line 71: Line 60:
* See [[Talk:Features/cron-to-systemd-time-units]]  <!-- 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 -->
* See [[Talk:Features/cron-to-systemd-time-units]]  <!-- 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]]
[[Category:ChangePageIncomplete]]
<!-- When your feature page is completed and ready for review -->
<!-- When your feature page is completed and ready for review -->
<!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler -->
<!-- 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-->
<!-- 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 -->
<!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process -->

Latest revision as of 11:52, 4 March 2014

cron to systemd time units

Summary

Fix dependency on crontab in packages containing cron jobs as well as migrate cron jobs that are applicable to native systemd timer units.

Owner

Current status

  • Targeted release: Fedora 21
  • Last updated:
  • Percentage of completion: 20

Detailed Description

Add dependency on crontab in packages containing cron jobs as well as migrate cron jobs that are applicable to native systemd timer units in packages that already depend on systemd.

Benefit to Fedora

Proper dependency in packages shipping cron jobs. Better systemd integration in the distribution.

Scope

  • Adjust packaging guidelines to fix dependency in cron packages Package Cron Files DONE
  • Fix spec files in packages that are not applicable for migration Fix Cron Dependency Tracking Bug
  • Adjust packaging guidelines to mention migration of cron jobs to timer units for packages that already depend on systemd
  • Review and migrate if applicable cron jobs shipped in packages that already depend on systemd Timer Migration Tracking Bug
  • Update systemd wikipage to contain timer units example

How To Test

  • Install the package that contains the new native systemd timer unit file.
  • Check if the the time trigger ran

User Experience

Administrators will have better time trigger in units compared to cron jobs like for example when administrator stops a service/daemon the timer unit will stop as well etc.

Dependencies

No external dependency

Contingency Plan

Continue to ship the cron jobs as is.

Documentation

  • updated guidelines and systemd wiki page

Release Notes

There shouldn't be anything we need to specifically say other than highlighting the change.

Comments and Discussion