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

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

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

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

?在生產(chǎn)環(huán)境，因?yàn)檎麄€(gè)區(qū)塊鏈是分布式的網(wǎng)絡(luò)，升級(jí)的動(dòng)作需要由鏈的運(yùn)營(yíng)者來(lái)決定，而升級(jí)的結(jié)果需要在整條鏈的所有節(jié)點(diǎn)間同步

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

準(zhǔn)備工作

Forge CLI 是 ArcBlock 官方開發(fā)和維護(hù)的管理本地 Forge 鏈、節(jié)點(diǎn)的命令行工具，建議定期升級(jí) 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)下載過(guò)的所有可使用的 Forge 版本，并把當(dāng)前使用的版本高亮出來(lái)。

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

下載 Forge 最新版

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

forge download latest

# 中國(guó)用戶

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

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

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

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

配置鏈管理員

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

首先，我們需要給鏈配置 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è)錢包，即公私鑰對(duì)，對(duì)于沒(méi)有配置過(guò)鏈管理員的同學(xué)，需要先用 forge wallet:create --defaults 來(lái)生成一個(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é)果輸出并且和你生成的私鑰相同，說(shuō)明配置正確。

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

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

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

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

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

可以看到，F(xiàn)orge CLI 提示我們配置文件里面沒(méi)有管理員相關(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)行配置中，接下來(lái)我們就可以以管理員的身份往鏈上發(fā)送升級(jí)的指令。

開始升級(jí)

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

?要升級(jí)到的版本，選擇 v0.37.0

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

?確認(rèn)升級(jí)操作，因?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è)的高度停下來(lái)，然后 Forge CLI 檢測(cè)到 Forge 鏈完全停止之后會(huì)再次把鏈啟動(dòng)起來(lái)，這樣就完成了整個(gè)升級(jí)的過(guò)程。

驗(yàn)證升級(jí)

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

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