Package: slapos.package
slapos.package***************SlapOS Package is a simple tool which aims on keep a packages updates on a Linux Distribution. The SlapOS Package can support multi distributions and use a simple signature file for take decision to upgrade or not the computer.Basic Commands===============* slappkg-update: Perform the update, if requested.* slappkg-discover: Prints the system signature, used to match with signature-list to decide which section to use.* slappkg-upload-key: Uploads the signature configuration.* slappkg-conf: Creates initial update.cfg and cron entry.Basic Usage============.. code:: bash# Generates initial configurationslappkg-conf --slapos-configuration=update.cfg# Runs updateslappkg-update --slapos-configuration=update.cfgUpgrade Signature File=======================The signature file is composed by at least 2 sections:System Section ([system]) where is defines reboot and upgrade expected dates. Ifserver was upgraded before the dates present there, the upgrade will be triggerfor packages (This only affects core promise).Example:.. code:: text[system]reboot = 2011-10-10upgrade = 2014-02-20Distribution sections can have any other name choses by the user and it shouldcontains the follow entries (always use new line for multiple values):* repository-list: define a list of repository entries, defined by (name = value).Special minor notations explaned futher.* filter-package-list: list of package names that are going to be keep installed andupdated.* filter-promise-list: list of promises that are enabled for this distribution. The usercan decide which promises are going to be checked on every run. If thissection is not present, all promises available are going to be checked.* signature-list: defines which systems the promises are applicable on. The signature forevery system can be found by slappkg-discover command. If None signaturematches, the system will not be upgraded.Example:.. code:: text[debian-default]repository-list =main = http://ftp.fr.debian.org/debian/ wheezy mainmain-src = http://ftp.fr.debian.org/debian/ wheezy mainupdate = http://ftp.fr.debian.org/debian/ wheezy-updates mainupdate-src = http://ftp.fr.debian.org/debian/ wheezy-updates mainslapos = http://download.opensuse.org/repositories/home:/VIFIBnexedi/Debian_7.0 ./re6stnet = http://git.erp5.org/dist/deb ./filter-package-list =ntpslapos.nodere6stnetfilter-promise-list =corehostnamesignature-list =debian+++jessie/sid+++Configuration Examples========================* Example of update.cfg:.. code:: text[slapupdate]# Change this key for customise your upgrade.upgrade_key = 'slapos-generic-upgrade-key'[networkcache]download-binary-cache-url = http://www.shacache.org/shacachedownload-cache-url = https://www.shacache.org/shacachedownload-binary-dir-url = http://www.shacache.org/shadir# It is important to use only trustfull keys.signature-certificate-list =-----BEGIN CERTIFICATE-----MIIB8DCCAVmgAwIBAgIJAPFf61p8y809MA0GCSqGSIb3DQEBBQUAMBAxDjAMBgNVBAMMBUNPTVAtMCAXDTE0MDIxNzE2NDgxN1oYDzIxMTQwMTI0MTY0ODE3WjAQMQ4wDAYDVQQDDAVDT01QLTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAsiqCyuv1HO9FmtwnMbEa1/u8Dn7T0k7hVKYXVQYof+59Ltbb3cA3nLjFSJDr/wQT6N89MccSPneRzkWqZKL06Kmj+N+XJfRyVaTz1qQtNzjdbYkO6RgQq+fvq2CO0+PSnL6NttLU/a9nQMcVm7wZ8kmY+AG5LbVo8lmxDD16Wq0CAwEAAaNQME4wHQYDVR0OBBYEFEViYyWHF3W7/O4NaTjn4lElLpp7MB8GA1UdIwQYMBaAFEViYyWHF3W7/O4NaTjn4lElLpp7MAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAgIPGoxhUa16AgjZxJr1kUrs8Fg3ig8eRFQlBSLYfANIUxcQ2ScFAkmsvwXY3Md7uaSvMJsEl2jcjdmdieSreNkx85j9GtMLY/2cv0kF4yAQNRtibtDkbg6fRNkmUopDosJNVf79l1GKX8JFLzZBOFdOaLYY/6dLRwiTUKHU6su8=-----END CERTIFICATE-----* Example of upgrade signature:.. code:: text[debian-default]repository-list =main = http://ftp.fr.debian.org/debian/ wheezy mainmain-src = http://ftp.fr.debian.org/debian/ wheezy mainupdate = http://ftp.fr.debian.org/debian/ wheezy-updates mainupdate-src = http://ftp.fr.debian.org/debian/ wheezy-updates mainslapos = http://download.opensuse.org/repositories/home:/VIFIBnexedi/Debian_7.0 ./re6stnet = http://git.erp5.org/dist/deb ./filter-package-list =ntpslapos.nodere6stnetfilter-promise-list =corehostnamesignature-list =debian+++jessie/sid+++[opensuse-legacy]repository-list =suse = http://download.opensuse.org/distribution/12.1/repo/oss/slapos = http://download.opensuse.org/repositories/home:/VIFIBnexedi/openSUSE_12.1re6st = http://git.erp5.org/dist/rpmfilter-package-list =ntpslapos.nodere6stnetsignature-list =opensuse+++12.1+++x86_64[system]reboot = 2011-10-10upgrade = 2014-02-20Changes========0.2.1.1 (2014-07-15)------------------* Minor fixes [Rafael Monnerat]0.2.1 (2014-07-15)------------------* Fix test inconsistencies [Rafael Monnerat]* Implement download of repositories keys [Rafael Monnerat]0.2.0 (2014-06-15)------------------* Included a lot of tests [Rafael Monnerat]* Minor fixed on general code [Rafael Monnerat]* Include limits promise [Rafael Monnerat]0.1.2 (2014-06-05)------------------* Fix slapos.libnetworkcache usage [Rafael Monnerat]0.1.1 (2014-02-28)------------------* Included slappkg-conf [Rafael Monnerat]* Fixed README.txt syntax [Rafael Monnerat]0.1 (2014-02-28)----------------* Initial Stable Release [Rafael Monnerat]0.0.1.4 (2014-02-24)---------------------* Initial Release of Basic Functions for Debian/Ubuntu and OpenSuse. [Rafael Monnerat]