[incubator-skywalking] branch peng-yongsheng-patch-2 created (now d487fb5)

[pe...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

pengys pushed a change to branch peng-yongsheng-patch-2
in repository https://gitbox.apache.org/repos/asf/incubator-skywalking.git.


      at d487fb5  Create backend-upgrade.md

This branch includes the following new commits:

     new d487fb5  Create backend-upgrade.md

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

[incubator-skywalking] 01/01: Create backend-upgrade.md

[pe...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

pengys pushed a commit to branch peng-yongsheng-patch-2
in repository https://gitbox.apache.org/repos/asf/incubator-skywalking.git

commit d487fb52f02074f4dc8f7f4b85faa11de4bd3370
Author: 彭勇升 pengys <pe...@apache.org>
AuthorDate: Thu Dec 6 00:18:59 2018 +0800

    Create backend-upgrade.md
    
    A document for how to upgrade the SkyWalking to new edition.
---
 docs/en/setup/backend/backend-upgrade.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/docs/en/setup/backend/backend-upgrade.md b/docs/en/setup/backend/backend-upgrade.md
new file mode 100644
index 0000000..866a7fe
--- /dev/null
+++ b/docs/en/setup/backend/backend-upgrade.md
@@ -0,0 +1,26 @@
+# Backend upgrade
+First and most important thing is, SkyWalking agent caching the key-value of the metadata, i.e., the service id and service name, the serice instance id and service instance name, the endpoint id and endpoint name. The backend will not working after you clear the metadata from elasticsearch database but not restart the agent.
+
+**Remember to convert metadata from the old models to the new models.** 
+
+There are three ways for upgrade SkyWalking.
+1. Upgrade without transform metadata
+1. Upgrade by transform metadata
+
+## Upgrade without transform metadata
+1. Shutdown the backend and clean the buffer data
+1. Shutdown the database and clean the models
+1. Download the release package and unpack it
+1. Setting the `application.yml`
+1. Setting the `gRPCPort` to be different from the old edition **It's very important**
+1. Startup the database
+1. Startup the backend 
+1. Startup the agent one by one
+
+## Upgrade by migration metadata
+1. To view the model changes from the release note.
+1. Write data migration scripts
+1. Backup databse data
+1. Migrate data to a new database
+1. Startup the database
+1. Startup the backend