‼️ Network Version 24 Venus Upgrade Timeline #6394

simlecode · 2024-08-30T06:45:45Z

simlecode
Aug 30, 2024
Maintainer

More details on nv24 upgrade can be found here!

Subscribe to notifications on https://status.filecoin.io/ for any additional network updates!
If you have any concerns or questions, ask in #fil-venus.

📌 Venus Releases

Note: This projected timeline is subject to change based on testing, auditing, new discoveries, and development.

You will need to be on new versions of Venus products specified below for the Network v24 upgrade. Version requirement for each Venus products will be listed below in respective comments for both calibration and mainnet. Please make sure you use the right version for each Venus products 1. Sophon (formerly as chain service), 2. Damocles (formerly as storage power service), 3. Droplet (formerly as storage deal service).

🗓️ Tentative Releases and Network Upgrade Timelines

Calibration compatible RC releases for each Venus products
2024-10-23 Calibration-testnet upgrade
Mainnet compatible releases for each Venus products
2024-11-20 mainnet upgrade

simlecode · 2024-08-30T06:51:09Z

simlecode
Aug 30, 2024
Maintainer Author

Calibration compatible RC releases

Please use the following Veuns product version for pre-NV24 upgrade testing on Calibration network.

Sophon (formerly as Chain Service)

sophon-auth: v1.16.0
venus: v1.17.0-rc2
sophon-messager: v1.17.0-rc1
sophon-miner: v1.17.0-rc1
sophon-gateway: v1.17.0-rc1
sophon-co: v0.10.0-rc1

Damocles (formerly as Storage Power Service)

damocles: v0.12.0-rc1

Droplet (formerly as Storage Deal Service)

droplet: v2.13.0-rc1

0 replies

simlecode · 2024-08-30T06:51:58Z

simlecode
Aug 30, 2024
Maintainer Author

Mainnet compatible releases

Please use the following Veuns product version for NV24 upgrade on mainnet.

Sophon (formerly as Chain Service)

sophon-auth: v1.16.0
venus: v1.17.0
sophon-messager: v1.17.0
sophon-miner: v1.17.0
sophon-gateway: v1.17.0
sophon-co: v0.10.0

Damocles (formerly as Storage Power Service)

damocles: v0.12.0

Droplet (formerly as Storage Deal Service)

droplet: v2.13.0

0 replies

simlecode · 2024-10-23T02:15:59Z

simlecode
Oct 23, 2024
Maintainer Author

nv24升级文档

更新背景

NV24 网络升级（升级时间：北京时间 2024-11-21 07:00:00 升级高度：4461240）

注意事项

1. 所有组件全部更换

2. 升级前一周内，做一次节点链服务瘦身

3. 更新完通过 curl 命令调用 Version 接口检查版本号，各组件接口调用方式：#5132

4. pre/pro消息上链的情况

5. WD消息上链的情况

6. 出块情况是否正常

7. gas fee 相关设置是否生效

8. 升级前不封新的sector

需要升级的组件（sophon-auth 此次不需要升级）

组件名	tag	commit
sophon-auth	v1.16.0	e2340d5
venus	v1.17.0	`99dfd93`
lotus兼容版	venus-v1.30.0	c39e099
sophon-co	v0.10.0	7a148f4
sophon-gateway	v1.17.0	d7c4a56
sophon-messager	v1.17.0	f4a556a
sophon-miner	v1.17.0	cae8ecc
droplet	v2.13.0	b266256
damocles-sector-manager	v0.12.0	af90771
damocles-worker	v0.12.0	af90771

升级顺序

1. sophon-auth

2. venus

3. lotus兼容版本

4. sophon-co

5. sophon-gateway

6. sophon-messager

7. sophon-miner

8. doplet

9. damocles-manager

10. damocles-worker

sophon-auth

影响功能：

其他组件对获取 auth 的服务

依赖升级组件: 无

注意事项：

此次网络升级不升级

venus

影响功能：

迁移 event index：
开启 fevm 的节点需要迁移，此次迁移需要从 version 2 升级到 version 7，耗时 30 多分钟，升级过程会有下面日志输出

2024-10-17T09:09:23.657+0800    INFO    sqlite  sqlite/sqlite.go:132    Migrating event index database to version 3...
2024-10-17T09:09:23.665+0800    INFO    sqlite  sqlite/sqlite.go:150    Successfully migrated event index database from version 2 to 3 in 8.464418ms
2024-10-17T09:09:23.665+0800    INFO    sqlite  sqlite/sqlite.go:132    Migrating event index database to version 4...
2024-10-17T09:09:23.677+0800    INFO    sqlite  sqlite/sqlite.go:150    Successfully migrated event index database from version 3 to 4 in 11.817688ms
2024-10-17T09:09:23.677+0800    INFO    sqlite  sqlite/sqlite.go:132    Migrating event index database to version 5...
2024-10-17T09:09:23.682+0800    INFO    sqlite  sqlite/sqlite.go:150    Successfully migrated event index database from version 4 to 5 in 4.799806ms
2024-10-17T09:09:23.682+0800    INFO    sqlite  sqlite/sqlite.go:132    Migrating event index database to version 6...
2024-10-17T09:09:23.684+0800    INFO    sqlite  sqlite/sqlite.go:150    Successfully migrated event index database from version 5 to 6 in 1.661656ms
2024-10-17T09:09:23.684+0800    INFO    sqlite  sqlite/sqlite.go:132    Migrating event index database to version 7...
2024-10-17T09:09:23.684+0800    INFO    sqlite  sqlite/sqlite.go:150    Successfully migrated event index database from version 6 to 7 in 199.503µs
2024-10-17T09:09:23.684+0800    INFO    sqlite  sqlite/sqlite.go:157    Performing event index database vacuum and wal checkpointing to free up space after the migration

依赖升级组件: auth

注意事项：

编译：先 make dist-clean 再 make，这样可以防止未能正常升级 filecoin-ffi 而带来的问题

1. 升级后检查vk文件是否完整

2. 升级后执行命令 ./venus state network-info，然后检查通过日志检查 UpgradeTuktukHeight 是否正常 :

# cali

UpgradeWaffleHeight: 2078794

# 主网

UpgradeWaffleHeight: 4461240

4. 升级后需检查是否正常同步区块

5. 检查主网 v15 actors code，确保与下面输出一样

./venus state actor-cids --network-version 24

# 顺序可能会不一样

Network Version: 24
Actor Version: 15
Manifest CID: bafy2bzaceakwje2hyinucrhgtsfo44p54iw4g6otbv5ghov65vajhxgntr53u
Actor             CID                                                             
account           bafk2bzacecia5zacqt4gvd4z7275lnkhgraq75shy63cphakphhw6crf4joii  
cron              bafk2bzacecbyx7utt3tkvhqnfk64kgtlt5jlvv56o2liwczikgzfowk2cvqvk  
datacap           bafk2bzacecrypcpyzidphfl3sf3vhrjbiwzu7w3hoole45wsk2bqpverw4tni  
eam               bafk2bzacebybq7keb45l6isqfaiwxy5oi5wlpknhggjheut7q6xwp7mbxxku4  
ethaccount        bafk2bzaceajdy72edg3t2zcb6qwv2wgdsysfwdtczcklxcp4hlwh7pkxekja4  
evm               bafk2bzaceandffodu45eyro7jr7bizxw7ibipaiskt36xbp4vpvsxtrpkyjfm  
init              bafk2bzaceb5mjmy56ediswt2hvwqdfs2xzi4qw3cefkufoat57yyt3iwkg7kw  
multisig          bafk2bzaced3csl3buj7chpunsubrhwhchtskx674fpukfen4u6pbpkcheueya  
paymentchannel    bafk2bzacea3dpsfxw7cnj6zljmjnnaubp43a5kvuausigztmukektesg2flei  
placeholder       bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro  
reward            bafk2bzaceapkgue3gcxmwx7bvypn33okppa2nwpelcfp7oyo5yln3brixpjpm  
storagemarket     bafk2bzaceaqrnikbxymygwhwa2rsvhnqj5kfch75pn5xawnx243brqlfglsl6  
storageminer      bafk2bzacecnl2hqe3nozwo7al7kdznqgdrv2hbbbmpcbcwzh3yl4trog433hc  
storagepower      bafk2bzacecb3tvvppxmktll3xehjc7mqbfilt6bd4gragbdwxn77hm5frkuac  
system            bafk2bzacecvcqje6kcfqeayj66hezlwzfznytwqkxgw7p64xac5f5lcwjpbwe  
verifiedregistry  bafk2bzacecudaqwbz6dukmdbfok7xuxcpjqighnizhxun4spdqvnqgftkupp2

6. 若不排查问题，rust日志级别不建议设置为 trace，因为会打印较多日志

7. 升级后可以通过命令来 ./venus state get-actor t01000 来确认是否升级成功

8. actor 迁移

经测试本次预迁移时间在 1 分钟左右，正式迁移时间 30 秒左右

预迁移高度是升级高度前 120 个高度：

pre-migration  开始：STARTING pre-migration  结束：COMPLETED pre-migration

migration      开始：STARTING migration      结束：COMPLETED migration

9. 如果 ~/.venus 存在且需要导入快照，需要先删除 ~/.venus/version 文件再导入快照，参考以下导入命令

主网: ./venus daemon --import-snapshot snapshot.car
calibnet: ./venus daemon --import-snapshot snapshot.car --network calibrationnet

lotus兼容版本

影响功能：无

依赖升级组件: sophon-auth

注意事项:

编译：先 make dist-clean 再 make，这样可以防止未能正常升级 filecoin-ffi 而带来的问题

1. 检查是否正常同步

2. 检查和 sophon-auth 的连接是否完好（curl 命令验证）

4. 检查主网 v15 actors code，确保与下面输出一样

./lotus state actor-cids --network-version 24

Actor Version: 15
Manifest CID: bafy2bzaceakwje2hyinucrhgtsfo44p54iw4g6otbv5ghov65vajhxgntr53u

Actor             CID  
account           bafk2bzacecia5zacqt4gvd4z7275lnkhgraq75shy63cphakphhw6crf4joii
cron              bafk2bzacecbyx7utt3tkvhqnfk64kgtlt5jlvv56o2liwczikgzfowk2cvqvk
datacap           bafk2bzacecrypcpyzidphfl3sf3vhrjbiwzu7w3hoole45wsk2bqpverw4tni
eam               bafk2bzacebybq7keb45l6isqfaiwxy5oi5wlpknhggjheut7q6xwp7mbxxku4
ethaccount        bafk2bzaceajdy72edg3t2zcb6qwv2wgdsysfwdtczcklxcp4hlwh7pkxekja4
evm               bafk2bzaceandffodu45eyro7jr7bizxw7ibipaiskt36xbp4vpvsxtrpkyjfm
init              bafk2bzaceb5mjmy56ediswt2hvwqdfs2xzi4qw3cefkufoat57yyt3iwkg7kw
multisig          bafk2bzaced3csl3buj7chpunsubrhwhchtskx674fpukfen4u6pbpkcheueya
paymentchannel    bafk2bzacea3dpsfxw7cnj6zljmjnnaubp43a5kvuausigztmukektesg2flei
placeholder       bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
reward            bafk2bzaceapkgue3gcxmwx7bvypn33okppa2nwpelcfp7oyo5yln3brixpjpm
storagemarket     bafk2bzaceaqrnikbxymygwhwa2rsvhnqj5kfch75pn5xawnx243brqlfglsl6
storageminer      bafk2bzacecnl2hqe3nozwo7al7kdznqgdrv2hbbbmpcbcwzh3yl4trog433hc
storagepower      bafk2bzacecb3tvvppxmktll3xehjc7mqbfilt6bd4gragbdwxn77hm5frkuac
system            bafk2bzacecvcqje6kcfqeayj66hezlwzfznytwqkxgw7p64xac5f5lcwjpbwe
verifiedregistry  bafk2bzacecudaqwbz6dukmdbfok7xuxcpjqighnizhxun4spdqvnqgftkupp2

5. actor 迁移

预迁移高度是升级高度前 120 个高度：4461240 - 120 = 4461120

pre-migration  开始：STARTING pre-migration  结束：COMPLETED pre-migration

 migration      开始：STARTING migration      结束：COMPLETED migration

6. 升级后可以通过命令来 ./lotus state get-actor t01000 来确认是否升级成功

sophon-co

影响功能：无

依赖升级组件：auth、venus、兼容版lotus

注意事项：

启动之后应检查能否正常选择节点 (选中具体节点的日志为debug级别)

sophon-gateway

影响功能：

依赖升级组件: auth、wallet

注意事项：

编译时,需要先 make dist-clean 再 make
升级后检查钱包和miner有没有注册上来

sophon-messager

影响功能：

依赖升级组件: auth、venus、gateway

注意事项：

升级之后需要观察能否正常接收消息, 消息能否正常上链

sophon-miner

影响功能：

依赖升级组件：auth, venus, gateway

注意事项：

升级后检查 miner 数量和升级前是否一致
能否正常出块，观察孤块数量

droplet

影响功能：

依赖升级组件: auth、venus、gateway、messager

注意事项：

升级后能否正常发单

venus-wallet-pro

影响功能：无

依赖升级组件:

注意事项：

升级后观察是否正常签名，消息能否正常上链

damocles-sector-manger

影响功能：

依赖升级组件: 链服务组件

注意事项：

编译时,需要先 make dist-clean 再 make

damocles-worker

影响功能：

依赖升级组件: damocles-manager

注意事项：

更新结果验证步骤:

1. 程序启动正常

2. pre/pro消息正常上链

3. 出块正常

4. WD上链正常

5. cc集群算力增长正常

7. 真实数据集群算力增长正常

8. 真实算力集群检索正常

9. 数据库各种gas，生命周期，聚合设置正常

数据库变更

无

回滚步骤

1. 所有组件全部回退，禁止部分回退，导致混用的情况

升级方式

1. 本次升级采用隔离更新的方式

2. 本次升级禁止使用混用的方式，混用的情况下组合方式太多，会导致风险不可控

补充说明

版本检查接口，各组件实现了 Version 接口

### venus
$ curl http://127.0.0.1:3453/rpc/v0 -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"method": "Filecoin.Version","params":[], "id": 0}'

\# res
？

### sophon-auth
$ curl http://127.0.0.1:8989/version

\# res
？

### sophon-messager
 curl http://127.0.0.1:39812/rpc/v0 -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"method": "Message.Version","params":[], "id": 0}'

\# res
？

### sophon-gateway
$ curl http://127.0.0.1:45132/rpc/v0 -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"method": "Gateway.Version","params":[], "id": 0}'

\# res
？

### doplet
curl http://127.0.0.1:41235/rpc/v0 -X POST -H "Content-Type: application/json" -H "Authorization: Bearer " -d '{"method": "VENUS_MARKET.Version","params":[], "id": 0}'

\# res
？


### market-client
curl http://127.0.0.1:41235/rpc/v0 -X POST -H "Content-Type: application/json" -H "Authorization: Bearer " -d '{"method": "VENUS_MARKET_CLIENT.Version","params":[], "id": 0}'

\# res
？

### sophon-miner
curl http://127.0.0.1:12308/rpc/v0 -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"method": "Filecoin.Version","params":[], "id": 0}'

\# res
？

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

‼️ Network Version 24 Venus Upgrade Timeline #6394

{{title}}

{{editor}}'s edit

{{editor}}'s edit

Replies: 3 comments

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{editor}}'s edit

{{editor}}'s edit

Select a reply

‼️ Network Version 24 Venus Upgrade Timeline #6394

simlecode Aug 30, 2024 Maintainer

📌 Venus Releases

🗓️ Tentative Releases and Network Upgrade Timelines

Replies: 3 comments

simlecode Aug 30, 2024 Maintainer Author

Calibration compatible RC releases

Sophon (formerly as Chain Service)

Damocles (formerly as Storage Power Service)

Droplet (formerly as Storage Deal Service)

simlecode Aug 30, 2024 Maintainer Author

Mainnet compatible releases

Sophon (formerly as Chain Service)

Damocles (formerly as Storage Power Service)

Droplet (formerly as Storage Deal Service)

simlecode Oct 23, 2024 Maintainer Author

nv24升级文档

更新背景

注意事项

需要升级的组件（sophon-auth 此次不需要升级）

升级顺序

sophon-auth

venus

lotus兼容版本

sophon-co

sophon-gateway

sophon-messager

sophon-miner

droplet

venus-wallet-pro

damocles-sector-manger

damocles-worker

更新结果验证步骤:

数据库变更

回滚步骤

升级方式

补充说明

simlecode
Aug 30, 2024
Maintainer

simlecode
Aug 30, 2024
Maintainer Author

simlecode
Aug 30, 2024
Maintainer Author

simlecode
Oct 23, 2024
Maintainer Author