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

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

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

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

?在生產(chǎn)環(huán)境，因為整個區(qū)塊鏈是分布式的網(wǎng)絡(luò)，升級的動作需要由鏈的運營者來決定，而升級的結(jié)果需要在整條鏈的所有節(jié)點間同步

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

準備工作

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

了解 Forge 最新版本

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

了解 Forge 本地版本

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

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

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

其中紅框圈出的版本也是當前鏈使用的版本，forge ls 會列出本地已經(jīng)下載過的所有可使用的 Forge 版本，并把當前使用的版本高亮出來。

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

下載 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

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

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

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

配置鏈管理員

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

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

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

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 以下的版本，并且按本文操作時沒有升級到最新版，你的配置文件在：~/.forge_release/forge_release.toml

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

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

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

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

［forge.moderator］

address = “z1ScT4nkbA8b6cQBKQoyWTnnQnXAsmPsdhk”

publicKey = “MZWanHWP6NERFZ334w_8KvObAo6JGugew_gSz8XF1HA”

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

重新啟動

因為我們添加管理員的操作修改了鏈的配置，為了是配置生效，需要重新啟動 Forge 鏈，依次執(zhí)行如下兩條命令：

forge stop

forge start

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

開始升級

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

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

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

?確認升級操作，因為這個操作是不可逆的，如果到這里后悔了，輸入 N 或者 Ctrl + C 即可中止

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

驗證升級

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

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