Converting the Change Increment ID KB to devdocs #5129

dobooth · 2019-08-06T19:05:44Z

Purpose of this pull request

This pull request (PR) converts a KB article into a devdoc.

Affected DevDocs pages

http://devdocs.magento.com/guides/v2.2/config-guide/multi-site/change-increment-id.html

whatsnew
Added the Change increment ID for a database entity on particular store topic to the Configuration Guide.

dshevtsov · 2019-08-07T19:11:29Z

@dobooth did you check the topics with rake check?

dshevtsov

General: The topics for 2.2 and 2.3 are identical. Is there a reason to not create a symlink?

Also, see my review comments to the changed files.

dshevtsov · 2019-08-09T15:25:55Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+1. Find stores and entities for which the new increment ID should be changed.
+1. Connect to your MySQL DB.
+   For Magento Commerce (Cloud), at first, you need to SSH to your environment.


to SSH -> to connect using SSH

replace Magento Commerce (Cloud) with a variable

Dun and Dun

dshevtsov · 2019-08-09T15:26:20Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x


replace Magento Commerce with a variable

dshevtsov · 2019-08-09T16:04:25Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x


replace Magento Commerce (Cloud) with a variable

dshevtsov · 2019-08-09T16:05:08Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x
+-  MySQL: any supported version


Add a link to the topic and section that lists supported versions

dshevtsov · 2019-08-09T16:09:17Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+```
+
+{: .bs-callout-info}
+Important: The new increment value must be greater than the current one, not less.


remove , not less

dshevtsov · 2019-08-09T16:14:59Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+The next order placed at the store with `ID=1` will have the ID '#100002000'.
+
+## Additional recommended steps on production environments (cloud)


cloud -> Cloud

Don't use cloud in parenthesis.

Nobody puts baby in the corner.

dshevtsov · 2019-08-09T16:17:08Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+## Additional recommended steps on production environments (cloud)
+
+Before executing the `ALTER TABLE` query on a production environment of Magento Commerce (Cloud), we strongly recommend performing these steps:


replace Magento Commerce (Cloud) with a variable

dshevtsov · 2019-08-09T16:19:07Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x


replace Magento Commerce with a variable

dshevtsov · 2019-08-09T16:19:22Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x


replace Magento Commerce (Cloud) with a variable

dshevtsov · 2019-08-09T16:19:50Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x
+-  MySQL: any supported version


add a link to the topic that lists the supported versions

hguthrie · 2019-08-12T14:22:15Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+1. Find stores and entities for which the new increment ID should be changed.
+1. Connect to your MySQL DB.
+   For Magento Commerce (Cloud), at first, you need to SSH to your environment.


Variable for Magento Commerce cloud is {{site.data.var.ece}}

hguthrie · 2019-08-12T14:23:30Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+-  Some order records have been lost, but their IDs are already being used by payment gateways (like PayPal) for your current Merchant account. Such being the case, the payment  gateways stop processing new orders that have the same IDs, returning the "Duplicate invoice id" error
+
+{: .bs-callout-info}
+You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See the Knowledge Base article: [PayPal gateway rejected request - duplicate invoice issue][] .


Suggested change

You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See the Knowledge Base article: [PayPal gateway rejected request - duplicate invoice issue][] .

You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See [PayPal gateway rejected request - duplicate invoice issue][] in the _Knowledge Base_.

hguthrie · 2019-08-12T14:24:16Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+## Additional recommended steps on production environments (cloud)
+
+Before executing the `ALTER TABLE` query on a production environment of Magento Commerce (Cloud), we strongly recommend performing these steps:


Variable for cloud...

hguthrie · 2019-08-12T14:25:23Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+-  Test the entire procedure of changing the increment ID on your Staging environment
+-  [Create a DB backup][] to restore your Production DB in case of failure
+
+## Related documentation


Boo...these related sections are draining and prone to URL maintenance. I would work links in to the content where it is relevant, or remove them completely.

I think they are ok.

hguthrie · 2019-08-12T14:26:13Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+The next order placed at the store with `ID=1` will have the ID '#100002000'.
+
+## Additional recommended steps on production environments (cloud)


Don't use cloud in parenthesis.

hguthrie · 2019-08-12T14:26:26Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+-  Test the entire procedure of changing the increment ID on your Staging environment
+-  [Create a DB backup][] to restore your Production DB in case of failure
+
+## Related documentation


Keeping it.

dobooth

All points taken.

dobooth · 2019-08-12T15:03:44Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x


dobooth · 2019-08-12T15:03:57Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+## Affected versions
+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x


dobooth · 2019-08-12T15:04:04Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+-  Magento Commerce (on premise): 2.x.x
+-  Magento Commerce (Cloud): 2.x.x
+-  MySQL: any supported version


dobooth · 2019-08-12T15:04:12Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+-  Some order records have been lost, but their IDs are already being used by payment gateways (like PayPal) for your current Merchant account. Such being the case, the payment  gateways stop processing new orders that have the same IDs, returning the "Duplicate invoice id" error
+
+{: .bs-callout-info}
+You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See the Knowledge Base article: [PayPal gateway rejected request - duplicate invoice issue][] .


dobooth · 2019-08-12T15:04:17Z

guides/v2.2/config-guide/multi-site/change-increment-id.md

+
+1. Find stores and entities for which the new increment ID should be changed.
+1. Connect to your MySQL DB.
+   For Magento Commerce (Cloud), at first, you need to SSH to your environment.


dobooth · 2019-08-12T15:05:40Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+    SHOW TABLE STATUS FROM `{database_name}` WHERE `name` LIKE 'sequence_{entity_type}_{store_id}';
+    ```
+
+## Example


Removed them.

dobooth · 2019-08-12T15:05:47Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+```
+
+{: .bs-callout-info}
+Important: The new increment value must be greater than the current one, not less.


dobooth · 2019-08-12T15:06:09Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+The next order placed at the store with `ID=1` will have the ID '#100002000'.
+
+## Additional recommended steps on production environments (cloud)


Nobody puts baby in the corner.

dobooth · 2019-08-12T15:06:13Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+
+## Additional recommended steps on production environments (cloud)
+
+Before executing the `ALTER TABLE` query on a production environment of Magento Commerce (Cloud), we strongly recommend performing these steps:


dobooth · 2019-08-12T15:06:25Z

guides/v2.3/config-guide/multi-site/change-increment-id.md

+-  Test the entire procedure of changing the increment ID on your Staging environment
+-  [Create a DB backup][] to restore your Production DB in case of failure
+
+## Related documentation


Keeping it.

dshevtsov · 2019-08-12T16:43:02Z

General: The topics for 2.2 and 2.3 are identical. Is there a reason to not create a symlink?

dobooth · 2019-08-12T20:36:32Z

Yes, because I couldn't get the symlink to work correctly. So I made a separate topic, which will go away soon enough.

dshevtsov · 2019-08-12T22:01:01Z

@dobooth what was the issue with symlink?

dobooth · 2019-08-13T13:43:01Z

'User error' I'm sure.

dobooth · 2019-08-15T20:20:05Z

running tests

ghost · 2019-08-15T20:36:52Z

Hi @dobooth, thank you for your contribution!
Please, complete Contribution Survey, it will take less than a minute.
Your feedback will help us to improve contribution process.

dobooth added 5 commits August 6, 2019 13:19

Converting KB article to devdocs

42d4cc0

Add symlink

b4076c0

Grrr

3767649

Symlink nightmare

cf2e890

Versioned

30981b0

dobooth added 2.2.x 2.3.x Magento 2.3 related changes New Topic A major update published as an entirely new document labels Aug 6, 2019

dobooth self-assigned this Aug 6, 2019

m2-community-project bot added the Progress: review label Aug 6, 2019

dobooth changed the title ~~Db kb conversion~~ Converting the Change Increment Id KB to devdocs Aug 6, 2019

dobooth added 4 commits August 7, 2019 11:26

Update links

ebe870c

Update links

8298009

Fixed title

10b69d0

Fixed title

0984bab

dobooth requested a review from dshevtsov August 7, 2019 16:29

dobooth changed the title ~~Converting the Change Increment Id KB to devdocs~~ Converting the Change Increment ID KB to devdocs Aug 7, 2019

dobooth added 2 commits August 9, 2019 09:52

Fixed linting errors

417e2db

Fixed linting errors

ce920bc

dshevtsov suggested changes Aug 9, 2019

View reviewed changes

m2-community-project bot assigned dshevtsov Aug 9, 2019

m2-community-project bot added Progress: changes requested and removed Progress: review labels Aug 9, 2019

dshevtsov removed their assignment Aug 9, 2019

hguthrie suggested changes Aug 12, 2019

View reviewed changes

m2-community-project bot assigned hguthrie Aug 12, 2019

dobooth commented Aug 12, 2019

View reviewed changes

Fixes per review

5d036a4

dobooth requested a review from hguthrie August 12, 2019 15:44

dobooth requested a review from dshevtsov August 12, 2019 15:44

hguthrie approved these changes Aug 12, 2019

View reviewed changes

dobooth and others added 2 commits August 15, 2019 10:39

Merge branch 'master' into db_kb_conversion

4a066cb

Replace 2.3 with a symlink and fix style

92cbd1e

dshevtsov approved these changes Aug 15, 2019

View reviewed changes

m2-community-project bot assigned dshevtsov Aug 15, 2019

m2-community-project bot added Progress: approved and removed Progress: changes requested labels Aug 15, 2019

Merge branch 'master' into db_kb_conversion

0b63b1f

dobooth merged commit 72793ad into master Aug 15, 2019

dobooth deleted the db_kb_conversion branch August 15, 2019 20:36

m2-community-project bot removed the Progress: approved label Aug 15, 2019


		The next order placed at the store with `ID=1` will have the ID '#100002000'.

		## Additional recommended steps on production environments (cloud)


		## Additional recommended steps on production environments (cloud)

		Before executing the `ALTER TABLE` query on a production environment of Magento Commerce (Cloud), we strongly recommend performing these steps:

	You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See the Knowledge Base article: [PayPal gateway rejected request - duplicate invoice issue][] .
	You may also fix the payment gateway issue for PayPal by allowing multiple payments per invoice ID in PayPal's Payment Receiving Preferences. See [PayPal gateway rejected request - duplicate invoice issue][] in the _Knowledge Base_.

Converting the Change Increment ID KB to devdocs #5129

Converting the Change Increment ID KB to devdocs #5129

Uh oh!

Conversation

dobooth commented Aug 6, 2019 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose of this pull request

Affected DevDocs pages

Uh oh!

dshevtsov commented Aug 7, 2019

Uh oh!

dshevtsov left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dobooth commented Aug 6, 2019 •

edited

Loading