pgrouting 2.2.2 Release process checklist

Micro release is due to a critical bug.

1. Information

Branch: hotFix/issue552 Commit: bef907e3

Issue	Status	Comment
#552	FIXED	Here

Tests
Travis
Jenkins

1. Merge code changes into develop

Develop has next minor, so only copy source code modifications

git checkout develop
git checkout hotFix/issue552 src/common/src/basePath_SSEC.hpp
git checkout hotFix/issue552

2. Version Changes

task 2.1

Modifications on the branch that fixes the issue

• Click to the link for The instructions
• Status:
  • PENDING
  • MODIFIED
  • COMMITTED
  • PUSHED

File	Status
CMakeLists.txt	PUSHED
utilities-any.result	PUSHED
VERSION	PUSHED
NEWS	PUSHED
2_2_2.rst	PUSHED
changelog/index.rst	PUSHED
doc/index.rst	PUSHED
signatures	PUSHED

task 2.2

• Click to the link for The instructions
• Status:
  • PENDING
  • DONE

subtask	status
Compile	PENDING
Run the tests	PENDING
Run the documentation queries	PENDING

Add new files, commit & push:

git add doc/src/changelog/2_2_2.rst
git add tools/sigs/pgrouting--2.2.1.sig
git commit -a -m 'Preparing release 2.2.2'

git checkout develop
cp build/lib/pgrouting--2.2.2.sig tools/sigs/
git add tools/sigs/pgrouting--2.2.2.sig
git checkout hotFix/issue552 doc/src/changelog/2_2_2.rst
git commit -a -m 'Adding hotFix/issue552 changes'

git checkout hotFix/issue552
git push

Instructions

CMakeLists.txt

vi CMakeLists.txt

Change:

# PGROUTING version number.
set(PGROUTING_VERSION_MAJOR "2")
set(PGROUTING_VERSION_MINOR "2")
set(PGROUTING_VERSION_PATCH "1")

To

# PGROUTING version number.
set(PGROUTING_VERSION_MAJOR "2")
set(PGROUTING_VERSION_MINOR "2")
set(PGROUTING_VERSION_PATCH "2")
set(PGROUTING_GIT_TAG "pgrouting-2.2.2")

utilities-any.result

vi doc/test/utilities-any.result

Change	to
2.2.1	2.2.2

VERSION

vi VERSION

Change	To
pgrouting-2.2.1-< rest >	pgrouting-2.2.2-< rest >

NEWS

vi NEWS

Add on top of the file:

Changes for 2.2.2
-------------------------------------------------------------------------------

- Fixed regression error on pgr_drivingDistance

2_2_2.rst

Create the log file for the release

vi 2_2_2.rst

Insert the following:

..
   ****************************************************************************
    pgRouting Manual
    Copyright(c) pgRouting Contributors

    This documentation is licensed under a Creative Commons Attribution-Share
    Alike 3.0 License: http://creativecommons.org/licenses/by-sa/3.0/
   ****************************************************************************

.. _changelog_2_2_2:

pgRouting 2.2.2 Release Notes
===============================================================================

With the release of pgRouting 2.2.2 fixes a regression bug.

 - To see the full list of changes check the list of `Git commits <https://github.com/pgRouting/pgrouting/commits>`_ on Github.
 - To see the issues closed by this release see the `Git closed issues <https://github.com/pgRouting/pgrouting/issues?q=milestone%3ARelease-2.2.2+is%3Aclosed>`_ on Github.
 - For important changes see the following release notes.


Release Notes
-------------------------------------------------------------------------------


Changes for release 2.2.2

* Fixed regression error on pgr_drivingDistance

changelog/index.rst

Modify the change log on Change log file

vi doc/src/changelog/index.rst

Insert on top of the list.

   - :ref:`changelog_2_2_2`

Insert on top of the hidden tag

   2_2_2

doc/index.rst

Modify the change log on main page of documentation

vi doc/index.rst
\change_log

Insert on top of the list.

   - :ref:`changelog_2_2_2`

Signatures

We are not allowing signature changes in micro releases, for upgrading from 2.2.1 create the signature file

cp tools/sigs/pgrouting--2.2.0.sig tools/sigs/pgrouting--2.2.1.sig

On the first line:

Change	to
#VERSION pgrouting 2.2.0	#VERSION pgrouting 2.2.1

Compile

cd build/
rm -rf *
cmake ..
make
sudo make install

Run the tests

From previous command we are in build

cd ..
tools/testers/algorithm-tester.pl
createdb  ___pgr___test___
sh ./tools/testers/pg_prove_tests.sh vicky
dropdb  ___pgr___test___

createdb  ___test_update
psql  ___test_update  <<EOF
create extension postgis;
create extension pgrouting with version '2.2.0';
select pgr_version();
alter extension pgrouting update to '2.2.2';
select pgr_version();
EOF
dropdb   ___test_update

createdb  ___test_update
psql  ___test_update  <<EOF
create extension postgis;
create extension pgrouting with version '2.2.1';
select pgr_version();
alter extension pgrouting update to '2.2.2';
select pgr_version();
EOF
dropdb   ___test_update

Run the documentation queries

tools/testers/algorithm-tester.pl -documentation