你讀到這篇文章時,已經發布的最新的 Forge 版本是:
瞭解 Forge 本地版本
如果你想知道本地 Forge 鏈的版本,直接執行:forge status,得到如下執行結果:
其中紅色圈圈中的版本就是當前鏈所使用的版本,我本地鏈的版本是 v0.36.5。
當然,你也可以執行:forge ls,得到如下執行結果:
其中紅框圈出的版本也是當前鏈使用的版本,forge ls 會列出本地已經下載過的所有可使用的 Forge 版本,並把當前使用的版本高亮出來。
升級的前提是我們本地使用的版本比遠端的最新版本低,如果兩個版本相同的話,你可以到此打住啦,哈哈!
下載 Forge 最新版
如果要把本地 Forge 鏈從 v0.36.5 升級到 v0.37.0,需要先下載 Forge v0.37.0 的全部元件,執行如下命令:
forge download latest
# 中國使用者
forge download latest --mirror http://arcblock.oss-cn-beijing.aliyuncs.com
可能有人會問,forge download 和 forge install 有啥區別?兩者都會從我們的映象下載指定版本(或最新版)的 Forge,不同點在於 forge download 只會下載,而 forge install 下載完之後會把本地使用的 Forge 版本切換到剛下載的版本,硬升級的時候用的就是 forge install。
怎麼確定有沒有切換本地當前使用的 Forge 版本?再次執行 forge ls:
可以看到,被高亮的還是 v0.36.5。
配置鏈管理員
對於區塊鏈來說,所使用軟體的版本其實相當於安裝在電腦硬體上的作業系統,如果要升級作業系統的版本,我們要輸入管理員密碼、把作業系統停下來、重新啟動完成升級,如果你經歷過作業系統的升級,Forge 鏈的升級就很好理解。
首先,我們需要給鏈配置 1 個管理員(moderator,本意是協調員,因為區塊鏈本身需要在多節點,在多節點間達成共識需要協調員),而任何能夠修改鏈狀態的實體本質都是一個錢包,即公私鑰對,對於沒有配置過鏈管理員的同學,需要先用 forge wallet:create --defaults 來生成一個管理員錢包,並且儲存好錢包私鑰。
為了後續方便,我們先把鏈管理員私鑰配置到環境變數裡面,把下面這行加到你的 ~/.bashrc 或者 ~/.zshrc 裡面(記得把私鑰換成你生成的那個):
export FORGE_MODERATOR_SK="qDWzV5cv8wSa-I2CKiLHm3msM9GeYyjOo4yo3iNicT8xlZqcdY_o0REVnffjD_wq85sCjoka6B7D-BLPxcXUcA"
如何確保你正確把管理員私鑰匯出到了環境變數裡面?直接執行 echo $FORGE_MODERATOR_SK,如果有結果輸出並且和你生成的私鑰相同,說明配置正確。
接下來我們需要把鏈管理員資訊新增到 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
需要把什麼內容新增到 Forge 的配置檔案裡呢?我們不妨直接執行 forge upgrade 試試:
可以看到,Forge CLI 提示我們配置檔案裡面沒有管理員相關的配置,並且提示我們要把什麼內容新增進去:
[forge.moderator]
address = "z1ScT4nkbA8b6cQBKQoyWTnnQnXAsmPsdhk"
publicKey = "MZWanHWP6NERFZ334w_8KvObAo6JGugew_gSz8XF1HA"
開啟 Forge CLI 給出的配置檔案路徑,把上面的配置追加到檔案的末尾,儲存後退出。
重新啟動
因為我們新增管理員的操作修改了鏈的配置,為了是配置生效,需要重新啟動 Forge 鏈,依次執行如下兩條命令:
forge stop
forge start
重新啟動之後,包含了管理員的配置被載入到 Forge 的執行配置中,接下來我們就可以以管理員的身份往鏈上傳送升級的指令。
開始升級
萬事俱備,接下來再次執行:forge upgrade,如下圖需要做出幾個升級的配置:
•要升級到的版本,選擇 v0.37.0
•在哪個塊高升級,可以根據當前的塊高加上適當的增量,比如當前塊高 33,我們就在 53 塊高出升級,如果出塊時間配置的是 3 秒,意味著 1 分鐘之後會發生升級
•確認升級操作,因為這個操作是不可逆的,如果到這裡後悔了,輸入 N 或者 Ctrl + C 即可中止
回車確認之後,Forge CLI 會用管理員的身份往 Forge 鏈傳送 1 個 UpgradeNode 的交易,交易被成功打包之後,Forge 鏈會在預設的高度停下來,然後 Forge CLI 檢測到 Forge 鏈完全停止之後會再次把鏈啟動起來,這樣就完成了整個升級的過程。
驗證升級
如何驗證升級是成功的呢?再次執行 forge status,
檢查當前鏈狀態裡面的版本號,已經變成了升級後的版本。
如果遇到問題?
到這裡,Forge 鏈軟升級的準備、升級、驗證環節都走完了,你升級成功了麼?如果遇到問題,歡迎到 Forge CLI 的官方倉庫提 Issue。
References
[1] Forge CLI: https://github.com/ArcBlock/forge-cli