[gentoo-dev] News item for Radicale upgrade

[gentoo-dev] News item for Radicale upgrade

[Christopher Head]

[-- Attachment #1: Type: text/plain, Size: 1379 bytes --]

Hello,
I have filed a pull request
<https://github.com/gentoo/gentoo/pull/7274> to add Radicale 2.1.8 to
the tree. Migrating from Radicale 1 to 2 requires running a database
export command using Radicale 1, i.e. *before* upgrading, as Radicale 2
can’t read version 1’s storage format. Please see below my proposed
news item to go along with this version bump. Note that I am not a
developer and am therefore unable to commit this myself; I would
appreciate that it be reviewed and then whoever accepts my pull request
also add this news item at the same time. Because of this, I have set
the Posted date to today, as I can’t predict when it will actually be
posted; I ask that the committer please revise the date accordingly.
Thank you!

Title: Radicale 2 requires pre-install migration
Author: Christopher Head <chead@chead.ca>
Posted: 2018-03-01
Revision: 1
News-Item-Format: 2.0
Display-If-Installed: <www-apps/radicale-2

Radicale version 2 uses a new storage format and is not able to read
databases created by version 1. Version 1 releases starting from 1.1.3
include a --export-storage option which can be used to export their
databases in a format that Radicale 2 can use; you must do this before
upgrading to version 2.

Please see the Radicale migration guide for more information:

http://radicale.org/1to2/
-- 
Christopher Head

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [gentoo-dev] News item for Radicale upgrade

[Christopher Head]

[-- Attachment #1: Type: text/plain, Size: 1548 bytes --]

Hello,
After much discussion on the pull request
<https://github.com/gentoo/gentoo/pull/7274>, reviewers and I have
concluded with a new pkg_pretend message, which I would like to use as
the new news message as well. As before, I ask that the committer of
that merge request adjust the posted date in this news item and add it
to the news repo when accepting the PR. Thanks!

Title: Radicale 2 requires pre-install migration
Author: Christopher Head <chead@chead.ca>
Posted: 2018-03-30
Revision: 2
News-Item-Format: 2.0
Display-If-Installed: <www-apps/radicale-2

Radicale version 2 uses a new storage format and is not able to read
databases created by version 1. Version 1 releases starting from 1.1.3
include a --export-storage option which can be used to export their
databases in a format that Radicale 2 can use; you must do this before
upgrading to version 2.

If you have kept the Gentoo-default database configuration, this will
work:
1. Stop any running instance of Radicale.
2. Run `radicale --export-storage ~/radicale-exported`.
3. Run `chown -R radicale: ~/radicale-exported`
4. Run `mv /var/lib/radicale /var/lib/radicale.old`.
5. Install Radicale version 2.
6. Run `mv ~/radicale-exported /var/lib/radicale/collections`.

For more details, or if you are have a more complex configuration,
please see the migration guide: http://radicale.org/1to2/
If you do a custom migration, please ensure the database is cleaned out
of /var/lib/radicale, including the hidden .props file.
-- 
Christopher Head

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [gentoo-dev] News item for Radicale upgrade

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 385 bytes --]

>>>>> On Fri, 30 Mar 2018, Christopher Head wrote:

> Title: Radicale 2 requires pre-install migration
> Author: Christopher Head <chead@chead.ca>
> Posted: 2018-03-30
> Revision: 2

Please start with Revision 1 here. The revision should be increased
only when an item is updated after publishing.

> News-Item-Format: 2.0
> Display-If-Installed: <www-apps/radicale-2

> [...]

Ulrich

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

Re: [gentoo-dev] News item for Radicale upgrade

[Christopher Head]

[-- Attachment #1: Type: text/plain, Size: 1224 bytes --]

One more try, this time with the proper revision number.

Title: Radicale 2 requires pre-install migration
Author: Christopher Head <chead@chead.ca>
Posted: 2018-04-02
Revision: 1
News-Item-Format: 2.0
Display-If-Installed: <www-apps/radicale-2

Radicale version 2 uses a new storage format and is not able to read
databases created by version 1. Version 1 releases starting from 1.1.3
include a --export-storage option which can be used to export their
databases in a format that Radicale 2 can use; you must do this before
upgrading to version 2.

If you have kept the Gentoo-default database configuration, this will
work:
1. Stop any running instance of Radicale.
2. Run `radicale --export-storage ~/radicale-exported`.
3. Run `chown -R radicale: ~/radicale-exported`
4. Run `mv /var/lib/radicale /var/lib/radicale.old`.
5. Install Radicale version 2.
6. Run `mv ~/radicale-exported /var/lib/radicale/collections`.

For more details, or if you are have a more complex configuration,
please see the migration guide: http://radicale.org/1to2/
If you do a custom migration, please ensure the database is cleaned out
of /var/lib/radicale, including the hidden .props file.
-- 
Christopher Head

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [gentoo-dev] News item for Radicale upgrade

[Michał Górny]

W dniu pon, 02.04.2018 o godzinie 23∶09 -0700, użytkownik Christopher
Head napisał:
> One more try, this time with the proper revision number.
> 
> Title: Radicale 2 requires pre-install migration
> Author: Christopher Head <chead@chead.ca>
> Posted: 2018-04-02
> Revision: 1
> News-Item-Format: 2.0
> Display-If-Installed: <www-apps/radicale-2
> 
> Radicale version 2 uses a new storage format and is not able to read
> databases created by version 1. Version 1 releases starting from 1.1.3
> include a --export-storage option which can be used to export their
> databases in a format that Radicale 2 can use; you must do this before
> upgrading to version 2.
> 
> If you have kept the Gentoo-default database configuration, this will
> work:
> 1. Stop any running instance of Radicale.
> 2. Run `radicale --export-storage ~/radicale-exported`.
> 3. Run `chown -R radicale: ~/radicale-exported`
> 4. Run `mv /var/lib/radicale /var/lib/radicale.old`.
> 5. Install Radicale version 2.
> 6. Run `mv ~/radicale-exported /var/lib/radicale/collections`.
> 
> For more details, or if you are have a more complex configuration,
> please see the migration guide: http://radicale.org/1to2/
> If you do a custom migration, please ensure the database is cleaned out
> of /var/lib/radicale, including the hidden .props file.

Merged.

-- 
Best regards,
Michał Górny