From e8a1e690c66dfbea0154a246f7e18ce432673780 Mon Sep 17 00:00:00 2001 From: minottic Date: Wed, 19 Nov 2025 15:48:48 +0100 Subject: [PATCH 1/3] feat: add upgrade page --- docs/202601Upgrade.md | 34 ++++++++++++++++++++++++++++++++++ docs/index.md | 4 ++++ 2 files changed, 38 insertions(+) create mode 100644 docs/202601Upgrade.md diff --git a/docs/202601Upgrade.md b/docs/202601Upgrade.md new file mode 100644 index 0000000..3a334d4 --- /dev/null +++ b/docs/202601Upgrade.md @@ -0,0 +1,34 @@ +--- +title: 2026/01 upgrade +--- +# 2026/01 upgrade + +From the 5th of January to the 15th of January there will be a major upgrade of the data catalog infrastructure (SciCat - [https://discovery.psi.ch](https://discovery.psi.ch) and [https://dacat.psi.ch](https://dacat.psi.ch)) + +During this period, data archiving and retrieval will not be possible. + +## Required changes + +After the upgrade, few changes will be required: + +### CLI changes + +If you are using pmodules, no changes are required, otherwise: + +1. please download the latest released CLI version (>=v3.0.0) by following the [download instructions](https://github.com/paulscherrerinstitute/scicat-cli?tab=readme-ov-file#manual-deployment-and-upgrade). +2. Modify your ingestion scripts, following the [v3 instructions](https://github.com/paulscherrerinstitute/scicat-cli?tab=readme-ov-file#v3-changes); +3. or download the [backwards compatible scripts](https://github.com/paulscherrerinstitute/scicat-cli?tab=readme-ov-file#backwards-compatibility-with-v2) (linux only). Please note these scripts will later be discontinued (~ Q2 2026). + +### API changes + +Some APIs have been updated. This affects you only if you interact directly with the SciCat APIs. + +1. You can already find and compare the new API specifications from our [QA environment](https://dacat-qa.psi.ch/explorer). +2. Authorization update: API authorization now requires passing your token in the Authorization header, prefixed with Bearer, i.e. Bearer . +3. Login endpoint: API login is now available at "/auth/login" rather than "users/login". + +### Recieving updates notifications + +To receive notifications on updates, please subscribe to the [scicat mailing list](https://psilists.ethz.ch/sympa/info/scicat). + +If you have questions, don't hesitate to contact us at [scicat-help@lists.psi.ch](mailto:scicat-help@lists.psi.ch). diff --git a/docs/index.md b/docs/index.md index 5f72d10..ec84449 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,10 @@ --- title: Home --- +# :warning: Planned upgrade 2026/01 :warning: + +Please note that there will be a major upgrade that requires client changes. For details, please refer to the [upgrade page](./202601Upgrade.md). + # PSI Data Catalog Documentation The PSI Data Catalog is the preferred way to archive and publish research data from the -- 2.49.1 From 9d47bf3eb8288d12d0d1684647977f136235c7fe Mon Sep 17 00:00:00 2001 From: minotti_c Date: Thu, 20 Nov 2025 10:56:28 +0100 Subject: [PATCH 2/3] Address comments --- docs/202601Upgrade.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/202601Upgrade.md b/docs/202601Upgrade.md index 3a334d4..8f6a6ff 100644 --- a/docs/202601Upgrade.md +++ b/docs/202601Upgrade.md @@ -1,7 +1,7 @@ --- -title: 2026/01 upgrade +title: January 2026 upgrade --- -# 2026/01 upgrade +# January 2026 upgrade From the 5th of January to the 15th of January there will be a major upgrade of the data catalog infrastructure (SciCat - [https://discovery.psi.ch](https://discovery.psi.ch) and [https://dacat.psi.ch](https://dacat.psi.ch)) @@ -9,7 +9,7 @@ During this period, data archiving and retrieval will not be possible. ## Required changes -After the upgrade, few changes will be required: +After the upgrade, a few changes will be required: ### CLI changes -- 2.49.1 From 513118e82d0e34893fc2ea0e0dae3f151d1cf313 Mon Sep 17 00:00:00 2001 From: minotti_c Date: Thu, 20 Nov 2025 10:56:51 +0100 Subject: [PATCH 3/3] Use Jannuary --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index ec84449..cf435ed 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,7 +1,7 @@ --- title: Home --- -# :warning: Planned upgrade 2026/01 :warning: +# :warning: Planned January 2026 upgrade :warning: Please note that there will be a major upgrade that requires client changes. For details, please refer to the [upgrade page](./202601Upgrade.md). -- 2.49.1