From 9b382d7a113ead6c7d2a0691caaa3e3739cf7ae0 Mon Sep 17 00:00:00 2001 From: Zach Ramsay Date: Wed, 18 Oct 2017 08:00:01 -0400 Subject: [PATCH 1/2] docs: remove mention of type byte --- docs/getting-started.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/getting-started.rst b/docs/getting-started.rst index ac91f7404..f2f03e79c 100644 --- a/docs/getting-started.rst +++ b/docs/getting-started.rst @@ -153,11 +153,10 @@ The result should look like: } } -Again, the ``112`` is the type-byte. Note the ``value`` in the result -(``61626364``); this is the hex-encoding of the ASCII of ``abcd``. You -can verify this in a python shell by running -``"61626364".decode('hex')``. Stay tuned for a future release that makes -this output more human-readable ;). +Note the ``value`` in the result (``61626364``); this is the +hex-encoding of the ASCII of ``abcd``. You can verify this in +a python shell by running ``"61626364".decode('hex')``. Stay +tuned for a future release that makes this output more human-readable. Now let's try setting a different key and value: From fa07dbd7ec69bed686c88503e78dd496fae9e9a5 Mon Sep 17 00:00:00 2001 From: Zach Ramsay Date: Wed, 18 Oct 2017 08:47:58 -0400 Subject: [PATCH 2/2] docs: add info about tm-migrate --- docs/ecosystem.rst | 5 +++++ docs/using-tendermint.rst | 8 ++++++++ 2 files changed, 13 insertions(+) diff --git a/docs/ecosystem.rst b/docs/ecosystem.rst index 2bc390c90..dc643c5bd 100644 --- a/docs/ecosystem.rst +++ b/docs/ecosystem.rst @@ -115,3 +115,8 @@ Deployment Tools See `deploy testnets <./deploy-testnets.html>`__ for information about all the tools built by Tendermint. We have Kubernetes, Ansible, and Terraform integrations. Cloudsoft built `brooklyn-tendermint `__ for deploying a tendermint testnet in docker continers. It uses Clocker for Apache Brooklyn. + +Dev Tools +--------- + +For upgrading from older to newer versions of tendermint and to migrate your chain data, see `tm-migrator `__ written by @hxzqlh. diff --git a/docs/using-tendermint.rst b/docs/using-tendermint.rst index cc94245cd..0228dcbf6 100644 --- a/docs/using-tendermint.rst +++ b/docs/using-tendermint.rst @@ -386,3 +386,11 @@ the listening addresses of the various sockets don't conflict. Additionally, you must set ``addrbook_strict=false`` in the ``config.toml``, otherwise Tendermint's p2p library will deny making connections to peers with the same IP address. + +Ugrading +~~~~~~~~ + +The tendermint development cycle includes a lot of breaking changes. Upgrading from +an old version to a new version usually means throwing away the chain data. Try out +the `tm-migrate `__ tool written by @hxqlh if +you are keen to preserve the state of your chain when upgrading to newer versions.