procedures: Add PostgreSQL migration guides #2163

tolusha · 2021-11-12T13:43:18Z

Signed-off-by: Anatolii Bazko abazko@redhat.com

What does this pull request change?

Add PostgreSQL migration guides

What issues does this pull request fix or reference?

Migration guide from internal to external PostgreSQL DB che#20757
How to update che which was installed using chectl server:deploy --installer=helm as described in the official documentation for "Installing Che on AWS" che#20712

Specify the version of the product this pull request applies to

Pull Request checklist

The author and the reviewers validate the content of this pull request with the following checklist, in addition to the automated tests.

Any procedure:
- Successfully tested.
Any page or link rename:
- The page contains a redirection for the previous URL.
- Propagate the URL change in:
  - Dashboard default branding data
  - Chectl constants.ts
Builds on Eclipse Che hosted by Red Hat.
the Validate language on files added or modified step reports no vale warnings.

github-actions · 2021-11-12T13:43:47Z

Click here to review and test in web IDE:

Signed-off-by: Anatolii Bazko <abazko@redhat.com>

github-actions · 2021-11-15T15:25:58Z

Click here to review and test in web IDE:

Signed-off-by: Anatolii Bazko <abazko@redhat.com>

github-actions · 2021-11-16T07:19:30Z

Click here to review and test in web IDE:

Signed-off-by: Anatolii Bazko <abazko@redhat.com>

github-actions · 2021-11-16T12:16:50Z

Click here to review and test in web IDE:

github-actions · 2021-11-17T12:22:32Z

Click here to review and test in web IDE:

modules/administration-guide/partials/snip_finding-che-user-name.adoc

…me.adoc

themr0c · 2022-01-25T15:09:49Z

@tolusha I see merge conflicts, can you resolve them or do you need assistance?

max-cx · 2022-10-17T08:59:39Z

modules/administration-guide/partials/assembly_migration-to-external-database-setup.adoc

+
+:context: migration-to-external-database-setup
+
+Follow the procedures below to migrate from internal to external database setup successfully without any data loss.


Suggested change

Follow the procedures below to migrate from internal to external database setup successfully without any data loss.

You can migrate from the internal database to an external database without losing data.

max-cx · 2022-10-17T09:01:30Z

...les/administration-guide/partials/assembly_migration-from-postgresql-9-to-postgresql-13.adoc

+
+By the 11th of November, 2021, the PostgreSQL version 9.6 came out of support, and {prod-short} team recommends that all users undergo migrating to version 13.
+
+Follow the procedures below to migrate to a newer version of PostgreSQL successfully without any data loss.


Suggested change

Follow the procedures below to migrate to a newer version of PostgreSQL successfully without any data loss.

You can upgrade to a newer version of PostgreSQL without losing data.

max-cx · 2022-10-17T09:07:07Z

...les/administration-guide/partials/assembly_migration-from-postgresql-9-to-postgresql-13.adoc

+
+:context: migration-from-postgresql-9-to-postgresql-13
+
+By the 11th of November, 2021, the PostgreSQL version 9.6 came out of support, and {prod-short} team recommends that all users undergo migrating to version 13.


This looks like a release note to me. If we need to tell this information to customers, I propose that we create a release note and link to this procedure from the release note.
Let me know what you think about this possibility.

max-cx · 2022-10-17T09:09:13Z

...les/administration-guide/partials/assembly_migration-from-postgresql-9-to-postgresql-13.adoc

+:parent-context-of-migration-from-postgresql-9-to-postgresql-13: {context}
+
+[id="migration-from-postgresql-9-to-postgresql-13_{context}"]
+= Migration from PostgreSQL 9 to PostgreSQL 13
+
+:context: migration-from-postgresql-9-to-postgresql-13


Suggested change

:parent-context-of-migration-from-postgresql-9-to-postgresql-13: {context}

[id="migration-from-postgresql-9-to-postgresql-13_{context}"]

= Migration from PostgreSQL 9 to PostgreSQL 13

:context: migration-from-postgresql-9-to-postgresql-13

:parent-context-of-upgrading-postgresql: {context}

[id="upgrading-postgresql_{context}"]

= Upgrading PostgreSQL

:context: upgrading-postgresql

max-cx · 2022-10-17T09:09:38Z

...les/administration-guide/partials/assembly_migration-from-postgresql-9-to-postgresql-13.adoc

+
+include::partial$snip_verification-che-working.adoc[]
+
+:context: {parent-context-of-migration-from-postgresql-9-to-postgresql-13}


Suggested change

:context: {parent-context-of-migration-from-postgresql-9-to-postgresql-13}

:context: {parent-context-of-upgrading-postgresql}

max-cx · 2022-10-17T09:10:06Z

modules/administration-guide/partials/assembly_migration-from-helm-charts-to-operator.adoc

+
+:context: migration-from-helm-charts-to-operator
+
+Follow the procedures below to migrate from Helm Charts to Operator successfully without any data loss.


Suggested change

Follow the procedures below to migrate from Helm Charts to Operator successfully without any data loss.

You can migrate from Helm Charts to Operator without losing data.

max-cx · 2022-10-17T09:11:55Z

modules/administration-guide/pages/migration-to-external-database-setup.adoc

+[id="migration-to-external-database-setup"]
+:navtitle: Migration to external database setup


Suggested change

[id="migration-to-external-database-setup"]

:navtitle: Migration to external database setup

[id="migration-to-an-external-database-setup"]

:navtitle: Migration to an external database setup

You'll probably need to change the file name too.

max-cx · 2022-10-17T09:12:26Z

modules/administration-guide/pages/migration-to-external-database-setup.adoc

+:keywords: administration-guide, external-database, migration
+:page-aliases: .:migration-to-external-database-setup
+
+include::partial$assembly_migration-to-external-database-setup.adoc[]


I might have suggested renaming that file too.

max-cx · 2022-10-17T09:13:23Z

modules/administration-guide/pages/migration-to-external-database-setup.adoc

+:keywords: administration-guide, external-database, migration
+:page-aliases: .:migration-to-external-database-setup
+
+include::partial$assembly_migration-to-external-database-setup.adoc[]


Suggested change

include::partial$assembly_migration-to-external-database-setup.adoc[]

include::partial$assembly_migration-to-an-external-database-setup.adoc[]

max-cx · 2022-10-17T09:14:00Z

modules/administration-guide/pages/migration-from-postgresql-9-to-postgresql-13.adoc

 [id="migration-from-postgresql-9-to-postgresql-13"]
 :navtitle: Migration from PostgreSQL 9 to PostgreSQL 13


Suggested change

[id="migration-from-postgresql-9-to-postgresql-13"]

:navtitle: Migration from PostgreSQL 9 to PostgreSQL 13

[id="upgrading-postgresql"]

:navtitle: Upgrading PostgreSQL

max-cx · 2022-10-17T09:14:24Z

modules/administration-guide/pages/migration-from-postgresql-9-to-postgresql-13.adoc


-include::partial$proc_migration_from_postgresql_9_to_postgresql_13.adoc[]
+include::partial$assembly_migration-from-postgresql-9-to-postgresql-13.adoc[]


Suggested change

include::partial$assembly_migration-from-postgresql-9-to-postgresql-13.adoc[]

include::partial$assembly_upgrading-postgresql.adoc[]

max-cx · 2022-10-17T09:15:24Z

modules/administration-guide/nav.adoc

@@ -45,8 +45,10 @@
 *** xref:define-backup-server-for-operator.adoc[]
 ** xref:persistent-volumes-backups.adoc[]
 ** xref:external-database-setup.adoc[]
+** xref:migration-to-external-database-setup.adoc[]


Suggested change

** xref:migration-to-external-database-setup.adoc[]

** xref:migration-to-an-external-database-setup.adoc[]

max-cx · 2022-10-17T09:16:09Z

modules/administration-guide/nav.adoc

@@ -45,8 +45,10 @@
 *** xref:define-backup-server-for-operator.adoc[]
 ** xref:persistent-volumes-backups.adoc[]
 ** xref:external-database-setup.adoc[]
+** xref:migration-to-external-database-setup.adoc[]

 * xref:migration-from-postgresql-9-to-postgresql-13.adoc[]


Suggested change

* xref:migration-from-postgresql-9-to-postgresql-13.adoc[]

* xref:upgrading-postgresql.adoc[]

max-cx

Hi Anatolii, I reviewed the files. If you go through my suggestions and apply those that you agree with, then after that I will clone this branch and review and preview this PR locally to make any remaining edits, and then you will see/approve my final changes when I open a PR to your branch.

…sql.adoc

github-actions · 2022-10-26T08:06:33Z

⚡️ Deploying pull request preview...

…sql.adoc

…l.adoc

max-cx · 2022-10-26T08:11:29Z

I committed/applied some of my minor suggestions (like adding the and $) to save Anatolii's effort and time reviewing my suggested changes.

max-cx · 2022-11-30T15:03:32Z

Closing this PR after discussing it with @tolusha.

tolusha requested review from rkratky, themr0c and a team as code owners November 12, 2021 13:43

tolusha requested a review from svor November 12, 2021 13:43

tolusha mentioned this pull request Nov 12, 2021

Che Deploy Sprint #210 eclipse-che/che#20748

Closed

27 tasks

che-bot added the status/code-review label Nov 12, 2021

Database migration guides

2e542c1

Signed-off-by: Anatolii Bazko <abazko@redhat.com>

Fixup

734b733

Signed-off-by: Anatolii Bazko <abazko@redhat.com>

themr0c added this to the 7.40 milestone Nov 16, 2021

fixups

439974a

Signed-off-by: Anatolii Bazko <abazko@redhat.com>

Merge branch 'master' into backuprestoredb

364ad3c

themr0c changed the title ~~chore: Add PostgreSQL migration guides~~ procedures: Add PostgreSQL migration guides Nov 19, 2021

Merge branch 'master' into backuprestoredb

639e6f8

tolusha mentioned this pull request Nov 29, 2021

Che Deploy Sprint #211 eclipse-che/che#20839

Closed

28 tasks

themr0c added 5 commits December 9, 2021 13:12

Merge branch 'master' into backuprestoredb

22a45e1

Merge branch 'master' into backuprestoredb

0e5c536

Merge branch 'master' into backuprestoredb

30d48f9

Merge branch 'master' into backuprestoredb

70d5033

Merge branch 'master' into backuprestoredb

dd76b1c

themr0c reviewed Jan 10, 2022

View reviewed changes

modules/administration-guide/partials/snip_finding-che-user-name.adoc Show resolved Hide resolved

themr0c added 2 commits January 21, 2022 09:07

Merge branch 'master' into backuprestoredb

d2be4ed

Update modules/administration-guide/partials/snip_finding-che-user-na…

5b31623

…me.adoc

tolusha mentioned this pull request Jan 26, 2022

Che Deploy Sprint #213 eclipse-che/che#20993

Closed

28 tasks

max-cx reviewed Oct 17, 2022

View reviewed changes

max-cx requested changes Oct 17, 2022

View reviewed changes

Update modules/administration-guide/partials/proc_cleaning-up-postgre…

34508cf

…sql.adoc

max-cx requested a review from a team as a code owner October 26, 2022 08:06

max-cx added 7 commits October 26, 2022 10:06

Update modules/administration-guide/partials/proc_cleaning-up-postgre…

6ad0aee

…sql.adoc

Update modules/administration-guide/partials/proc_cleaning-up-postgre…

b4ee1ad

…sql.adoc

Update modules/administration-guide/partials/proc_cleaning-up-postgre…

38bc83a

…sql.adoc

Update modules/administration-guide/partials/proc_cleaning-up-postgre…

4fa32d5

…sql.adoc

Update modules/administration-guide/partials/proc_cleaning-up-postgre…

ced5002

…sql.adoc

Update modules/administration-guide/partials/proc_backuping-postgresq…

8e0fced

…l.adoc

Update modules/administration-guide/partials/proc_backuping-postgresq…

da9c72a

…l.adoc

max-cx closed this Nov 30, 2022

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

procedures: Add PostgreSQL migration guides #2163

procedures: Add PostgreSQL migration guides #2163

tolusha commented Nov 12, 2021 •

edited

Loading

github-actions bot commented Nov 12, 2021

github-actions bot commented Nov 15, 2021

github-actions bot commented Nov 16, 2021

github-actions bot commented Nov 16, 2021

github-actions bot commented Nov 17, 2021

themr0c commented Jan 25, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022 •

edited

Loading

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx Oct 17, 2022

max-cx left a comment

github-actions bot commented Oct 26, 2022 •

edited

Loading

max-cx commented Oct 26, 2022

max-cx commented Nov 30, 2022


		:context: migration-to-external-database-setup

		Follow the procedures below to migrate from internal to external database setup successfully without any data loss.

	Follow the procedures below to migrate from internal to external database setup successfully without any data loss.
	You can migrate from the internal database to an external database without losing data.


		By the 11th of November, 2021, the PostgreSQL version 9.6 came out of support, and {prod-short} team recommends that all users undergo migrating to version 13.

		Follow the procedures below to migrate to a newer version of PostgreSQL successfully without any data loss.

	Follow the procedures below to migrate to a newer version of PostgreSQL successfully without any data loss.
	You can upgrade to a newer version of PostgreSQL without losing data.


		:context: migration-from-postgresql-9-to-postgresql-13

		By the 11th of November, 2021, the PostgreSQL version 9.6 came out of support, and {prod-short} team recommends that all users undergo migrating to version 13.


		include::partial$snip_verification-che-working.adoc[]

		:context: {parent-context-of-migration-from-postgresql-9-to-postgresql-13}

	:context: {parent-context-of-migration-from-postgresql-9-to-postgresql-13}
	:context: {parent-context-of-upgrading-postgresql}


		:context: migration-from-helm-charts-to-operator

		Follow the procedures below to migrate from Helm Charts to Operator successfully without any data loss.

	Follow the procedures below to migrate from Helm Charts to Operator successfully without any data loss.
	You can migrate from Helm Charts to Operator without losing data.

		[id="migration-to-external-database-setup"]
		:navtitle: Migration to external database setup


		include::partial$proc_migration_from_postgresql_9_to_postgresql_13.adoc[]
		include::partial$assembly_migration-from-postgresql-9-to-postgresql-13.adoc[]

	include::partial$assembly_migration-to-external-database-setup.adoc[]
	include::partial$assembly_migration-to-an-external-database-setup.adoc[]

		[id="migration-from-postgresql-9-to-postgresql-13"]
		:navtitle: Migration from PostgreSQL 9 to PostgreSQL 13

	include::partial$assembly_migration-from-postgresql-9-to-postgresql-13.adoc[]
	include::partial$assembly_upgrading-postgresql.adoc[]

	** xref:migration-to-external-database-setup.adoc[]
	** xref:migration-to-an-external-database-setup.adoc[]

	* xref:migration-from-postgresql-9-to-postgresql-13.adoc[]
	* xref:upgrading-postgresql.adoc[]

procedures: Add PostgreSQL migration guides #2163

procedures: Add PostgreSQL migration guides #2163

Conversation

tolusha commented Nov 12, 2021 • edited Loading

What does this pull request change?

What issues does this pull request fix or reference?

Specify the version of the product this pull request applies to

Pull Request checklist

github-actions bot commented Nov 12, 2021

github-actions bot commented Nov 15, 2021

github-actions bot commented Nov 16, 2021

github-actions bot commented Nov 16, 2021

github-actions bot commented Nov 17, 2021

themr0c commented Jan 25, 2022

Choose a reason for hiding this comment

max-cx Oct 17, 2022 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

max-cx left a comment

Choose a reason for hiding this comment

github-actions bot commented Oct 26, 2022 • edited Loading

max-cx commented Oct 26, 2022

max-cx commented Nov 30, 2022

tolusha commented Nov 12, 2021 •

edited

Loading

max-cx Oct 17, 2022 •

edited

Loading

github-actions bot commented Oct 26, 2022 •

edited

Loading