From 05c58b38e601315e9c40cd0b31a8f595cbe372ab Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Thu, 17 Sep 2026 12:14:43 +0200 Subject: [PATCH] remove the upgrade guide to 8.x from version 4.x and 7.x --- .../admin/maintenance/upgrade/index.md | 1 - .../maintenance/upgrade/upgrade-8.x.x.md | 67 ----------------- .../admin/maintenance/upgrade/index.md | 1 - .../maintenance/upgrade/upgrade-8.x.x.md | 73 ------------------- 4 files changed, 142 deletions(-) delete mode 100644 versioned_docs/version-4.0/admin/maintenance/upgrade/upgrade-8.x.x.md delete mode 100644 versioned_docs/version-7.2/admin/maintenance/upgrade/upgrade-8.x.x.md diff --git a/versioned_docs/version-4.0/admin/maintenance/upgrade/index.md b/versioned_docs/version-4.0/admin/maintenance/upgrade/index.md index beb6f056a..81b170b72 100644 --- a/versioned_docs/version-4.0/admin/maintenance/upgrade/index.md +++ b/versioned_docs/version-4.0/admin/maintenance/upgrade/index.md @@ -13,6 +13,5 @@ This section collects the guides you need when upgrading OpenCloud. ## Guides - [Standard Upgrade Guide](./upgrade.md) -- [Upgrade 8.x.x](./upgrade-8.x.x.md) - [Upgrade 4.0.x](./upgrade-4.0.0.md) - [Release notes](./release-notes.md) diff --git a/versioned_docs/version-4.0/admin/maintenance/upgrade/upgrade-8.x.x.md b/versioned_docs/version-4.0/admin/maintenance/upgrade/upgrade-8.x.x.md deleted file mode 100644 index 62145faf3..000000000 --- a/versioned_docs/version-4.0/admin/maintenance/upgrade/upgrade-8.x.x.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -sidebar_position: 15 -id: upgrade-8.x.x -title: Upgrade 8.x.x -description: Upgrading to OpenCloud 8.x.x -draft: false ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; - -# Upgrading to OpenCloud 8.x.x - -OpenCloud 8.x.x changes how resources are indexed and creates a new search index. Complete the regular upgrade first by following the [Standard Upgrade Guide](./upgrade.md). - -:::important - -OpenCloud 8.x.x is a Rolling release and is not intended for production environments. For more information, see the [Release Lifecycle](../../resources/lifecycle.md). - -::: - -## Quick upgrade - -After OpenCloud has been upgraded, rebuild the search index using the commands for your search backend. - - - - -```bash -docker compose exec opencloud opencloud search index --all-spaces --force-rescan --insecure -``` - -Verify that older files can be found in the Web Client. Then remove the old index: - -```bash -docker compose exec opencloud sh -c 'rm -r "$OC_BASE_DATA_PATH/search/bleve"' -``` - - - - -```bash -docker compose exec opencloud opencloud search index --all-spaces --force-rescan --insecure -``` - -Verify that older files can be found in the Web Client. Then list the existing indexes and remove the old one: - -```bash -curl "http://localhost:9200/_cat/indices/opencloud-resources*?v" -curl -X DELETE "http://localhost:9200/opencloud-resources" -``` - - - - -## What this does - -- The new, empty index (e.g. `bleve-v4` / `opencloud-resources-v4`) is created automatically. The old one stays until you remove it. -- New activity is indexed right away, but files that existed before and are not touched are not found until you re-index. -- Re-indexing runs while the service keeps working. -- After it finishes, delete every index except the one with the highest `-v` suffix (indexes up to 7.4 have no suffix). Verify search first. - -:::note - -`--insecure` is needed because the internal gRPC transport is not TLS-encrypted by default (`OC_GRPC_CLIENT_TLS_MODE` defaults to `off`). Drop it only if you run gRPC with TLS. This is safe here — the command just triggers a rescan; the re-indexing happens inside the OpenCloud process. - -::: diff --git a/versioned_docs/version-7.2/admin/maintenance/upgrade/index.md b/versioned_docs/version-7.2/admin/maintenance/upgrade/index.md index 198341910..b49c20dad 100644 --- a/versioned_docs/version-7.2/admin/maintenance/upgrade/index.md +++ b/versioned_docs/version-7.2/admin/maintenance/upgrade/index.md @@ -13,7 +13,6 @@ This section collects the guides you need when upgrading OpenCloud. ## Guides - [Standard Upgrade Guide](./upgrade.md) -- [Upgrade 8.x.x](./upgrade-8.x.x.md) - [Upgrade 7.x.x](./upgrade-7.x.x.md) - [Upgrade 4.0.x](./upgrade-4.0.0.md) - [Release notes](./release-notes.md) diff --git a/versioned_docs/version-7.2/admin/maintenance/upgrade/upgrade-8.x.x.md b/versioned_docs/version-7.2/admin/maintenance/upgrade/upgrade-8.x.x.md deleted file mode 100644 index dd423c871..000000000 --- a/versioned_docs/version-7.2/admin/maintenance/upgrade/upgrade-8.x.x.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -sidebar_position: 15 -id: upgrade-8.x.x -title: Upgrade 8.x.x -description: Upgrading to OpenCloud 8.x.x -draft: false ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; - -# Upgrading to OpenCloud 8.x.x - -OpenCloud 8.x.x changes how resources are indexed and creates a new search index. Complete the regular upgrade first by following the [Standard Upgrade Guide](./upgrade.md). - -:::important - -OpenCloud 8.x.x is a Rolling release and is not intended for production environments. For more information, see the [Release Lifecycle](../../resources/lifecycle.md). - -::: - -## Quick upgrade - -After OpenCloud has been upgraded, rebuild the search index using the commands for your search backend. This creates a new, versioned index (e.g. `bleve-v5` / `opencloud-resources-v5`) and leaves the old one in place until you remove it. - - - - -```bash -docker compose exec opencloud opencloud search index --all-spaces --force-rescan --insecure -``` - -Verify that older files can be found in the Web Client. Then remove the old, unversioned Bleve index: - -```bash -docker compose exec opencloud rm -r /var/lib/opencloud/search/bleve -``` - -This removes only the old, unversioned `bleve` index; the new versioned index is not affected. - -If you configured a custom `SEARCH_ENGINE_BLEVE_DATA_PATH`, replace `/var/lib/opencloud/search` with the configured path. - - - - -```bash -docker compose exec opencloud opencloud search index --all-spaces --force-rescan --insecure -``` - -Verify that older files can be found in the Web Client. Then list the existing indexes and remove the old one: - -```bash -curl "http://localhost:9200/_cat/indices/opencloud-resources*?v" -curl -X DELETE "http://localhost:9200/opencloud-resources" -``` - -This removes only the old, unversioned `opencloud-resources` index; the new versioned index is not affected. - - - - -## What this does - -- The new, empty index (e.g. `bleve-v5` / `opencloud-resources-v5`) is created automatically. The old one stays until you remove it. -- New activity is indexed right away, but files that existed before and are not touched are not found until you re-index. -- Re-indexing runs while the service keeps working. -- After it finishes, delete every index except the one with the highest version suffix (indexes up to 7.4 have no suffix). Verify search first. - -:::note - -`--insecure` is needed because the internal gRPC transport is not TLS-encrypted by default (`OC_GRPC_CLIENT_TLS_MODE` defaults to `off`). Drop it only if you run gRPC with TLS. This is safe here — the command just triggers a rescan; the re-indexing happens inside the OpenCloud process. - -:::