Upgrading eclipse-titan in the Osmocom OBS¶

This article explains how maintainers of obs.osmocom.org can upgrade the eclipse-titan package.

Running the testsuite against new/different versions of eclipse can be done with *-titan-master in docker-playground (see this patch).

Requirements:

• dpkg-buildpackage
• dpkg-source
• osc
• uupdate
• wget

1. Create a test project, e.g. home:username:latest
2. Copy the existing package to your test project:

$ osc copypac osmocom:latest eclipse-titan home:yourusername:latest
Sending meta data...
Copying files...
<revision rev="1" vrev="1">
  <srcmd5>4cdd21667036b92592bc2d5ccdfabdfc</srcmd5>
  <version>8.0.0</version>
  <time>1677744411</time>
  <user>yourusername</user>
  <comment>osc copypac from project:osmocom:latest package:eclipse-titan revision:2</comment>
  <requestid/>
</revision>

3. Checkout your package for local modification:

$ mkdir /tmp/obs
$ cd /tmp/obs
$ osc co home:yourusername:latest eclipse-titan
A    home:yourusername:latest
A    home:yourusername:latest/eclipse-titan
A    home:yourusername:latest/eclipse-titan/eclipse-titan_8.0.0-1.debian.tar.xz
A    home:yourusername:latest/eclipse-titan/eclipse-titan_8.0.0-1.dsc
A    home:yourusername:latest/eclipse-titan/eclipse-titan_8.0.0.orig.tar.bz2
A    home:yourusername:latest/eclipse-titan/update.sh
At revision 1.

4. Run obs-upgrade-eclipse-titan.sh from osmo-ci.git with the new version (see tags) as argument:

$ cd home:yourusername:latest/eclipse-titan
$ …/osmo-ci/contrib/obs-upgrade-eclipse-titan.sh 8.3.0
:: upgrade from 8.0.0 to 8.3.0
:: download titan.core-8.3.0.tar.bz2
…
:: now modify eclipse-titan-8.3.0 (e.g. adjust changelog) and press return when done

5. Open a new terminal, adjust the debian changelog (make sure there's a proper version at the top, change UNRELEASED to unstable).

$ nvim /tmp/obs/home:yourusername:latest/eclipse-titan/eclipse-titan-8.3.0/debian/changelog

6. Back in the first terminal, press return. The new source package will be built:

:: build new source package
dpkg-buildpackage: info: source package eclipse-titan
dpkg-buildpackage: info: source version 8.3.0-0
dpkg-buildpackage: info: source distribution unstable
…
dpkg-buildpackage: info: source-only upload (original source is included)
:: clean up extracted dirs
:: clean upstream tarball
:: done!

7. Delete files from the old release:

$ osc del *8.0.0*
D    eclipse-titan_8.0.0-1.debian.tar.xz
D    eclipse-titan_8.0.0-1.dsc
D    eclipse-titan_8.0.0.orig.tar.bz2

8. Add file from the new release:

$ osc add *
A    eclipse-titan_8.3.0-0.debian.tar.xz
A    eclipse-titan_8.3.0-0.dsc
A    eclipse-titan_8.3.0.orig.tar.bz2
A    titan.core-8.3.0.tar.bz2

9. Upload your changes

$ osc commit -m "upgrade to 8.3.0" 
Deleting    eclipse-titan_8.0.0-1.debian.tar.xz
Deleting    eclipse-titan_8.0.0-1.dsc
Deleting    eclipse-titan_8.0.0.orig.tar.bz2
Sending    eclipse-titan_8.3.0-0.debian.tar.xz
Sending    eclipse-titan_8.3.0-0.dsc
Sending    eclipse-titan_8.3.0.orig.tar.bz2
Sending    titan.core-8.3.0.tar.bz2
Transmitting file data ....
Committed revision 2.

10. Wait until OBS built a binary package from the source package in the test project.

11. Copy the source package to osmocom:latest:

$ osc copypac home:yourusername:latest eclipse-titan osmocom:latest
Copying files...
<revision rev="3" vrev="1">
  <srcmd5>8b70f4ede2181d5c51ebd077a1703044</srcmd5>
  <version>8.3.0</version>
  <time>1677747907</time>
  <user>yourusername</user>
  <comment>osc copypac from project:home:yourusername:latest package:eclipse-titan revision:2</comment>
  <requestid/>
</revision>