如何進(jìn)行Forge鏈的硬升級

在「如何獲取最新版的 Forge」中我們介紹了如何進(jìn)行Forge鏈的硬升級（需要重置本地鏈的狀態(tài)），硬升級的做法在開發(fā)環(huán)境下比較方便，相當(dāng)于清空數(shù)據(jù)庫的記錄。

而有些時(shí)候，可能你的測試鏈跑了一段時(shí)間，上面產(chǎn)生了不少測試數(shù)據(jù)，重新產(chǎn)生這些測試數(shù)據(jù)可能費(fèi)時(shí)費(fèi)力，你既希望升級到最新版的 Forge，又希望保留之前啟動(dòng)過的鏈的狀態(tài)，魚與熊掌可以兼得么？答案是肯定的，接下來我們來討論具體的操作步驟。

在介紹升級步驟之前，我們有必要再次強(qiáng)調(diào)下鏈的升級在不同上下文的區(qū)別：

?在開發(fā)環(huán)境我們可以毫無顧慮的進(jìn)行鏈的重置、升級、啟停，因?yàn)槟悴粫?huì)影響到其他人或者用戶

?在生產(chǎn)環(huán)境，因?yàn)檎麄€(gè)區(qū)塊鏈?zhǔn)欠植际降木W(wǎng)絡(luò)，升級的動(dòng)作需要由鏈的運(yùn)營者來決定，而升級的結(jié)果需要在整條鏈的所有節(jié)點(diǎn)間同步

本文探討的是前面一種情況，即開發(fā)環(huán)境下的具體做法。

準(zhǔn)備工作

Forge CLI 是 ArcBlock 官方開發(fā)和維護(hù)的管理本地 Forge 鏈、節(jié)點(diǎn)的命令行工具，建議定期升級 Forge CLI［1］ 到最新版本：npm install -g @arcblock/forge-cli。

了解 Forge 最新版本

你讀到這篇文章時(shí)，已經(jīng)發(fā)布的最新的 Forge 版本是：

了解 Forge 本地版本

如果你想知道本地 Forge 鏈的版本，直接運(yùn)行：forge status，得到如下執(zhí)行結(jié)果：

其中紅色圈圈中的版本就是當(dāng)前鏈所使用的版本，我本地鏈的版本是 v0.36.5。

當(dāng)然，你也可以執(zhí)行：forge ls，得到如下執(zhí)行結(jié)果：

其中紅框圈出的版本也是當(dāng)前鏈?zhǔn)褂玫陌姹?，forge ls 會(huì)列出本地已經(jīng)下載過的所有可使用的 Forge 版本，并把當(dāng)前使用的版本高亮出來。

升級的前提是我們本地使用的版本比遠(yuǎn)程的最新版本低，如果兩個(gè)版本相同的話，你可以到此打住啦，哈哈！

下載 Forge 最新版

如果要把本地 Forge 鏈從 v0.36.5 升級到 v0.37.0，需要先下載 Forge v0.37.0 的全部組件，執(zhí)行如下命令：

forge download latest

# 中國用戶

forge download latest --mirror http://arcblock.oss-cn-beijing.aliyuncs.com

可能有人會(huì)問，forge download 和 forge install 有啥區(qū)別？兩者都會(huì)從我們的鏡像下載指定版本（或最新版）的 Forge，不同點(diǎn)在于 forge download 只會(huì)下載，而 forge install 下載完之后會(huì)把本地使用的 Forge 版本切換到剛下載的版本，硬升級的時(shí)候用的就是 forge install。

怎么確定有沒有切換本地當(dāng)前使用的 Forge 版本？再次執(zhí)行 forge ls：

可以看到，被高亮的還是 v0.36.5。

配置鏈管理員

對于區(qū)塊鏈來說，所使用軟件的版本其實(shí)相當(dāng)于安裝在電腦硬件上的操作系統(tǒng)，如果要升級操作系統(tǒng)的版本，我們要輸入管理員密碼、把操作系統(tǒng)停下來、重新啟動(dòng)完成升級，如果你經(jīng)歷過操作系統(tǒng)的升級，F(xiàn)orge 鏈的升級就很好理解。

首先，我們需要給鏈配置 1 個(gè)管理員（moderator，本意是協(xié)調(diào)員，因?yàn)閰^(qū)塊鏈本身需要在多節(jié)點(diǎn)，在多節(jié)點(diǎn)間達(dá)成共識(shí)需要協(xié)調(diào)員），而任何能夠修改鏈狀態(tài)的實(shí)體本質(zhì)都是一個(gè)錢包，即公私鑰對，對于沒有配置過鏈管理員的同學(xué)，需要先用 forge wallet:create --defaults 來生成一個(gè)管理員錢包，并且保存好錢包私鑰。

為了后續(xù)方便，我們先把鏈管理員私鑰配置到環(huán)境變量里面，把下面這行加到你的 ~/.bashrc 或者 ~/.zshrc 里面（記得把私鑰換成你生成的那個(gè)）：

export FORGE_MODERATOR_SK=“qDWzV5cv8wSa-I2CKiLHm3msM9GeYyjOo4yo3iNicT8xlZqcdY_o0REVnffjD_wq85sCjoka6B7D-BLPxcXUcA”

如何確保你正確把管理員私鑰導(dǎo)出到了環(huán)境變量里面？直接執(zhí)行 echo $FORGE_MODERATOR_SK，如果有結(jié)果輸出并且和你生成的私鑰相同，說明配置正確。

接下來我們需要把鏈管理員信息添加到 Forge 的配置里面：

?如果你使用的是 Forge CLI v0.36.0 以下的版本，并且按本文操作時(shí)沒有升級到最新版，你的配置文件在：~/.forge_release/forge_release.toml

?如果你使用的是 Forge CLI v0.36.0 及以上版本，你的配置文件在：~/.forge_chains/forge_default/forge_release.toml

當(dāng)然，我們有更簡單的方式，直接獲取 Forge 鏈配置文件的路徑：forge config | grep file

需要把什么內(nèi)容添加到 Forge 的配置文件里呢？我們不妨直接運(yùn)行 forge upgrade 試試：

可以看到，F(xiàn)orge CLI 提示我們配置文件里面沒有管理員相關(guān)的配置，并且提示我們要把什么內(nèi)容添加進(jìn)去：

［forge.moderator］

address = “z1ScT4nkbA8b6cQBKQoyWTnnQnXAsmPsdhk”

publicKey = “MZWanHWP6NERFZ334w_8KvObAo6JGugew_gSz8XF1HA”

打開 Forge CLI 給出的配置文件路徑，把上面的配置追加到文件的末尾，保存后退出。

重新啟動(dòng)

因?yàn)槲覀兲砑庸芾韱T的操作修改了鏈的配置，為了是配置生效，需要重新啟動(dòng) Forge 鏈，依次執(zhí)行如下兩條命令：

forge stop

forge start

重新啟動(dòng)之后，包含了管理員的配置被加載到 Forge 的運(yùn)行配置中，接下來我們就可以以管理員的身份往鏈上發(fā)送升級的指令。

開始升級

萬事俱備，接下來再次運(yùn)行：forge upgrade，如下圖需要做出幾個(gè)升級的配置：

?要升級到的版本，選擇 v0.37.0

?在哪個(gè)塊高升級，可以根據(jù)當(dāng)前的塊高加上適當(dāng)?shù)脑隽?，比如?dāng)前塊高 33，我們就在 53 塊高出升級，如果出塊時(shí)間配置的是 3 秒，意味著 1 分鐘之后會(huì)發(fā)生升級

?確認(rèn)升級操作，因?yàn)檫@個(gè)操作是不可逆的，如果到這里后悔了，輸入 N 或者 Ctrl + C 即可中止

回車確認(rèn)之后，F(xiàn)orge CLI 會(huì)用管理員的身份往 Forge 鏈發(fā)送 1 個(gè) UpgradeNode 的交易，交易被成功打包之后，F(xiàn)orge 鏈會(huì)在預(yù)設(shè)的高度停下來，然后 Forge CLI 檢測到 Forge 鏈完全停止之后會(huì)再次把鏈啟動(dòng)起來，這樣就完成了整個(gè)升級的過程。

驗(yàn)證升級

如何驗(yàn)證升級是成功的呢？再次執(zhí)行 forge status，

檢查當(dāng)前鏈狀態(tài)里面的版本號，已經(jīng)變成了升級后的版本。