Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DSP 2.0 notebook image versions #290

Merged
merged 3 commits into from
May 10, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions modules/enabling-data-science-pipelines-2.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -96,9 +96,13 @@ ifdef::cloud-service[]
After you upgrade to {productname-short} with DSP 2.0, pipelines created with DSP 1.0 will continue to run, but will be inaccessible from the {productname-short} dashboard. We recommend that current DSP users do not upgrade to {productname-short} with DSP 2.0 until you are ready to migrate to the new pipelines solution.
====

To upgrade {productname-short}, ensure that there is no installation of Argo Workflows that is not installed by DSP on your cluster, and follow the upgrade steps described in link:{rhoaidocshome}{default-format-url}/upgrading_openshift_ai_cloud_service/index[Upgrading {productname-short } AI Cloud Service].
To upgrade to DSP 2.0, follow these steps:

If you upgrade to {productname-short} with DSP 2.0 enabled and an existing Argo Workflows installation that is not installed by DSP on your cluster, {productname-short} components will not be upgraded. To complete the component upgrade, disable DSP or remove the separate installation of Argo Workflows from your cluster. The component upgrade will complete automatically.
. Ensure that your cluster does not have an existing installation of Argo Workflows that is not installed by {productname-short}, and then follow the upgrade steps described in link:{rhoaidocshome}{default-format-url}/upgrading_openshift_ai_cloud_service/index[Upgrading {productname-short} AI Cloud Service].
+
If you upgrade to {productname-short} with DSP 2.0 enabled, and there is an existing installation of Argo Workflows that is not installed by DSP on your cluster, {productname-short} components will not be upgraded. To complete the component upgrade, disable DSP or remove the separate installation of Argo Workflows from your cluster. The component upgrade will then complete automatically.
. Update your workbenches to use the notebook image version 2024.1 or later. For more information, see link:{rhoaidocshome}{default-format-url}/working_on_data_science_projects/working-on-data-science-projects_nb-server#updating-a-project-workbench_nb-server[Updating a project workbench].
. Manually migrate your pipelines from DSP 1.0 to 2.0. For more information, see link:{rhoaidocshome}{default-format-url}/working_on_data_science_projects/working-with-data-science-pipelines_ds-pipelines#migrating_pipelines_from_dsp_1_0_to_2_0[Migrating pipelines from DSP 1.0 to 2.0].
endif::[]

//RHOAI self-managed & disconnected
Expand All @@ -108,9 +112,13 @@ ifdef::self-managed[]
After you upgrade to {productname-short} 2.9 or later, pipelines created with DSP 1.0 will continue to run, but will be inaccessible from the {productname-short} dashboard. We recommend that current DSP users stay on {productname-short} 2.8 until you are ready to migrate to the new pipelines solution.
====

To upgrade to {productname-short} 2.9, ensure that there is no installation of Argo Workflows that is not installed by DSP on your cluster, and follow the upgrade steps described in link:{rhoaidocshome}{default-format-url}/upgrading_openshift_ai_self-managed/index[Upgrading {productname-short} Self-Managed], or for disconnected environments, link:{rhoaidocshome}{default-format-url}/upgrading_openshift_ai_self-managed_in_a_disconnected_environment/index[Upgrading {productname-long} in a disconnected environment].
To upgrade to DSP 2.0, follow these steps:

If you upgrade to {productname-short} 2.9 or later with DSP enabled and an existing Argo Workflows installation that is not installed by DSP on your cluster, {productname-short} components will not be upgraded. To complete the component upgrade, disable DSP or remove the separate installation of Argo Workflows from your cluster. The component upgrade will complete automatically.
. Ensure that your cluster does not have an existing installation of Argo Workflows that is not installed by {productname-short}, and then follow the upgrade steps described in link:{rhoaidocshome}{default-format-url}/upgrading_openshift_ai_self-managed/index[Upgrading {productname-short} Self-Managed], or for disconnected environments, link:{rhoaidocshome}{default-format-url}/upgrading_openshift_ai_self-managed_in_a_disconnected_environment/index[Upgrading {productname-long} in a disconnected environment].
+
If you upgrade to {productname-short} 2.9 or later with DSP enabled, and there is an existing installation of Argo Workflows that is not installed by DSP on your cluster, {productname-short} components will not be upgraded. To complete the component upgrade, disable DSP or remove the separate installation of Argo Workflows from your cluster. The component upgrade will then complete automatically.
. Update your workbenches to use the notebook image version 2024.1 or later. For more information, see link:{rhoaidocshome}{default-format-url}/working_on_data_science_projects/working-on-data-science-projects_nb-server#updating-a-project-workbench_nb-server[Updating a project workbench].
. Manually migrate your pipelines from DSP 1.0 to 2.0. For more information, see link:{rhoaidocshome}{default-format-url}/working_on_data_science_projects/working-with-data-science-pipelines_ds-pipelines#migrating_pipelines_from_dsp_1_0_to_2_0[Migrating pipelines from DSP 1.0 to 2.0].
endif::[]
endif::[]

Expand Down
4 changes: 4 additions & 0 deletions modules/options-for-notebook-server-environments.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ ifdef::upstream[]
[NOTE]
--
When a new version of a notebook image is released, the previous version remains available on the cluster. This gives you time to migrate your work to the latest version of the notebook image. Legacy notebook image versions, that is, not the two most recent versions, might still be available for selection. Legacy image versions include a label that indicates that the image is out-of-date. To use the latest package versions, use the most recently added notebook image.

If you want to use {productname-short} with Data Science Pipelines (DSP) 2.0, you must use notebook image versions 2024.1 or later.
--
endif::[]
ifndef::upstream[]
Expand All @@ -23,6 +25,8 @@ Notebook images are supported for a minimum of one year. Major updates to precon

Versions 1.2 and 2023.1 of notebook images are no longer supported. Notebooks that are already running on versions 1.2 or 2023.1 of an image will continue to work normally, but they are not available to select for new users or notebooks.

If you want to use {productname-short} with Data Science Pipelines (DSP) 2.0, you must use notebook image versions 2024.1 or later.

To use the latest package versions, {org-name} recommends that you use the most recently added notebook image.
--
endif::[]
Expand Down