Last modified by christoph_lechleitner@iteg_at on 2025-08-11 12.45:34

From version 3.1
edited by christoph_lechleitner@iteg_at
on 2019-03-22 11.21:15
Change comment: \n
To version 8.1
edited by christoph_lechleitner@iteg_at
on 2023-03-24 08.55:42
Change comment: Started on Debian 12 Bookworm

Summary

Details

Page properties
Content
... ... @@ -2,20 +2,22 @@
2 2  
3 3  About every 2 years Debian introduces a new release.
4 4  
5 -At the time I'm writing this Debian [[Buster>>url:https://wiki.debian.org/DebianBuster||shape="rect"]] is on it's way from Full Freeze to GA.
5 +The following notes shall provide a step-by-step-plan for adapting the [[PBA Package Builder + Archiver>>doc:PBA.WebHome]] to a new Debian release and shall make it more efficient for the next Debian.
6 6  
7 -The following notes shall provide a step-by-step-plan for adapting the [[PBA Package Builder + Archiver>>doc:PBA.WebHome]] to a new Debian release and shall make it more efficient for the next Debian or maybe Ubuntu release.
7 +The first version of this page was created when Debian [[Buster>>url:https://wiki.debian.org/DebianBuster||shape="rect"]] was on it's way from Full Freeze to GA, we were still using {{code language="none"}}svn{{/code}} back then (mostly {{code language="none"}}git{{/code}} now).
8 8  
9 +Currently we are in the progress of adapting from [[Bullseye>>url:https://wiki.debian.org/DebianBullseye||shape="rect"]] to [[Bookworm>>url:https://wiki.debian.org/DebianBookworm||shape="rect"]], so this is __WORK IN PROGRESS__ rg. Bookworm.
10 +
9 9  = {{id name="AdaptingPBAtonewDebianRelease-AdaptingpbatonewDebianRelease"/}}Adapting pba to new Debian Release =
10 10  
11 11  === {{id name="AdaptingPBAtonewDebianRelease-Preprations"/}}Preprations ===
12 12  
13 13  {{code}}
14 -OLDREL=stretch
15 -NEWREL=buster
16 +OLDDN=bullseye
17 +NEWDN=bookworm
16 16  
17 -cd ~/sources/pba/trunk/pba
18 -svn up ..
19 +# we prefix name of feature branches issue number or epic numbers
20 +ISSUENR="8" ; BRANCHNAME="${ISSUENR}_adapt_to_debian_${NEWDN}" ; echo "Branch name: ${BRANCHNAME}"
19 19  {{/code}}
20 20  
21 21  === {{id name="AdaptingPBAtonewDebianRelease-Adaptionsforphase1,towardsGA"/}}Adaptions for phase 1, towards GA ===
... ... @@ -23,22 +23,43 @@
23 23  In phase 1 we make the new distribution known in the sense of adding a template for distributions.d/.
24 24  
25 25  {{code}}
26 -cat src/etc/pba/distributions.d/${OLDREL} |sed -e "s/${OLDREL}/${NEWREL}/g" >src/etc/pba/distributions.d/${NEWREL}
27 -svn add src/etc/pba/distributions.d/${NEWREL}
28 +cd ~/sources/pba/pba/pba
28 28  
30 +git checkout main ; git pull ; git checkout main
31 +
32 +git branch ${BRANCHNAME} && git checkout ${BRANCHNAME} && git status
33 +
34 +git push --set-upstream origin ${BRANCHNAME}
35 +
36 +cat src/etc/pba/distributions.d/${OLDDN} |sed -e "s/${OLDDN}/${NEWDN}/g" >src/etc/pba/distributions.d/${NEWDN}
37 +${EDITOR:-vi} src/etc/pba/distributions.d/${NEWDN}
38 +
39 +git add src/etc/pba/distributions.d/${NEWDN}
40 +
29 29  # evtl. drop ancient ones
30 -svn rm src/etc/pba/distributions.d/
42 +git rm src/etc/pba/distributions.d/foobar
31 31  
32 -${EDITOR:-vi} debian/changelog debian/rules debian/pba-common.install src/etc/pba/distributions.d/${NEWREL} debian/control
44 +pba-raiseversion
45 +
46 +pba-raiseversion -b 1.6.31-0 "Adapting to distribution Debian 12 Bookworm"
47 +
48 +${EDITOR:-vi} debian-unix/rules debian*/pba-common.install src/etc/pba/distributions.d/${NEWDN}
49 +# debian-unix/control
33 33  # src/etc/pba/builder.conf.template src/lib/build-functions.pl
34 34  
35 35  # commit
36 -svn commit -m "Adding support for new Debian distro ${NEWREL}"
53 +git commit -m "Adding support for new Debian distro ${NEWDN}"
37 37  
38 -# release it
55 +git push
56 +
57 +# evtl. release it locally, or in Gitlab
39 39  pba-release
59 +
60 +
40 40  {{/code}}
41 41  
63 +=== {{id name="AdaptingPBAtonewDebianRelease----currentpointofadaptiontoDebianBookworm---"/}}**~-~-- current point of adaption to Debian Bookworm ~-~--** ===
64 +
42 42  === {{id name="AdaptingPBAtonewDebianRelease-CreatePBA-Buildertarballs"/}}Create PBA-Builder tarballs ===
43 43  
44 44  See eventual separate notes (my [[ITEG's PBA-Tarball Notes>>url:https://confluence.iteg.at/x/l4Kg||shape="rect"]] are not public, sorry).
... ... @@ -45,16 +45,78 @@
45 45  
46 46  === {{id name="AdaptingPBAtonewDebianRelease-AdaptHelloWorldProjects"/}}Adapt HelloWorld Projects ===
47 47  
48 -TBD.
71 +{{code language="none"}}
72 +cd ~/sources/pba/trunk/pba-helloworld
49 49  
50 -=== {{id name="AdaptingPBAtonewDebianRelease-AdaptFANCYLIBS"/}}Adapt [[doc:FANCYLIBS.WebHome]] ===
74 +git checkout main ; git pull ; git checkout main
51 51  
52 -TBD.
76 +git branch ${BRANCHNAME} && git checkout ${BRANCHNAME} && git status
53 53  
78 +git push --set-upstream origin ${BRANCHNAME}
79 +
80 +pba-raiseversion
81 +# decide next version
82 +pba-raisversion -b 1.2.3 "Adding new Debian target distro ${NEWDN}"
83 +
84 +git add debian*/control debian*/changelog
85 +
86 +PBAO="."
87 +# or
88 +PBAO="arch|unix"
89 +# or in phase 2 or when combining
90 +PBAO="arch|unix|7"
91 +
92 +#pba-builddeps -i -o ${PBAO}
93 +
94 +#pba-instdeps -i -o ${PBAO}
95 +
96 +pba-build -u -i -o ${PBAO}
97 +
98 +# solve eventual problems
99 +
100 +PBADD=$(ls -1d debian* |grep -v mingw |head -1)
101 +${EDITOR:-vi} ${PBADD}/changelog ${PBADD}/control
102 +
103 +pba-localbuild -u -o ${PBAO}
104 +
105 +# evtl.
106 +#pba-localrpmbuild -u -o ${PBAO}
107 +
108 +# wait for success
109 +
110 +git commit -m "Adding support for new Debian distro ${NEWDN}"
111 +git push
112 +
113 +# optional, eventually after merge in main
114 +pba-release -o ${PBAO}
115 +
116 +
117 +{{/code}}
118 +
119 +LATER (after adapting Fancylibs below) repeat for {{code language="none"}}pba-helloworld-portable{{/code}} (with {{code language="none"}}-o unix{{/code}}).
120 +
121 +Repeat for {{code language="none"}}pba-hellolib-portable{{/code}} (with {{code language="none"}}-o unix{{/code}}).
122 +
123 +Repeat for {{code language="none"}}pba-hellobigworld-portable{{/code}} (with {{code language="none"}}-o unix{{/code}}).
124 +
125 +... with (% style="letter-spacing: 0.0px;" %){{code language="none"}}-o unix{{/code}}(%%) or later (% style="letter-spacing: 0.0px;" %){{code language="none"}}-o "unix|9"{{/code}}(%%).
126 +
127 +=== {{id name="AdaptingPBAtonewDebianRelease-AdaptFANCYLIBS"/}}Adapt [[doc:FANCYLIBS.WebHome]] ===
128 +
129 +See [[Adapting FancyLibs & MinGW-Pkg from Debian 9 Stretch to 10 Buster, Mingw-7 to Mingw-8>>doc:FANCYLIBS.Adapting FancyLibs & MinGW-Pkg from Debian 9 Stretch to 10 Buster, Mingw-7 to Mingw-8.WebHome]].
130 +
131 +=== {{id name="AdaptingPBAtonewDebianRelease-Adaptpba-helloworld-portable"/}}Adapt pba-helloworld-portable ===
132 +
133 +See above, use {{code language="none"}}-o unix{{/code}}.
134 +
54 54  === {{id name="AdaptingPBAtonewDebianRelease-AdaptMinGW"/}}Adapt [[MinGW>>doc:MINGW64.WebHome]] ===
55 55  
56 56  See [[doc:MINGW64.mingw 6 rebuild order.WebHome]].
57 57  
139 +=== {{id name="AdaptingPBAtonewDebianRelease-MinGW-Adaptpba-hello*-portable"/}}MinGW-Adapt pba-hello*-portable ===
140 +
141 +See above, with -o "unix|9" instead of "-o unix".
142 +
58 58  === {{id name="AdaptingPBAtonewDebianRelease-Adaptionsforphase2,oncenewreleaseissettled"/}}Adaptions for phase 2, once new release is settled ===
59 59  
60 60  Once the new Debian release is settled and all VIP libraries and current projects can be built for it, we can declare it the new default value for {{code language="none"}}DefaultDistribution{{/code}} in {{code language="none"}}pba-builder.conf{{/code}}.
... ... @@ -63,7 +63,7 @@
63 63  ${EDITOR:-vi} debian/changelog src/etc/pba/builder.conf.template src/lib/build-functions.pl
64 64  
65 65  # commit
66 -svn commit -m "Making new Debian distro ${NEWREL} default for DefaultDistribution in pba-builder.conf"
151 +git commit -m "Making new Debian distro ${NEWDN} default for DefaultDistribution in pba-builder.conf"
67 67  
68 68  # release it
69 69  pba-release
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -659142
1 +968687752
URL
... ... @@ -1,1 +1,1 @@
1 -https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659142/Adapting PBA to new Debian Release
1 +https://clazzes.atlassian.net/wiki/spaces/PBA/pages/968687752/Adapting PBA to new Debian Release