Skip to content

Commit 0c187cc

Browse files
committed
Improve steps on how to migrate from an existing setup
1 parent 8f64a77 commit 0c187cc

File tree

3 files changed

+27
-8
lines changed

3 files changed

+27
-8
lines changed

.pre-commit-config.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,4 @@ repos:
1717
rev: v0.38.0
1818
hooks:
1919
- id: markdownlint-docker
20-
args: ["--config", ".markdownlint.json"]
20+
args: ["--config", ".markdownlint.json", "--disable", "MD046"]

docs/installation/installation.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ To set up a new Voi node, run the following command:
1414

1515
## Using an Existing Account/Address with Mnemonic
1616

17+
!!! tip inline end
18+
If you are migrating from an existing setup, and want to use the same account/mmenomic with Voi Swarm
19+
this is the option for you.
20+
1721
If you have an existing account/address with a mnemonic that you want to use, set the **VOINETWORK_IMPORT_ACCOUNT**
1822
environment variable to **1** and run the installation script:
1923

@@ -22,6 +26,9 @@ export VOINETWORK_IMPORT_ACCOUNT=1
2226
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/VoiNetwork/voi-swarm/main/install.sh)"
2327
```
2428

29+
???+ info
30+
Post-installation steps for migrating from a D13 based setup can be [found here](../migrating.md)
31+
2532
## Installing Without Wallet Setup
2633

2734
If you want to install without including wallet setup, set the **VOINETWORK_SKIP_WALLET_SETUP** environment variable to

docs/migrating.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,35 @@
22

33
## From D13 based setups
44

5-
=== "Installing on same server"
5+
Install Voi Swarm on your server by importing your existing wallet using your mnemonic:
66

7-
To help migrate from D13 based setups, there's a migration command available. This command will
7+
```bash
8+
export VOINETWORK_IMPORT_ACCOUNT=1
9+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/VoiNetwork/voi-swarm/main/install.sh)"
10+
```
811

9-
1. Duplicate telemetry settings, including existing telemetry name and GUID, without affecting rewards.
10-
2. Stop the host-based Voi service
11-
3. Restart Voi Swarm
12+
=== "Installing on same server"
13+
14+
To migrate your setup on an existing server you must first install Voi Swarn on your server using the
15+
[installation instructions](../installation/installation/#using-an-existing-accountaddress-with-mnemonic), after this
16+
you can migrate your existing setup by running this command:
1217

13-
To run this command, you must [install Voi Swarm](../installation/installation/) first. Then run the following command:
1418

1519
```bash
1620
~/voi/bin/migrate-from-d13-setup
1721
```
1822

23+
This command will do the following steps for you:
24+
25+
1. Duplicate telemetry settings, including existing telemetry name and GUID, without affecting rewards.
26+
2. Stop the host-based Voi service
27+
3. Restart Voi Swarm
28+
1929
=== "Installing on a new server"
2030

21-
To migrate to a new server, you must first [install Voi Swarm](../installation/installation/) on the new server.
31+
To migrate your setup to a new server you must first install Voi Swarm on the new server using the
32+
[installation instructions](../installation/installation/#using-an-existing-accountaddress-with-mnemonic), after this
33+
you can migrate your existing setup by following these steps:
2234

2335
1. Run the following command on the old server to get the telemetry name and GUID:
2436

0 commit comments

Comments
 (0)