Configuration file migration tool

Meri Herrera edited this page Sep 5, 2018 · 6 revisions

This is a simple program that makes it easier to upgrade configuration file. It changes keys but not values. Follow hereby instructions:

1. Upgrade your node

  • Using intalled node: Install and run the latest RSK node here.
  • Using compiled node: Compile RSKJ code. Click here for further information.

2. Download migration file

From version To version migration.properties
v0.4.0 or earlier v0.4.1 / v0.4.2 LINK
v0.4.2 v0.4.3 or later LINK

You can also create your own migration file.

3. Run tool

migration.properties is a properties file which describes the mapping between the old and the new configuration. For example:

bind.address = bind_address

If you want to add a new key, you could add the prefix [new] and the value this way:

[new]rpc.host = ["localhost"]

The migration must be invoked with:

java -cp [jar] co.rsk.cli.config.MigrationTool -i [original.conf] -m [migration.properties] (-o output.config) (--replace)

Where you should replace:

  • [jar] : path to RSK .jar file, for example ../ rskj-core-0.4.4-BAMBOO-all.jar.
  • [original.conf] : full path to configuration file that wants to be migrated.
  • [migration.properties] : full path to migration.properties file.

As an invocation example:

java -cp rskj-core-0.4.4-BAMBOO-all.jar co.rsk.cli.config.MigrationTool -i /home/user/Documents/testnet.conf -m /home/user/Documents/migration.properties

You don't need to specify an output file, a new file will be created in the same location as the previous config file appending a .new suffix. This behavior can be overridden by a -o option indicating the new config file name, or with --replace which will overwrite the original file (use this one with caution).

4. Rename new configuration file

If newly created file containes .new suffix, rename it and restart node.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.