Mercurial > mxd2map

annotate HowTo-Release.txt @ 325:ebe500ec8a91

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update and clarify release instructions
author Andre Heinecke <aheinecke@intevation.de>
date Mon, 15 Oct 2012 11:42:28 +0200
parents 5e7e6d99f997
children
rev   line source
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
1 HowTo make a new MXD2map release
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
2 ================================
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
3
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
4 (replace the sample "0.2.0" with the apropriate version number)
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
5
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
6 1. Take care everything is checked in properly.
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
7 Adjust version numbers in
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
8 contrib/installer/MXD2map-installer.nsi (PRODUCT_VERSION)
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
9 doku/source/conf.py (version und release)
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
10 and commit and push! (analog previous releases in ChangeLog)
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
11
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
12 2. Create a source archive:
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
13 $ export MXD2MAPVERSION=0.8
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
14 $ hg archive -t tgz -X website -X HowToRelease.txt -X testdata-frida MXD2map-$MXD2MAPVERSION.tar.gz
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
15 $ sha1sum MXD2map-$MXD2MAPVERSION.tar.gz > MXD2map-$MXD2MAPVERSION.tar.gz.sha1
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
16
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
17 3. Create PDF-file of Documentation:
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
18 Prerequisites:
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
19 python-sphinx inkscape texlive-latex-extra texlive-fonts-recommended
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
20 $ cd doku && make latexpdf
269
7c8ae43bc465 * HowTo-Release.txt: Added some more hints for releses.
Stephan Holl <stephan.holl@intevation.de>
parents: 263
diff changeset
21 $ cp build/latex/MXD2map.pdf build/latex/MXD2map-$MXD2MAPVERSION.pdf
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
22
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
23 4. Create new source-release on 0.8 on wald and upload Documentation-PDF and MXD2map-0.8.tar.gz
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
24
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
25 4.1 Create Windows-Binary Installer (needs Windows-NSIS-Version and complete build)
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
26
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
27 4.1.1 Copy the Source Archive to a Windows system and extract it.
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
28
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
29 4.1.2 Make the dependencies available in the lib subfolder (See INSTALL.txt)
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
30
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
31 4.1.3 Build MXD2map:
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
32
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
33 $ ant jar-norevision
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
34
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
35 Copy resulting mxd2map.jar into contrib/installer/bin/
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
36
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
37 $ copy C:\tmp\build_sh\dist\mxd2map.jar contrib\installer\bin
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
38
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
39 4.1.4 Copy the dependendcies from lib to contrib/installer/bin/lib
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
40
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
41 $ xcopy /s lib\* contrib\installer\bin\lib
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
42
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
43 4.1.5 Fill contrib/installer/bin/mapserver with the appropiate mapserver version
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
44
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
45 4.1.6 Download example-data
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
46
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
47 $ cd contrib/installer/example/example/testdata-frida
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
48 $ wget ftp://ftp.intevation.de/freegis/frida/frida-1.0.1-shp.tar.gz
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
49 $ tar xvfz frida-1.0.1-shp.tar.gz
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
50 $ rm -f frida-1.0.1-shp.tar.gz
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
51
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
52 4.1.7 Build the installer (requires NSIS >= 2.46-2):
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
53
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
54 $ cd contrib/installer
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
55 $ makensis -DVERSION_DATE=`date +%d.%m.%Y` MXD2map-installer.nsi
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
56 $ sha1sum MXD2map-$MXD2MAPVERSION.exe > MXD2map-$MXD2MAPVERSION.exe.sha1
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
57
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
58 4.2 Test the installer by installing it on a Windows system and running the example.
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
59
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
60 4.3 Tag the release in HG:
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
61
271
58977f4b2cc5 Fixed tagline
Stephan Holl <stephan.holl@intevation.de>
parents: 269
diff changeset
62 $ hg tag -m "Tagged as release 'release-$MXD2MAPVERSION'" release-$MXD2MAPVERSION && hg push
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
63
325
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
64 4.4 Create new binary-release on Wald and upload
ebe500ec8a91 Update and clarify release instructions
Andre Heinecke <aheinecke@intevation.de>
parents: 324
diff changeset
65 MXD2map-$MXD2MAPVERSION.exe and corresponding sha1 hash.
269
7c8ae43bc465 * HowTo-Release.txt: Added some more hints for releses.
Stephan Holl <stephan.holl@intevation.de>
parents: 263
diff changeset
66
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
67 5. Update versions and URLs on the homepage (updates documentation as
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
68 well!) [requires sphinx available in $PATH]
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
69
269
7c8ae43bc465 * HowTo-Release.txt: Added some more hints for releses.
Stephan Holl <stephan.holl@intevation.de>
parents: 263
diff changeset
70 $ cd website && edit header.m4, download-de.htm4, download.htm4
263
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
71 $ hg commit -m "Updated Website to version $MXD2MAPVERSION, added download-links" && hg push
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
72 $ make online
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
73
4ce2d28971e9 Added HowtoRelease.txt-notes
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
74 6. Announce the new release on the mailing lists.
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)