‼️ 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:
venus:
sophon-messager:
sophon-miner:
sophon-gateway:
sophon-co:

Damocles (formerly as Storage Power Service)

damocles:

Droplet (formerly as Storage Deal Service)

droplet:

0 replies

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

simlecode
Oct 23, 2024
Maintainer Author

nv24升级文档

更新背景

NV24 网络升级（升级时间：北京时间 2024-11-20 xxxx 升级高度：xxx）

注意事项

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
lotus兼容版
sophon-co
sophon-gateway
sophon-messager
sophon-miner
venus-wallet-pro
droplet
damocles-sector-manager
damocles-worker
私有算法force-ext-processors

升级顺序

1. sophon-auth

2. venus

3. lotus兼容版本

4. sophon-co

5. sophon-gateway

6. sophon-messager

7. sophon-miner

8. doplet

9. venus-wallet-pro

10. 私有算法force-ext-processors

11. damocles-manager

12. damocles-worker

sophon-auth

影响功能：

其他组件对获取 auth 的服务

依赖升级组件: 无

注意事项：

此次网络升级不升级

venus

影响功能：

支持 f3:

目前 Filecoin 区块最终确认需要 900 个高度，f3 简单来说就是让区块更快最终确定不可回滚，理想情况是几个高度后区块就能最终确定，f3 需要 miner 连接节点投票，投票 miner 需要签名，因此需要节点要能访问 miner 地址并签名，但生产节点不保存私钥，就需要节点连接 sophon-gateway 进行签名。

venus 有两种方式连接 sophon-gateway：

启动时加 --wallet-gateway=<token:url> 连接 sophon-gateway
调整配置文件 config.json

 "walletModule": {

                "gatewayBacked": "<token:url>"

        },

迁移 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:

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

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

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

# 顺序可能会不一样

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

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

8. actor 迁移

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

预迁移高度是升级高度前 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

5. actor 迁移

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

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

影响功能：

支持 f3

f3 需要 miner 通过节点投票，但生产的 miner 连接 sophon-co，就导致请求发给不同的节点，进而可能导致投票失败，所以新增加 f3 节点配置，格式如下：

[F3Node]

  Addr = "/ip4/127.0.0.1/tcp/3453"

  Token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiYWRtaW4iLCJwZXJtIjoiYWRtaW4iLCJleHQiOiIifQ.pyGfVy8cmwWTPhSvVYGJhU3tB5BpYB\_abfF88ABhArE"

F3Node 配置的是 venus token和URL，此 venus 需要已连接 sophon-gateway

依赖升级组件：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}}

{{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