From e5fe1440307e1633d3279f696ad1e39b1eb0a0f7 Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Wed, 2 Oct 2024 15:20:16 +0200 Subject: [PATCH 1/2] chore: update diagnostic-tools.md --- docs/reference/diagnostic-tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/diagnostic-tools.md b/docs/reference/diagnostic-tools.md index a849b745f..ca2746336 100644 --- a/docs/reference/diagnostic-tools.md +++ b/docs/reference/diagnostic-tools.md @@ -18,7 +18,7 @@ Here are several tools you can use to investigate and diagnose common issues wit ## IPFS check -[IPFS Check](https://check.ipfs.network/) helps determine the retrievability of a CID from IPFS Mainnet, either from a specific peer given a multiaddress, or from multiple providers. +[IPFS Check](https://check.ipfs.network/) helps determine the retrievability of a CID from IPFS [Mainnet](../concepts/glossary.md#mainnet), either from a specific peer given a multiaddress, or from multiple providers. @[youtube](XeNOQDOrdC0) @@ -26,7 +26,7 @@ Each error type output by the tool can indicate a solution to your problem: - **Could not connect to the multiaddr** indicates that machines on the internet cannot talk to your machine. Fix your firewall, add port forwarding, or use a relay. - **Could not find address in the DHT** indicates that your machine is either not connected to the Amino DHT (even as a client), or it is not advertising the address that you are using to test. -- **Multihash not advertised in the DHT** indicates that your machine has not advertised that it has the requested content in the Amino DHT. If you're using Kubo, enable the [Accelerated DHT Client](https://github.com/ipfs/go-ipfs/blob/master/docs/experimental-features.md#accelerated-dht-client). +- **Multihash not advertised in the DHT** indicates that your machine has not advertised that it has the requested content in the Amino DHT. - **Peer has not responded that it has the CID** indicates that your node cannot find the block that you believe it has, or that there may be some other sort of network latency. ## CID inspector From 0219a1e6f9ae313af8824cce2abc4a6b6fec70e1 Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Wed, 2 Oct 2024 15:32:49 +0200 Subject: [PATCH 2/2] chore: more glossary links --- docs/reference/diagnostic-tools.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/docs/reference/diagnostic-tools.md b/docs/reference/diagnostic-tools.md index ca2746336..5c5790649 100644 --- a/docs/reference/diagnostic-tools.md +++ b/docs/reference/diagnostic-tools.md @@ -9,23 +9,18 @@ Here are several tools you can use to investigate and diagnose common issues wit ## IPLD Explorer -[IPLD Explorer](https://explore.ipld.io/) allows you to visualize and explore the IPLD DAG representing a given CID or CAR file. The tool provides the following featured datasets to explore: - -- [Project Apollo archives](https://explore.ipld.io/#/explore/QmSnuWmxptJZdLJpKRarxBMS2Ju2oANVrgbr2xWbie9b2D) -- [IGIS Git repository](https://explore.ipld.io/#/explore/baf4bcfg4ep767tjp5lxyanx5urpjjgx5q2volvy) -- [An Ethereum block](https://explore.ipld.io/#/explore/bagiacgzah24drzou2jlkixpblbgbg6nxfrasoklzttzoht5hixhxz3rlncyq) -- [XKCD archives](https://explore.ipld.io/#/explore/QmdmQXB2mzChmMeKY47C43LxUdg1NDJ5MWcKMKxDu7RgQm) +[IPLD Explorer](https://explore.ipld.io/) allows you to visualize and explore the [IPLD](../concepts/glossary.md#ipld) [DAG](../concepts/glossary.md#dag) representing a given [CID](../concepts/glossary.md#cid) or [CAR](../concepts/glossary.md#car) file. ## IPFS check -[IPFS Check](https://check.ipfs.network/) helps determine the retrievability of a CID from IPFS [Mainnet](../concepts/glossary.md#mainnet), either from a specific peer given a multiaddress, or from multiple providers. +[IPFS Check](https://check.ipfs.network/) helps determine the retrievability of a CID from IPFS [Mainnet](../concepts/glossary.md#mainnet), either from a specific [peer](../concepts/glossary.md#peer) given a [multiaddress](../concepts/glossary.md#multiaddr), or from multiple providers. @[youtube](XeNOQDOrdC0) Each error type output by the tool can indicate a solution to your problem: - **Could not connect to the multiaddr** indicates that machines on the internet cannot talk to your machine. Fix your firewall, add port forwarding, or use a relay. -- **Could not find address in the DHT** indicates that your machine is either not connected to the Amino DHT (even as a client), or it is not advertising the address that you are using to test. +- **Could not find address in the DHT** indicates that your machine is either not connected to the [Amino](../concepts/glossary.md#amino) DHT (even as a client), or it is not advertising the address that you are using to test. - **Multihash not advertised in the DHT** indicates that your machine has not advertised that it has the requested content in the Amino DHT. - **Peer has not responded that it has the CID** indicates that your node cannot find the block that you believe it has, or that there may be some other sort of network latency.