Snapshots create and apply draft

Open Beginner friendly
#116 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
docker
Domain
devops, tooling

Research direction

The issue describes creating and applying snapshots for sharder and miner nodes. Start by examining the repository structure to locate existing scripts in the zcnwebappscripts project. Look for any related scripts in the codebase that handle docker commands or data backup. Verify the folder paths mentioned (/var/0chain/sharder/ssd, etc.) against the project's documentation or configuration files. The task is to document these steps, so ensure the final documentation is placed in an appropriate location, such as a README or a docs folder.

Written by the indexing model from the issue text.

Description

documentation

Create snapshorts

Create sharder snapshots

Use sharder1 on mainnet as an example, we need to stop both the sharder and postgres docker containers first. Then find all the data folders, compress them and upload to the snapshots server.

get data in /var/0chain/sharder/ssd folder and compress:

tar -czvf sharder-ssd.tar.gz /var/0chain/sharder/ssd/docker.local/data

# upload the ssharder-ssd.tar.gz to snapshots server

get data in /var/0chain/sharder/hdd folder and compress:

tar -czvf sharder-hdd.tar.gz /var/0chain/sharder/hdd/docker.local/sharder1/data

# upload the sharder-hdd.tar.gz to snapshots server

Create miner snapshot

Stop the miner docker container, then compress the data folder:

tar -czvf miner-ssd.tar.gz /var/0chain/miner/ssd/docker.local/miner1/data

# upload the miner-ssd.tar.gz to snapshots server

Apply snapshots

Sharder

The first step is ensure both sharder and postgres are not running, stop them otherwise.

Download the snapshots from the snapshots server, get both sharder-ssd.tar.gz and sharder-hdd.tar.gz . Suppose the sharder has the same folder structure, before applying the snapshots, please backup the existing data if any.

Extract the ssd sharder data

tar -xzvf sharder-ssd.tar.gz -C /var/0chain/sharder/ssd/docker.local/sharder1/data/

Extract the hdd sharder data

tar -xzvf sharder-hdd.tar.gz -C /var/0chain/sharder/hdd/docker.local/sharder1/data/

Once extracted, we can start the sharder and postgres docker containers.

Miner

Stop the miner and redis if they are running. There are 2 redis instances, miner*_redis_1 and miner*_redis_txns_1. So make sure they are both stopped.

Download the snapshot from server.
Backup the data if any.

Extract the snapshot to the miner's data folder, for our miner server, we can do:

tar -xzvf miner-ssd.tar.gz -C /var/0chain/miner/ssd/docker.local/miner1/data/

Start the miner and redis containers

Dominant language
Shell
Stars
1
Forks
2
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from 0chain/zcnwebappscripts

All issues in 0chain/zcnwebappscripts

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.