Add docs/2026_01_upgrade (#7)
All checks were successful
Build and deploy documentation / build-docs (push) Successful in 6s
Build and deploy documentation / deploy-docs (push) Successful in 6s

Add documentation page for planned upgrade

Reviewed-on: #7
Reviewed-by: zade_o <omkar.zade@psi.ch>
Reviewed-by: pozsa_k <krisztian.pozsa@psi.ch>
This commit was merged in pull request #7.
This commit is contained in:
2025-11-19 11:43:26 +01:00
parent 417ec607d0
commit fc940b6abc
2 changed files with 37 additions and 0 deletions

33
docs/202601Upgrade.md Normal file
View File

@@ -0,0 +1,33 @@
---
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 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 <MY_TOKEN>.
### 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).

View File

@@ -1,6 +1,10 @@
---
title: Home
---
# :warning: 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