Skip to content

Commit

Permalink
DSP 2.0 notebook image versions (#290)
Browse files Browse the repository at this point in the history
* DSP 2.0 notebook image versions

* DSP 2.0 notebook image versions

* edits from review
  • Loading branch information
aduquett authored May 10, 2024
1 parent 9db0c14 commit f25d297
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 4 deletions.
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

0 comments on commit f25d297

Please sign in to comment.