15bb953afd
Also, start removing mentions of `PeerAdd` operation, as things should happen with `--bootstrap` (Join). PeerAdd should not be part of the user workflow and might disappear or be hidden in the future. License: MIT Signed-off-by: Hector Sanjuan <hector@protocol.ai>
1.7 KiB
1.7 KiB
ipfs-cluster-ctl
IPFS cluster management tool
ipfs-cluster-ctl
is the client application to manage the cluster nodes and perform actions. ipfs-cluster-ctl
uses the HTTP API provided by the nodes and it is completely separate from the cluster service.
Usage
Usage information can be obtained by running:
$ ipfs-cluster-ctl --help
You can also obtain command-specific help with ipfs-cluster-ctl help [cmd]
. The (--host
) can be used to talk to any remote cluster peer (localhost
is used by default). In summary, it works as follows:
$ ipfs-cluster-ctl id # show cluster peer and ipfs daemon information
$ ipfs-cluster-ctl peers ls # list cluster peers
$ ipfs-cluster-ctl peers rm <peerid> # remove a cluster peer
$ ipfs-cluster-ctl pin add Qma4Lid2T1F68E3Xa3CpE6vVJDLwxXLD8RfiB9g1Tmqp58 # pins a CID in the cluster
$ ipfs-cluster-ctl pin rm Qma4Lid2T1F68E3Xa3CpE6vVJDLwxXLD8RfiB9g1Tmqp58 # unpins a CID from the clustre
$ ipfs-cluster-ctl pin ls [CID] # list tracked CIDs (shared state)
$ ipfs-cluster-ctl status [CID] # list current status of tracked CIDs (local state)
$ ipfs-cluster-ctl sync Qma4Lid2T1F68E3Xa3CpE6vVJDLwxXLD8RfiB9g1Tmqp58 # re-sync seen status against status reported by the IPFS daemon
$ ipfs-cluster-ctl recover Qma4Lid2T1F68E3Xa3CpE6vVJDLwxXLD8RfiB9g1Tmqp58 # attempt to re-pin/unpin CIDs in error state
Debugging
ipfs-cluster-ctl
takes a --debug
flag which allows to inspect request paths and raw response bodies.