Skip to content

Latest commit

 

History

History
162 lines (105 loc) · 5.3 KB

MIGRATE_CHAIN_INSTRUCTION_DEPRECATED.md

File metadata and controls

162 lines (105 loc) · 5.3 KB

Migrate chain instructions (DEPRECATED)

Prerequisites

Clone migation-tools

  1. Clone the project

    git clone https://github.com/ndidplatform/migration-tools.git

Disable chain

  1. SetLastBlock through NDID API path POST /set_last_block or /setLastBlock for older versions

    body

    {
   block_height: number
}

    Example:

    curl -vkX POST https://IP:PORT/ndid/set_last_block \
   -H "Content-Type: application/json" \
   -d "{\"block_height\":0}"
  • block_height คือเลข Block สุดท้ายที่จะให้สามารถทำ Transaction ลง Blockchain ได้ (block_height = 0 คือ setLastBlock เท่ากับ Block ปัจจุบัน และ -1 คือ ยกเลิกการ SetLastBlock)

Backup data

  1. Save/Write down NDID node ID(s), master public key, and public key. These values can be queried using GET /utility/nodes/<NDID_NODE_ID>

    Example:

    curl -vkX GET https://localhost:8443/utility/nodes/ndid1 \
   -H "Content-Type: application/json"

  2. Stop Tendermint and ABCI (did-tendermint)

  3. Backup data directories and files of the current chain (both Tendermint and ABCI data)

  4. Run migration command in migration-tools to convert and backup data from state DB / ABCI to files

    Example:

    cd migration-tools

TM_HOME=/home/support/ndid/ndid/tendermint/ \
ABCI_DB_DIR_PATH=/home/support/ndid/ndid/data/ndid/abci/ \
go run main.go convert-and-backup 6 7

    or run with C lib support for LevelDB (in case DB to backup uses cleveldb):

    TM_HOME=/home/support/ndid/ndid/tendermint/ \
ABCI_DB_DIR_PATH=/home/support/ndid/ndid/data/ndid/abci/ \
CGO_ENABLED=1 CGO_LDFLAGS="-lsnappy" go run -tags "cleveldb" main.go convert-and-backup 6 7
    • TM_HOME คือ Home directory ของ Tendermint
    • ABCI_DB_DIR_PATH คือ Directory state DB ของ ABCI

  5. (Optional) Remove all service containers (Tendermint-ABCI did-tendermint, API, and redis)

    Example:

    docker-compose down

Remove previous chain data

  1. Reset blockchain data

    Example (using docker compose):

    docker-compose run --rm tm-abci unsafe_reset_all

  2. Remove ABCI data / stateDB

    Example:

    rm -rf /path/to/abci/data/directory/abci/didDB.db

  3. (Optional) Remove/clear API service's redis cache

Restore data

  1. Pull new docker image version

  2. เอา config.toml และ genesis.json อันใหม่ไปวางใน directory config ที่ Tendermint home directory

  3. แก้ TM_P2P_PORT ของ tendermint ใน .env file เพื่อไม่ให้ node อื่นต่อเข้ามาได้ระหว่าง restore

  4. เปิด docker container เฉพาะของ ABCI ขึ้นมาเพื่อจะทำการ restore

  5. Copy master private key ของ NDID ไปวางไว้ที่ $GOPATH/src/github.com/ndidplatform/migration-tools/key/ ตั้งชื่อไฟล์ว่า ndid_master และ Copy private key ของ NDID ไปวางไว้ที่ $GOPATH/src/github.com/ndidplatform/migration-tools/key/ ตั้งชื่อไฟล์ว่า ndid (ถ้าใช้ external key service เช่น HSM ให้ใช้ key ใดๆก่อนก็ได้ แล้วสั่งเปลี่ยน public key หลัง restore สำเร็จ)

  6. Run script จาก migration-tools เพื่อ restore ข้อมูล

    Example:

    cd migration-tools

NDID_NODE_ID=<NDID_NODE_ID> \
TENDERMINT_RPC_HOST=localhost \
TENDERMINT_RPC_PORT=26000 \
BACKUP_DATA_DIR=<PATH_TO_BACKUP_DIRECTORY> \
go run main.go restore 7
    • NDID_NODE_ID คือ ชื่อ node_id ของ NDID ที่จะใช้ initialize/register
    • TENDERMINT_RPC_HOST คือ Tendermint RPC host
    • TENDERMINT_RPC_PORT คือ Tendermint RPC port
    • BACKUP_DATA_DIR คือ directory ที่มีข้อมูลที่ convert แล้วเป็น JSON อยู่ในรูปแบบ text file

  7. หลังจาก restore เสร็จเรียบร้อยแล้ว stop docker container ของ ABCI (did-tendermint)

  8. แก้ TM_P2P_PORT ของ tendermint ใน .env file คืนค่าเดิม เพื่อให้ node อื่น ๆ สามารถต่อเข้ามาได้

  9. Start docker containers (Tendermint-ABCI did-tendermint, API, and redis)

    Example:

    docker-compose up

  10. (Optional) Set NDID node master public key and public key

Example:

cd migration-tools

NDID_NODE_ID=<NDID_NODE_ID> \
TENDERMINT_RPC_HOST=localhost \
TENDERMINT_RPC_PORT=26000 \
NODE_NEW_MASTER_PUBLIC_KEY_FILEPATH=<PATH_TO_NODE_NEW_MASTER_PUBLIC_KEY_FILE> \
NODE_NEW_PUBLIC_KEY_FILEPATH=<PATH_TO_NODE_NEW_PUBLIC_KEY_FILE> \
go run main.go update-node 7