]> git.sur5r.net Git - bacula/bacula/blob - bacula/release/ReleaseProcedure.txt
Tweak git2changelog.pl
[bacula/bacula] / bacula / release / ReleaseProcedure.txt
1
2 These are the steps to complete for making a new release.
3
4 1. Ensure that the previous release had a tag pushed. If
5    not create one at the prior release point and push it
6    to the repos.
7
8 2. Update the ChangeLog using release/git2changelog.pl Release-5.2.x..HEAD >1
9
10 3. Edit 1 into ChangeLog ensuring to mark the previous release
11    Version number prior to adding the new ChangeLog output.
12
13 4. Edit the ReleaseNotes. Be sure not to change anything in the
14    prior version (typos are OK).  This sometimes means duplicating
15    text, but it is far better to have a complete history.
16    Terminate the previous release with a line of all =====,
17    and ensure that the previous release version is properly
18    defined.  Then add the new release section.  Point out
19    the need to review prior releases if changing major versions.
20
21 5. Update the version and date.
22
23 6. Update the po files (cd po; make update-po).  Correct any
24    problems and re-run until correct.
25
26 7. Update the docs. Make sure they have the correct date, and
27    that the new docs are uploaded to bacula.org
28
29 8. Make sure everything is pushed including the docs.
30
31 9. Diff the prior version against the current one:
32     git diff Release-5.2.1..HEAD >diff (where 5.2.1 is the prior)
33    and check for debug messages that have level zero, new text
34    in non-debug messages that is not setup for translation.
35
36 10. Run a full regression test (./nightly-all) on as many
37    platforms as possible.
38
39 11. Check the CDash Bacula output pages to make sure there are
40     no overlooked problems.
41
42 12. Cut the release (i.e. make the .tar.gz files) by copying
43    the release directory out of the build tree, ensuring that
44    your config file is properly set, and that your signing
45    key is properly setup, and running the ./makeall script.
46
47 13. Ensure that the Windows builds were done properly.
48
49 14. detar the main bacula source release
50
51 15. Run a regression on the detared file (ensures that all files
52     are actually in the tar and that it is not corrupt).
53
54 16. push the tags (once pushed they can be corrected but it is more
55     complicated than simply re-running the ./makeall script)
56
57 17. Upload the release files to Source Forge.
58
59 18. Update the release version and date on the main bacula.org page
60
61 19. Update the news item to announce the release.
62
63 20. Send the release announcement to the users, devel, and announce 
64     mailing lists.