From d23ea7665b0e01be271238d4bbc9e90193874c1f Mon Sep 17 00:00:00 2001 From: Jiaying Wang <42981373+jennijuju@users.noreply.github.com> Date: Tue, 23 Apr 2024 23:04:32 -0400 Subject: [PATCH] release: v1.26.3 (#11908) (#11915) (#11922) * deps: update dependencies to address migration memory bloat to address memory concerns during a heavy migration Ref: https://github.com/filecoin-project/go-state-types/pull/260 Ref: https://github.com/whyrusleeping/cbor-gen/pull/96 Ref: https://github.com/filecoin-project/go-amt-ipld/pull/90 * release: prep v1.26.3 patch Prep v1.26.3 patch release: - Update changelog, version and make gen + make docsgen-cli * deps: update cbor-gen to tagged version deps: update cbor-gen to tagged version * deps: update go-state-types to tagged version deps: update go-state-types to tagged version v0.13.2 * chore: deps: update go-state-types to v0.13.3 Fixes a panic when we have fewer than 1k proposals. --------- Co-authored-by: Phi-rjan Co-authored-by: Rod Vagg Co-authored-by: Steven Allen --- CHANGELOG.md | 6 + build/openrpc/full.json.gz | Bin 35935 -> 35935 bytes build/openrpc/gateway.json.gz | Bin 12258 -> 12258 bytes build/openrpc/miner.json.gz | Bin 16475 -> 16475 bytes build/openrpc/worker.json.gz | Bin 6049 -> 6048 bytes documentation/en/cli-lotus-provider.md | 410 +++++++++++++++++++++++++ go.mod | 6 +- go.sum | 12 +- 8 files changed, 425 insertions(+), 9 deletions(-) create mode 100644 documentation/en/cli-lotus-provider.md diff --git a/CHANGELOG.md b/CHANGELOG.md index e7dba87a5..1c14c5344 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,12 @@ ## Improvements +# v1.26.3 / 2024-04-22 + +**This is a patch release that addresses high memory load concerns for the Lotus daemon in the coming network migration for network version 22, scheduled on epoch `3855360 - 2024-04-24 - 14:00:00Z`.** + +If your Lotus daemon is running on a machine with less memory and swap than 160GB, you should upgrade to this patch release to ensure you do not encounter any Out-Of-Memory issues during the pre-migration. + # v1.26.2 / 2024-04-08 **This is a mandatory patch release for the Filecoin network version 22 mainnet upgrade, for all node operators.** diff --git a/build/openrpc/full.json.gz b/build/openrpc/full.json.gz index baaf830238c024f8118746efa5064f6a537e08a8..08dda7784c666f634566edc12e0a9ce7f8908c37 100644 GIT binary patch delta 23 fcmcaVgX#VZrU@O4i#K+j>*i=sR+W1w%gz7*frbe+ delta 23 fcmcaVgX#VZrU@O4hc|Yf>*gr`|1##GEIR`Lj?fD# diff --git a/build/openrpc/gateway.json.gz b/build/openrpc/gateway.json.gz index 9c2dfbcf2a23bf48df7a05d645fc7c8b0187be02..9f5dc38ee6814d310fb0e17310fa4f2428409c80 100644 GIT binary patch delta 22 ecmaD9|0sS!GgEfL#@0}Mj&IX;bj8kLVgLYrkO}Sp delta 22 ecmaD9|0sS!Gt=t)jjf^j9FCT&?#IqyVgLYpLL diff --git a/build/openrpc/miner.json.gz b/build/openrpc/miner.json.gz index ba135c01577aa0bd16db70857c2b4c172bf43fc0..5fbd42c3db8b33d8058ebe13972b3c96cd51f997 100644 GIT binary patch delta 23 ecmccJz<9fXaY75D^2XM4_8fj;)wb{5nHd0el?c%Q delta 23 fcmccJz<9fXaY75D^TyV5_8cuo3g5hUXJ!BZe>Ms_ diff --git a/build/openrpc/worker.json.gz b/build/openrpc/worker.json.gz index 58231030637b043f21a2a1a365b6c916da936cc7..0f3cb11c7a3140dc8227754c0ab7a27965626b96 100644 GIT binary patch literal 6048 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 aQBSD`W4K)2F8@CO0RR7_KxV9MSOEZJF2+Ov literal 6049 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 E50#V7RsaA1 diff --git a/documentation/en/cli-lotus-provider.md b/documentation/en/cli-lotus-provider.md new file mode 100644 index 000000000..0fae817d2 --- /dev/null +++ b/documentation/en/cli-lotus-provider.md @@ -0,0 +1,410 @@ +# lotus-provider +``` +NAME: + lotus-provider - Filecoin decentralized storage network provider + +USAGE: + lotus-provider [global options] command [command options] [arguments...] + +VERSION: + 1.26.3 + +COMMANDS: + run Start a lotus provider process + stop Stop a running lotus provider + config Manage node config by layers. The layer 'base' will always be applied. + test Utility functions for testing + version Print version + help, h Shows a list of commands or help for one command + DEVELOPER: + auth Manage RPC permissions + log Manage logging + wait-api Wait for lotus api to come online + fetch-params Fetch proving parameters + +GLOBAL OPTIONS: + --color use color in display output (default: depends on output being a TTY) + --db-host value Command separated list of hostnames for yugabyte cluster (default: "yugabyte") [$LOTUS_DB_HOST] + --db-name value (default: "yugabyte") [$LOTUS_DB_NAME, $LOTUS_HARMONYDB_HOSTS] + --db-user value (default: "yugabyte") [$LOTUS_DB_USER, $LOTUS_HARMONYDB_USERNAME] + --db-password value (default: "yugabyte") [$LOTUS_DB_PASSWORD, $LOTUS_HARMONYDB_PASSWORD] + --layers value (default: "base") [$LOTUS_LAYERS, $LOTUS_CONFIG_LAYERS] + --repo-path value (default: "~/.lotusprovider") [$LOTUS_REPO_PATH] + --vv enables very verbose mode, useful for debugging the CLI (default: false) + --help, -h show help + --version, -v print the version +``` + +## lotus-provider run +``` +NAME: + lotus-provider run - Start a lotus provider process + +USAGE: + lotus-provider run [command options] [arguments...] + +OPTIONS: + --listen value host address and port the worker api will listen on (default: "0.0.0.0:12300") [$LOTUS_WORKER_LISTEN] + --nosync don't check full-node sync status (default: false) + --manage-fdlimit manage open file limit (default: true) + --layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base (default: "base") + --storage-json value path to json file containing storage config (default: "~/.lotus-provider/storage.json") + --journal value path to journal files (default: "~/.lotus-provider/") + --help, -h show help +``` + +## lotus-provider stop +``` +NAME: + lotus-provider stop - Stop a running lotus provider + +USAGE: + lotus-provider stop [command options] [arguments...] + +OPTIONS: + --help, -h show help +``` + +## lotus-provider config +``` +NAME: + lotus-provider config - Manage node config by layers. The layer 'base' will always be applied. + +USAGE: + lotus-provider config command [command options] [arguments...] + +COMMANDS: + default, defaults Print default node config + set, add, update, create Set a config layer or the base by providing a filename or stdin. + get, cat, show Get a config layer by name. You may want to pipe the output to a file, or use 'less' + list, ls List config layers you can get. + interpret, view, stacked, stack Interpret stacked config layers by this version of lotus-provider, with system-generated comments. + remove, rm, del, delete Remove a named config layer. + from-miner Express a database config (for lotus-provider) from an existing miner. + help, h Shows a list of commands or help for one command + +OPTIONS: + --help, -h show help +``` + +### lotus-provider config default +``` +NAME: + lotus-provider config default - Print default node config + +USAGE: + lotus-provider config default [command options] [arguments...] + +OPTIONS: + --no-comment don't comment default values (default: false) + --help, -h show help +``` + +### lotus-provider config set +``` +NAME: + lotus-provider config set - Set a config layer or the base by providing a filename or stdin. + +USAGE: + lotus-provider config set [command options] a layer's file name + +OPTIONS: + --title value title of the config layer (req'd for stdin) + --help, -h show help +``` + +### lotus-provider config get +``` +NAME: + lotus-provider config get - Get a config layer by name. You may want to pipe the output to a file, or use 'less' + +USAGE: + lotus-provider config get [command options] layer name + +OPTIONS: + --help, -h show help +``` + +### lotus-provider config list +``` +NAME: + lotus-provider config list - List config layers you can get. + +USAGE: + lotus-provider config list [command options] [arguments...] + +OPTIONS: + --help, -h show help +``` + +### lotus-provider config interpret +``` +NAME: + lotus-provider config interpret - Interpret stacked config layers by this version of lotus-provider, with system-generated comments. + +USAGE: + lotus-provider config interpret [command options] a list of layers to be interpreted as the final config + +OPTIONS: + --layers value [ --layers value ] comma or space separated list of layers to be interpreted (default: "base") + --help, -h show help +``` + +### lotus-provider config remove +``` +NAME: + lotus-provider config remove - Remove a named config layer. + +USAGE: + lotus-provider config remove [command options] [arguments...] + +OPTIONS: + --help, -h show help +``` + +### lotus-provider config from-miner +``` +NAME: + lotus-provider config from-miner - Express a database config (for lotus-provider) from an existing miner. + +USAGE: + lotus-provider config from-miner [command options] [arguments...] + +DESCRIPTION: + Express a database config (for lotus-provider) from an existing miner. + +OPTIONS: + --miner-repo value, --storagerepo value Specify miner repo path. flag(storagerepo) and env(LOTUS_STORAGE_PATH) are DEPRECATION, will REMOVE SOON (default: "~/.lotusminer") [$LOTUS_MINER_PATH, $LOTUS_STORAGE_PATH] + --to-layer value, -t value The layer name for this data push. 'base' is recommended for single-miner setup. + --overwrite, -o Use this with --to-layer to replace an existing layer (default: false) + --help, -h show help +``` + +## lotus-provider test +``` +NAME: + lotus-provider test - Utility functions for testing + +USAGE: + lotus-provider test command [command options] [arguments...] + +COMMANDS: + window-post, wd, windowpost, wdpost Compute a proof-of-spacetime for a sector (requires the sector to be pre-sealed). These will not send to the chain. + help, h Shows a list of commands or help for one command + +OPTIONS: + --help, -h show help +``` + +### lotus-provider test window-post +``` +NAME: + lotus-provider test window-post - Compute a proof-of-spacetime for a sector (requires the sector to be pre-sealed). These will not send to the chain. + +USAGE: + lotus-provider test window-post command [command options] [arguments...] + +COMMANDS: + here, cli Compute WindowPoSt for performance and configuration testing. + task, scheduled, schedule, async, asynchronous Test the windowpost scheduler by running it on the next available lotus-provider. + help, h Shows a list of commands or help for one command + +OPTIONS: + --help, -h show help +``` + +#### lotus-provider test window-post here +``` +NAME: + lotus-provider test window-post here - Compute WindowPoSt for performance and configuration testing. + +USAGE: + lotus-provider test window-post here [command options] [deadline index] + +DESCRIPTION: + Note: This command is intended to be used to verify PoSt compute performance. + It will not send any messages to the chain. Since it can compute any deadline, output may be incorrectly timed for the chain. + +OPTIONS: + --deadline value deadline to compute WindowPoSt for (default: 0) + --layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base (default: "base") + --storage-json value path to json file containing storage config (default: "~/.lotus-provider/storage.json") + --partition value partition to compute WindowPoSt for (default: 0) + --help, -h show help +``` + +#### lotus-provider test window-post task +``` +NAME: + lotus-provider test window-post task - Test the windowpost scheduler by running it on the next available lotus-provider. + +USAGE: + lotus-provider test window-post task [command options] [arguments...] + +OPTIONS: + --deadline value deadline to compute WindowPoSt for (default: 0) + --layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base (default: "base") + --help, -h show help +``` + +## lotus-provider version +``` +NAME: + lotus-provider version - Print version + +USAGE: + lotus-provider version [command options] [arguments...] + +OPTIONS: + --help, -h show help +``` + +## lotus-provider auth +``` +NAME: + lotus-provider auth - Manage RPC permissions + +USAGE: + lotus-provider auth command [command options] [arguments...] + +COMMANDS: + create-token Create token + api-info Get token with API info required to connect to this node + help, h Shows a list of commands or help for one command + +OPTIONS: + --help, -h show help +``` + +### lotus-provider auth create-token +``` +NAME: + lotus-provider auth create-token - Create token + +USAGE: + lotus-provider auth create-token [command options] [arguments...] + +OPTIONS: + --perm value permission to assign to the token, one of: read, write, sign, admin + --help, -h show help +``` + +### lotus-provider auth api-info +``` +NAME: + lotus-provider auth api-info - Get token with API info required to connect to this node + +USAGE: + lotus-provider auth api-info [command options] [arguments...] + +OPTIONS: + --perm value permission to assign to the token, one of: read, write, sign, admin + --help, -h show help +``` + +## lotus-provider log +``` +NAME: + lotus-provider log - Manage logging + +USAGE: + lotus-provider log command [command options] [arguments...] + +COMMANDS: + list List log systems + set-level Set log level + alerts Get alert states + help, h Shows a list of commands or help for one command + +OPTIONS: + --help, -h show help +``` + +### lotus-provider log list +``` +NAME: + lotus-provider log list - List log systems + +USAGE: + lotus-provider log list [command options] [arguments...] + +OPTIONS: + --help, -h show help +``` + +### lotus-provider log set-level +``` +NAME: + lotus-provider log set-level - Set log level + +USAGE: + lotus-provider log set-level [command options] [level] + +DESCRIPTION: + Set the log level for logging systems: + + The system flag can be specified multiple times. + + eg) log set-level --system chain --system chainxchg debug + + Available Levels: + debug + info + warn + error + + Environment Variables: + GOLOG_LOG_LEVEL - Default log level for all log systems + GOLOG_LOG_FMT - Change output log format (json, nocolor) + GOLOG_FILE - Write logs to file + GOLOG_OUTPUT - Specify whether to output to file, stderr, stdout or a combination, i.e. file+stderr + + +OPTIONS: + --system value [ --system value ] limit to log system + --help, -h show help +``` + +### lotus-provider log alerts +``` +NAME: + lotus-provider log alerts - Get alert states + +USAGE: + lotus-provider log alerts [command options] [arguments...] + +OPTIONS: + --all get all (active and inactive) alerts (default: false) + --help, -h show help +``` + +## lotus-provider wait-api +``` +NAME: + lotus-provider wait-api - Wait for lotus api to come online + +USAGE: + lotus-provider wait-api [command options] [arguments...] + +CATEGORY: + DEVELOPER + +OPTIONS: + --timeout value duration to wait till fail (default: 30s) + --help, -h show help +``` + +## lotus-provider fetch-params +``` +NAME: + lotus-provider fetch-params - Fetch proving parameters + +USAGE: + lotus-provider fetch-params [command options] [sectorSize] + +CATEGORY: + DEVELOPER + +OPTIONS: + --help, -h show help +``` diff --git a/go.mod b/go.mod index 674148ec3..062aca298 100644 --- a/go.mod +++ b/go.mod @@ -35,7 +35,7 @@ require ( github.com/filecoin-project/dagstore v0.5.2 github.com/filecoin-project/filecoin-ffi v0.30.4-0.20220519234331-bfd1f5f9fe38 github.com/filecoin-project/go-address v1.1.0 - github.com/filecoin-project/go-amt-ipld/v4 v4.2.0 + github.com/filecoin-project/go-amt-ipld/v4 v4.3.0 github.com/filecoin-project/go-bitfield v0.2.4 github.com/filecoin-project/go-cbor-util v0.0.1 github.com/filecoin-project/go-commp-utils v0.1.3 @@ -49,7 +49,7 @@ require ( github.com/filecoin-project/go-jsonrpc v0.3.1 github.com/filecoin-project/go-padreader v0.0.1 github.com/filecoin-project/go-paramfetch v0.0.4 - github.com/filecoin-project/go-state-types v0.13.1 + github.com/filecoin-project/go-state-types v0.13.3 github.com/filecoin-project/go-statemachine v1.0.3 github.com/filecoin-project/go-statestore v0.2.0 github.com/filecoin-project/go-storedcounter v0.1.0 @@ -144,7 +144,7 @@ require ( github.com/triplewz/poseidon v0.0.0-20230828015038-79d8165c88ed github.com/urfave/cli/v2 v2.25.5 github.com/whyrusleeping/bencher v0.0.0-20190829221104-bb6607aa8bba - github.com/whyrusleeping/cbor-gen v0.1.0 + github.com/whyrusleeping/cbor-gen v0.1.1 github.com/whyrusleeping/multiaddr-filter v0.0.0-20160516205228-e903e4adabd7 github.com/xeipuuv/gojsonschema v1.2.0 github.com/xorcare/golden v0.6.1-0.20191112154924-b87f686d7542 diff --git a/go.sum b/go.sum index 4e6ce0dec..52755ba03 100644 --- a/go.sum +++ b/go.sum @@ -305,8 +305,8 @@ github.com/filecoin-project/go-amt-ipld/v3 v3.0.0/go.mod h1:Qa95YNAbtoVCTSVtX38a github.com/filecoin-project/go-amt-ipld/v3 v3.1.0 h1:ZNJ9tEG5bE72vBWYiuh5bkxJVM3ViHNOmQ7qew9n6RE= github.com/filecoin-project/go-amt-ipld/v3 v3.1.0/go.mod h1:UjM2QhDFrrjD5s1CdnkJkat4ga+LqZBZgTMniypABRo= github.com/filecoin-project/go-amt-ipld/v4 v4.0.0/go.mod h1:gF053YQ4BIpzTNDoEwHZas7U3oAwncDVGvOHyY8oDpE= -github.com/filecoin-project/go-amt-ipld/v4 v4.2.0 h1:DQTXQwMXxaetd+lhZGODjt5qC1WYT7tMAlYrWqI/fwI= -github.com/filecoin-project/go-amt-ipld/v4 v4.2.0/go.mod h1:0eDVF7pROvxrsxvLJx+SJZXqRaXXcEPUcgb/rG0zGU4= +github.com/filecoin-project/go-amt-ipld/v4 v4.3.0 h1:bY42N1gR0DqrLMCKUPzX1VhYVgXaETQm0Um4ohvyEP8= +github.com/filecoin-project/go-amt-ipld/v4 v4.3.0/go.mod h1:39Ep/yBbF6xN94WevLG9qSbglBJepHa5zeEbAE1pYsc= github.com/filecoin-project/go-bitfield v0.2.0/go.mod h1:CNl9WG8hgR5mttCnUErjcQjGvuiZjRqK9rHVBsQF4oM= github.com/filecoin-project/go-bitfield v0.2.3/go.mod h1:CNl9WG8hgR5mttCnUErjcQjGvuiZjRqK9rHVBsQF4oM= github.com/filecoin-project/go-bitfield v0.2.4 h1:uZ7MeE+XfM5lqrHJZ93OnhQKc/rveW8p9au0C68JPgk= @@ -355,8 +355,8 @@ github.com/filecoin-project/go-state-types v0.1.0/go.mod h1:ezYnPf0bNkTsDibL/psS github.com/filecoin-project/go-state-types v0.1.6/go.mod h1:UwGVoMsULoCK+bWjEdd/xLCvLAQFBC7EDT477SKml+Q= github.com/filecoin-project/go-state-types v0.1.10/go.mod h1:UwGVoMsULoCK+bWjEdd/xLCvLAQFBC7EDT477SKml+Q= github.com/filecoin-project/go-state-types v0.11.2-0.20230712101859-8f37624fa540/go.mod h1:SyNPwTsU7I22gL2r0OAPcImvLoTVfgRwdK/Y5rR1zz8= -github.com/filecoin-project/go-state-types v0.13.1 h1:4CivvlcHAIoAtFFVVlZtokynaMQu5XLXGoTKhQkfG1I= -github.com/filecoin-project/go-state-types v0.13.1/go.mod h1:cHpOPup9H1g2T29dKHAjC2sc7/Ef5ypjuW9A3I+e9yY= +github.com/filecoin-project/go-state-types v0.13.3 h1:9JPkC0E6HDtfHbaOIrFiCDzT/Z0jRTb9En4Y4Ci/b3w= +github.com/filecoin-project/go-state-types v0.13.3/go.mod h1:cHpOPup9H1g2T29dKHAjC2sc7/Ef5ypjuW9A3I+e9yY= github.com/filecoin-project/go-statemachine v0.0.0-20200925024713-05bd7c71fbfe/go.mod h1:FGwQgZAt2Gh5mjlwJUlVB62JeYdo+if0xWxSEfBD9ig= github.com/filecoin-project/go-statemachine v1.0.3 h1:N07o6alys+V1tNoSTi4WuuoeNC4erS/6jE74+NsgQuk= github.com/filecoin-project/go-statemachine v1.0.3/go.mod h1:jZdXXiHa61n4NmgWFG4w8tnqgvZVHYbJ3yW7+y8bF54= @@ -1681,8 +1681,8 @@ github.com/whyrusleeping/cbor-gen v0.0.0-20200826160007-0b9f6c5fb163/go.mod h1:f github.com/whyrusleeping/cbor-gen v0.0.0-20210118024343-169e9d70c0c2/go.mod h1:fgkXqYy7bV2cFeIEOkVTZS/WjXARfBqSH6Q2qHL33hQ= github.com/whyrusleeping/cbor-gen v0.0.0-20210303213153-67a261a1d291/go.mod h1:fgkXqYy7bV2cFeIEOkVTZS/WjXARfBqSH6Q2qHL33hQ= github.com/whyrusleeping/cbor-gen v0.0.0-20220323183124-98fa8256a799/go.mod h1:fgkXqYy7bV2cFeIEOkVTZS/WjXARfBqSH6Q2qHL33hQ= -github.com/whyrusleeping/cbor-gen v0.1.0 h1:Jneeq3V5enErVcuL0NKEbD1Gi+iOvEeFhXOV1S1Fc6g= -github.com/whyrusleeping/cbor-gen v0.1.0/go.mod h1:pM99HXyEbSQHcosHc0iW7YFmwnscr+t9Te4ibko05so= +github.com/whyrusleeping/cbor-gen v0.1.1 h1:eKfcJIoxivjMtwfCfmJAqSF56MHcWqyIScXwaC1VBgw= +github.com/whyrusleeping/cbor-gen v0.1.1/go.mod h1:pM99HXyEbSQHcosHc0iW7YFmwnscr+t9Te4ibko05so= github.com/whyrusleeping/chunker v0.0.0-20181014151217-fe64bd25879f h1:jQa4QT2UP9WYv2nzyawpKMOCl+Z/jW7djv2/J50lj9E= github.com/whyrusleeping/chunker v0.0.0-20181014151217-fe64bd25879f/go.mod h1:p9UJB6dDgdPgMJZs7UjUOdulKyRr9fqkS+6JKAInPy8= github.com/whyrusleeping/go-keyspace v0.0.0-20160322163242-5b898ac5add1 h1:EKhdznlJHPMoKr0XTrX+IlJs1LH3lyx2nfr1dOlZ79k=