View Source

The legacy CDS and legacy ADS systems were decommissioned on 26 September 2024 and are no longer accessible.

On 26 September 2024, CDS-Beta and ADS-Beta will officially become the new CDS and ADS, and EWDS will become operational for accessing CEMS data.

The URLs to CDS-Beta, ADS-Beta and EWDS-Beta will automatically shift to cds.climate.copernicus.eu, ads.atmosphere.copernicus.eu and ewds.climate.copernicus.eu respectively.

If you are a legacy CDS or legacy ADS user and wish to continue downloading data from our Data Stores, you are urged to migrate to the CDS, ADS, or EWDS now (see quick guides below). From 26 September 2024, CDS, ADS, and EWDS API users attempting to access data using their legacy credentials will see their requests systematically fail, for which no support will be provided.

If you are a CDS-beta, ADS-beta, or EWDS-beta user, from 26 September 2024, there is no urgency at this time to update the URL in your .cdsapirc. Requests will be automatically redirected from the beta URLs to the operational URLs for some time. You will be advised to update the URL in your .cdsapirc file at your earliest convenience (but within a timeframe to be announced). We will update this page and post an announcement on our Forum to remind and guide users on what to do.

The decommissioning date of 26 September 2024 is final and will not be extended. From 26 September 2024, legacy systems will no longer be available to users. Queues on legacy systems will be closed on 25/09/24. API users on legacy systems who will not have migrated to beta systems will see their API requests fail. API users on Beta systems will have until 29/10/24 to update the URL in their cdsapirc file

Create a new EWDS account and accept EWDSTerms & Conditions at https://ewds.climate.copernicus.eu/
Accept the licences of the product you are interested in (go to the Download form of the product of interest).
For API access:
- Update API credentials and end point (eg. in your .cdsapirc file) as shown, after logging on here (Note that new .cdsapirc file should only contain a URL and a key field - there is NO UID field anymore).
- Upgrade your CDS API (i.e pip install --upgrade cdsapi). Please make sure you are using a supported version of Python i.e. 3.8 and above.
- New API is designed to be backward compatible which means that once your .cdsapirc is updated and your CDS API package upgraded, your API script may run successfully immediately, downloading data from CDS-Beta. There are a few datasets however for which API syntax may have changed - please check the warning on the catalogue page of the affected datasets (e.g. E-OBS).
- Run a small API test request.

More details available (e.g. CDS Toolbox and Good-to-know sections below)

Introduction

A new state-of-the-art infrastructure, referred to as the Common Data Store Engine, has been developed by ECMWF to host the Climate and Atmospheric Data Stores. All layers of the infrastructure are being modernised: the front-end web interface, the back-end software engine, and the underlying cloud infrastructure hosting the service and core data repositories.

As part of this development, a new data store for the Copernicus Emergency Management Service has been created. The CEMS Early Warning Data Store (EWDS) will host all the historical and forecast information for floods and forest fires at European and Global levels. CEMS datasets have been migrated to the EWDS, and are no longer available from the Climate Data Store (CDS).

The new CEMS Early Warning Data Store (EWDS) is now live!
https://ewds.climate.copernicus.eu/

The modernisation of the Data Stores is a journey on which we embarked for the users and with the users. Without your support and your collaboration, this transition would simply not be achievable. We thank you all again for your patience during this significant modernisation of our Data Stores and eagerly await for your constructive feedback via our Support Portal!

What does this mean in practice to current CDS (and ADS) users?

User account:

ECMWF Single Sign-On (SSO) has been extended to all its platforms including the new CDS, ADS, and EWDS. SSO allows users to have access to multiple applications by signing in with only one account. It also has other important features in regard to simple management, security, ease of use, and seamlessness.

All users of the new CDS, ADS, and EWDS will need an ECMWF account. If you already have one, great. If you do not yet have an ECMWF account, please register with ECMWF to get one.

As a consequence of the single sign-on implementation, your current CDS or ADS login credentials will not work on the new CDS, ADS, EWDS infrastructure, regardless of whether you are currently using the CDS or ADS interactively (e.g. over the web interface) or programmatically (using the API service). A new UserID (ECMWF) and API key will be needed.

Your ECMWF account will only allow you to login to the new CDS/ADS/EWDS, not onto the current CDS/ADS.

You cannot use your ECMWF account to log in onto the current CDS or current ADS. SSO does not apply to current CDS nor current ADS.

Your existing CDS account will only work in the current CDS, not in EWDS. You need an ECMWF account to start using EWDS.

From 26 September 2024, all CEMS data is solely accessible from the EWDS – legacy CDS and CDS-Beta systems no longer host CEMS datasets.

CDS/ADS/EWDS Catalogue - data download over web interface:

Before downloading any data from the new CDS/ADS/EWDS infrastructure, users will have to accept dataset licences on the new system. Users' profiles including licensing information are not being transferred. In practical terms, this means for example that if you are downloading ERA5 data (web or API) from the current CDS, you will need to login to the new CDS and accept the terms and conditions for ERA5 (i.e. Licence to use Copernicus Products). You can check whether you have accepted the dataset licence under Your Profile on new CDS/EWDS systems (see Dataset Licences section below the Terms & Conditions).

API Service - programmatic way of downloading data:

A new version of the cdsapi package has been released. API users need to upgrade their CDS API (i.e pip install --upgrade cdsapi). Note that the new version of the cdsapi package works on both the current and new CDS.
Log in to the EWDS interface using your ECMWF account and follow the instructions online. Make sure you also accept the Terms and Conditions of the datasets you wish to download (this is the dataset licence in addition to the Terms & Conditions for using EWDS- see CDS/ADS/EWDS Catalogue section above).
Before submitting your API request, you will need to update your .cdsapirc file as shown in the first black box displayed on the EWDS API page (you must be logged in!). Note that new .cdsapirc file should only contain a URL and a key field - there is NO UID field anymore)
While the new API is designed to be backward compatible, we strongly recommend you please use the "Show API request code" tool on the dataset Download Form on EWDS to check you are using the correct syntax for your API request. CDS/ADS/EWDS API syntax is changed and some keys or parameter names may have also changed for some datasets (e.g. E-OBS).

CDS Toolbox, Viewers and Applications:

The CDS Toolbox has been discontinued from 26 September 2024 and will not be migrated to the new CDS/EWDS infrastructure. Support will continue to be provided to CDS Toolbox users until the CDS Toolbox is shut down on 26 September 2024. ECMWF Support will however not be able to help with supporting users migrating their CDS Toolbox workflows onto another programming language/software. On 26/09/24, legacy systems will no longer be available to users. Queues on legacy systems will be closed on 25/09/24. API users on legacy systems who will not have migrated to new systems will see their API requests fail. API users on Beta systems will have until 29/10/24 to update the URL in their cdsapirc file

As a consequence of the CDS Toolbox being discontinued, the Viewer tool for the following datasets in the CDS will also be discontinued.

New tool packages will be made available to provide software tools for weather and climate workflows that simplify data access, analysis, visualisation and much more. Please watch the user forum for announcements on this topic in the coming months.

All Climate Data Store Applications will also be retired and no longer available when the current Climate Data Store is shut down on 26 September 2024.

The new CDS will have some better-performing applications including the Copernicus Interactive Climate Atlas and Climate Pulse. More applications will be published including new versions of some applications in the legacy CDS e.g. ERA5 explorer, Global temperature trend monitor...

IP address range for CDS-beta/ADS-beta/EWDS-beta

CDS/ADS/EWDS Download servers are all still under the same IP range.

136.156.136.0/21

136.156.128.0/21

Feedback and reporting bugs/issues:

Please send your feedback and/or report any issue/bug you may have encountered while using the new CDS/ADS/EWDS infrastructure by raising an enquiry ticket through our dedicated Support Portal (ECMWF login required) - make sure you select "Yes" to the question Is this request related to CDS-beta/ADS-beta/CEMS-EW-beta? on the Support Portal request form - this will help the Support team with triaging enquiries more efficiently.

Good to know

New publication of datasets (including publication of existing dataset new versions) will only be made in the new CDS/ADS/EWDS infrastructure. Users are therefore urged to migrate over to the new CDS/ADS/EWDS infrastructure as soon as possible.
Some observation datasets will not be immediately available to download from the new CDS infrastructure while technical issues with these particular datasets are being addressed. Please see this page for details.
Some unsupported datasets in the current CDS will be deprecated in the new CDS/ADS/EWDS infrastructure.
A new GRIB to NetCDF converter has been implemented in the new CDS/EWDS systems. Please refer to our forum announcement.
Updates to the EWDS documentation on the CEMS-Flood/CEMS-Fire wiki pages are ongoing as the implementation occurs. Scripts and examples on these pages are under review and may not be fully functional yet for the EWDS, so please be patient.
For the time being, DOIs of datasets in CDS-Beta will point to the same datasets in the current CDS until the current CDS is shut down on 26 September 2024.

The current CDS and ADS will be completely shut down on 26 September 2024. Please migrate to using the new CDS/ADS/EWDS by 26 September 2024. Should users still have API scripts pointing to the retired CDS and ADS systems, these will systematically break and no support will be provided. On 26/09/24, legacy systems will no longer be available to users. Queues on legacy systems will be closed on 25/09/24. API users on legacy systems who will not have migrated to beta systems will see their API requests fail. API users on Beta systems will have until 29/10/24 to update the URL in their cdsapirc file
For more information on specific changes to the CDS and ADS systems, visit: Informative page in readiness for CDS-Beta