From 4e1be7e22b28ced6213dbda7b73879e9b505d46e Mon Sep 17 00:00:00 2001 From: Joris Vial Date: Tue, 2 Nov 2021 06:39:34 +0000 Subject: [PATCH] GitBook: [#102] Update general timeline --- icon2.0-migration-guide.md | 102 ++++++++++++++++++++----------------- 1 file changed, 55 insertions(+), 47 deletions(-) diff --git a/icon2.0-migration-guide.md b/icon2.0-migration-guide.md index 62b2d66..680fbf7 100644 --- a/icon2.0-migration-guide.md +++ b/icon2.0-migration-guide.md @@ -34,21 +34,31 @@ Before Stage2, top 30 P-Reps must update to the latest ICON1 node version (iconl ### Timetable of migration -| Stage time (KST) | Actions | -| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | -|

10/25 10:00 | Stage 1-2

Who: Foundation

| ~~Backup the current snapshot db and upload~~ | -|

10/26

Who: Foundation

| ~~Test with migrated real ICON2 data~~ | -|

10/26

Who: Foundation

| ~~Deploy to guide documents~~ | -|

10/27 11:00 | Stage2

Who: P-Rep

| ~~Start the stage2~~ | -|

11/03 22:00 | Stage3-1

Who: Exchange / Citizen

| **Stop deposits and withdrawals on exchanges.** | -|

11/03 23:00 | Stage3-2

Who: Foundation

| Send a proposal. | -|

11/03 23:30 | Stage3-3

Who: P-Rep

| Wait for consensus proposal to be completed. | -|

11/04 23:40 | Stage3-4

Who: P-Rep

| ICON2 node is changed to import\_icon xxx finished state. | -|

11/04 00:00 | Stage3-6

Who: P-Rep

| \[Action required] Command to confirm end of migration. see the next section (Stage 3-6) | -|

11/04 00:50 | Stage3-9

Who: P-Rep

| Monitor whether consensus is reached and blocks are created | -|

11/04 01:00 | Finish

Who: Foundation

| Announce a successful migration. | -|

11/04 05:00

Who: Foundation

|

Upload the latest DB of ICON2.

Let you know, If we are ready.

| -|

11/04 05:00

Who: Exchange / Citizen

|

If you run a citizen,

Download a new ICON2 snapshot and run the node.

| +| Stage time (KST) | Actions | +| ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | +|

10/25 10:00 | Stage 1-2

Who: Foundation

| ~~Backup the current snapshot db and upload~~ | +|

10/26

Who: Foundation

| ~~Test with migrated real ICON2 data~~ | +|

10/26

Who: Foundation

| ~~Deploy to guide documents~~ | +|

10/27 11:00 | Stage2

Who: P-Rep

| ~~Start the stage2~~ | +|

11/03 22:00 | Stage3-1

Who: Exchange / Citizen

| **Stop deposits and withdrawals on exchanges. Stop all ICON1 citizens** | +|

11/03 23:00 | Stage3-2

Who: Foundation

| Send a proposal. | +|

11/03 23:30 | Stage3-3

Who: P-Rep

| Wait for consensus proposal to be completed. | +|

11/03 23:40 | Stage 3-4

Who: P-Rep

| ICON1 node and Citizen node will enter `suspend` state | +|

11/03 ~23:59 | Stage3-5

Who: P-Rep

| Wait for all ICON2 node reached to `import_icon xxx finished` state | +|

11/04 00:00 | Announcement

Who: Foundation

| The Foundation notifies P-Reps to enter a command: `chain stop` | +|

11/04 00:00 | Stage3-6

Who: P-Rep

| \[**Action required**] Command to confirm end of migration. see the next section (Stage 3-6) | +|

11/04 00:30

Who: Foundation

| Wait for all ICON2 nodes reached `stopped` state | +|

11/04 00:30

Who: Foundation

| Stop Migrators | +|

11/04 01:00

Who: Foundation

| Start Migrators | +|

11/04 01:10 | Announcement

Who: Foundation

| The Foundation notifies P-Reps to enter a command: `chain start` | +|

11/04 01:10 | Stage3-7

Who: P-Rep

| \[**Action required**] Command to confirm end of migration. see the next section (Stage 3-7) | +|

11/04 01:10 | Stage 3-8

Who: P-Rep & Foundation

| Monitor whether consensus is reached and blocks are created | +|

11/04 01:40

Who: Foundation

| Start Citizen node | +|

11/04 02:00 | Announcement

Who: Foundation

| Announce recovery endpoint. | +|

11/04 02:00 |

Who: Foundation

| Upload the latest ICON2 DB. We'll let you know, If we ready. | +|

11/04 02:00 | Announcement

Who: Foundation

| Announce a successful migration. | +| Migration complete | Migration complete | +|

11/04 05:00

Who: Exchange / Citizen

|

If you run a citizen,

Download a new ICON2 snapshot and run the node.

| ## Migration details @@ -137,41 +147,39 @@ The Foundation will let you know when you can setup your ICON2 citizen nodes. On #### Instructions for the ICON Foundation -| Stage 3-1 |

Block the network endpoint(ctz.solidwallet.io, wallet.icon.foundation) and prevent the creation of new Transactions.
Stop all ICON1 citizens.

| -| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| STAGE3-2 |

Send a transaction for a new revision (ICON2 Revision).

| -| STAGE3-3 | Wait for consensus proposal to be completed. | -| STAGE3-4 | ICON1 node and Citizen node will enter `suspend` state. | -| STAGE3-5 |

ICON2 node is changed to import_icon xxx finished state.

Wait for all ICON2 nodes reach to the target.
a. ICON1 consensus will stop at the target.
b. ICON2 import will stop at the target

| -| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain stop` | -| STAGE3-6 |

Enter the following command to confirm end of migration

| -| |

$ docker exec -it icon2-node goloop chain ls

[ { "cid": "0x1", "nid": "0x1", "channel": "icon_dex", "state": "import_icon 40123455 finished", "height": 6830, "lastError": "" } ]

Stop ICON2 migration task

Then ICON2 will fall in “import_icon finished” status after erasing all temporal data. To see the last block height, you need to stop again.

Wait for all ICON2 nodes reach to the target.

| -| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain start` | -| STAGE3-7 |

Start chain

docker exec -it icon2-node goloop chain start 0x1

Switch the ICON2 network and Start ICON2 consenesus.

| -| STAGE3-8 | PRep Completed migrations | -| STAGE3-9 | Foundation will make backup data with backup node(ICON2 Real data). Let you know, If we ready. | -| **Announcement** | Announce a successful migration | -| End of migration | :rocket: | +| Stage 3-1 |

Block the network endpoint(ctz.solidwallet.io, wallet.icon.foundation) and prevent the creation of new Transactions.
Stop all ICON1 citizens.

| +| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| STAGE3-2 |

Send a transaction for a new revision (ICON2 Revision).

| +| STAGE3-3 | Wait for consensus proposal to be completed. | +| STAGE3-4 | ICON1 node and Citizen node will enter `suspend` state. | +| STAGE3-5 |

ICON2 node is changed to import_icon xxx finished state.

Wait for all ICON2 nodes reach to the target.
a. ICON1 consensus will stop at the target.
b. ICON2 import will stop at the target

| +| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain stop` | +| STAGE3-6 |

Enter the following command to confirm end of migration

$ docker exec -it icon2-node goloop chain ls

[ { "cid": "0x1", "nid": "0x1", "channel": "icon_dex", "state": "import_icon 40123455 finished", "height": 6830, "lastError": "" } ]

Stop ICON2 migration task

Then ICON2 will fall in import_icon finished status after erasing all temporal data. To see the last block height, you need to stop again.

Wait for all ICON2 nodes reach to the target.

| +| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain start` | +| STAGE3-7 |

Start chain

docker exec -it icon2-node goloop chain start 0x1

Switch the ICON2 network and Start ICON2 consenesus.

| +| STAGE3-8 | PRep Completed migrations | +| STAGE3-9 | Foundation will make backup data with backup node(ICON2 Real data). We'll let you know If we're ready. | +| **Announcement** | Announce a successful migration | +| End of migration | :rocket: | #### Instructions for P-Reps -| Stage 3-1 | If you are running a citizen node, stop it. | -| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| STAGE3-2 |

Vote on the proposal with preptools.

P-Reps can't vote on icon.community. Use preptools to change the endpoint to your own ICON1 node P-Reps and vote.

| -| STAGE3-3 | Wait for consensus proposal to be completed. | -| STAGE3-4 | ICON1 node and Citizen node will enter `suspend` state. | -| STAGE3-5 |

ICON2 node is changed to import_icon xxx finished state.

Wait for all ICON2 nodes reach to the target.
a. ICON1 consensus will stop at the target.
b. ICON2 import will stop at the target

| -| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain stop` | -| STAGE3-6 |

Enter the following command to confirm end of migration

| -| |

$ docker exec -it icon2-node goloop chain ls

[ { "cid": "0x1", "nid": "0x1", "channel": "icon_dex", "state": "import_icon 40123455 finished", "height": 6830, "lastError": "" } ]

Stop ICON2 migration task

Then ICON2 will fall in “import_icon finished” status after erasing all temporal data. To see the last block height, you need to stop again.

Wait for all ICON2 nodes reach to the target.

| -| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain start` | -| STAGE3-7 |

Start chain

docker exec -it icon2-node goloop chain start 0x1

Switch the ICON2 network and Start ICON2 consenesus.

| -| STAGE3-8 | PRep Completed migrations | -| STAGE3-9 | Monitor whether consensus is reached and blocks are created. | -| **Announcement** | Shut down old ICON1 server. | -| End of migration | :rocket: | - -Instructions for Citizen node (Exchanges) +| Stage 3-1 | If you are running a citizen node, stop it. | +| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| STAGE3-2 |

Vote on the proposal with preptools.

P-Reps can't vote on icon.community. Use preptools to change the endpoint to your own ICON1 node P-Reps and vote.

| +| STAGE3-3 | Wait for consensus proposal to be completed. | +| STAGE3-4 | ICON1 node and Citizen node will enter `suspend` state. | +| STAGE3-5 |

ICON2 node is changed to import_icon xxx finished state.

Wait for all ICON2 nodes reach to the target.
a. ICON1 consensus will stop at the target.
b. ICON2 import will stop at the target

| +| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain stop` | +| STAGE3-6 |

Enter the following command to confirm end of migration

$ docker exec -it icon2-node goloop chain ls

[ { "cid": "0x1", "nid": "0x1", "channel": "icon_dex", "state": "import_icon 40123455 finished", "height": 6830, "lastError": "" } ]

Stop ICON2 migration task

Then ICON2 will fall in “import_icon finished” status after erasing all temporal data. To see the last block height, you need to stop again.

Wait for all ICON2 nodes reach to the target.

| +| **Announcement** | **The Foundation notifies PReps to enter a command**: `chain start` | +| STAGE3-7 |

Start chain

docker exec -it icon2-node goloop chain start 0x1

Switch the ICON2 network and Start ICON2 consenesus.

| +| STAGE3-8 | PRep Completed migrations | +| STAGE3-9 | Monitor whether consensus is reached and blocks are created. | +| **Announcement** | Shut down old ICON1 server. | +| End of migration | :rocket: | + +#### Instructions for Citizen node (Exchanges) | Stage 3-1 | Exchanges should stop deposits and withdrawals. | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |