git.sur5r.net Git - bacula/bacula/blob - bacula/platforms/contrib-rpm/README

   1 README file for bacula third party rpm contributors
   2
   3 Sun Jul 16 2006
   4 D. Scott Barninger
   5
   6 This document outlines the procedures to create rpm packages for
   7 bacula for platforms supported in the rpm spec file but not published
   8 on sourceforge. Contributors wishing to build and supply such rpm
   9 packages for release on the sourceforge project page should read this
  10 documentation. Contributors should contact either Kern Sibbald <kern@sibbald.com>
  11 or Scott Barninger <barninger@fairfieldcomputers.com>.
  12
  13 The general requirements to have contrib rpm packages published on the project
  14 page are:
  15
  16 1. Packages must be created using the current released source rpm and the
  17 shell script build_rpm.sh in this directory.
  18 2. The packager must sign all rpm packages with his/her personal gpg key
  19 and supply a copy of the public key as both a text file and as an rpm
  20 using the spec file rpmkey.spec in this directory.
  21 3. No modifications to either the bacula source code or spec file are
  22 permitted without consulting the project admins.
  23 4. There will be only one sanctioned packager for a given distribution.
  24 5. Contributors who submit two or more successful releases may be given
  25 release permissions to release their files directly to sourceforge. Prior to
  26 that you will need to coordinate the upload of your files to sourceforge with
  27 Kern or Scott to get them posted to the project page.
  28
  29 How to create an rpmkey package:
  30
  31 1. Create a plaintext copy of your gpg public key in a file named yourname.asc
  32 where yourname is in the form first initial and last name, ie. sbarninger.asc
  33 2. Edit the rpmkey.spec file and edit the line
  34         %define pubkeyname yourname
  35 replacing yourname with your name as in step 1 above.
  36 3. Edit the rpmkey.spec file and edit the line
  37         Packager: Your Name <your-email@site.org>
  38 inserting your name and email information.
  39 4. Copy your key file to your SOURCES directory and the spec file to your SPECS
  40 directory and create an rpm package.
  41 5. Both the key text file and the rpm will be published on sourceforge in your
  42 release package rpms-contrib-yourname.
  43
  44 How to build a release:
  45 1. Copy the file build_rpm.sh to a temporary working directory and open it in a
  46 text editor. Examine and edit the configuration section of the script to match
  47 your platform and build options. Set permissions on the script to 755.
  48 3. Download the srpm you wish to build to the same directory.
  49 4. Execute the script by ./build_rpm.sh
  50
  51 The script will build all the necessary packages, move them into the current
  52 working directory, rename them for your platform, and sign them with your key.
  53
  54 Note: you must have a file named .rpmmacros in your home directory containing
  55 at least the following 2 lines:
  56
  57 %_signature gpg
  58 %_gpg_name Your Name <your-email@site.org>
  59
  60 The name and email information in the above line must correspond to the information
  61 in the key used to sign the packages when you generated the key.