diff --git a/docs/integrators/snapshotless-observing-squad.md b/docs/integrators/snapshotless-observing-squad.md index 8bf65754..c48a05f3 100644 --- a/docs/integrators/snapshotless-observing-squad.md +++ b/docs/integrators/snapshotless-observing-squad.md @@ -24,13 +24,24 @@ The nodes started with the flag `--operation-mode snapshotless-observer` will no ### Creating a Snapshotless Observing Squad from scratch -If you choose to install a snapshotless observing squad from scratch, you should follow the instruction from the [observing squad section](/integrators/observing-squad) and remember to add in the `variables.cfg` file the operation mode in the node's extra flags definition: +If you choose to install a snapshotless Observing Squad from scratch, you should follow the instruction from the [observing squad section](/integrators/observing-squad) and remember to add in the `variables.cfg` file the operation mode in the node's extra flags definition: ``` NODE_EXTRA_FLAGS="-log-save -operation-mode snapshotless-observer" ``` - After that, you can resume the normal Observing Squad installation steps. +Then, based on the needs there are multiple options concerning the proxy: +* if only a snapshotless squad is needed, nothing else should be done +* if both regular and snapshotless squads are needed: + * with two different proxies: one started with regular observers and one started with snapshotless observers, nothing else should be done + * with only one proxy (being served by all 8 observers), `IsSnapshotless = true` should be added to each observer started with this flag, in the proxy config (found at `$CUSTOM_HOME/elrond-proxy/config/config.toml`), as follows. Please note that this step is optional, although it would help the proxy to forward the requests in an efficient manner. +```toml +[[Observers]] + ShardId = 0 + Address = "http://127.0.0.1:8080" + IsSnapshotless = true +``` + [comment]: # (mx-context-auto) ### Converting a normal Observing Squad to a Snapshotless Observing Squad diff --git a/docs/sdk-and-tools/sdk-py/mxpy-cli.md b/docs/sdk-and-tools/sdk-py/mxpy-cli.md index 8c85e1db..0f227164 100644 --- a/docs/sdk-and-tools/sdk-py/mxpy-cli.md +++ b/docs/sdk-and-tools/sdk-py/mxpy-cli.md @@ -91,6 +91,14 @@ If no tag is provided **the default version** will be installed. Generally speaking, the default `rust` version installed by `mxpy` is the one referenced by [the latest Docker image](https://github.com/multiversx/mx-sdk-rust-contract-builder/blob/main/Dockerfile) used for reproducible builds. ::: +:::note +On Ubuntu (or Windows with WSL), you might need to install the following dependencies of Rust and `sc-meta` before running `mxpy deps install rust`: + +```bash +sudo apt-get install build-essential pkg-config libssl-dev +``` +::: + Here's how to install a specific version of `rust` (example): ```sh mxpy deps install rust --overwrite diff --git a/docs/sdk-and-tools/troubleshooting/rust-setup.md b/docs/sdk-and-tools/troubleshooting/rust-setup.md index 54394f1f..56062d41 100644 --- a/docs/sdk-and-tools/troubleshooting/rust-setup.md +++ b/docs/sdk-and-tools/troubleshooting/rust-setup.md @@ -70,6 +70,14 @@ rustup self uninstall ### With mxpy +On Ubuntu (or Windows with WSL), you might need to install the following dependencies of Rust and `sc-meta` first: + +```bash +sudo apt-get install build-essential pkg-config libssl-dev +``` + +Install Rust and `sc-meta` using `mxpy`: + ```bash mxpy deps install rust --overwrite ``` @@ -84,7 +92,13 @@ For more information, go to [managing dependencies using `mxpy`](/sdk-and-tools/ ### Without mxpy -As recommended on [rust-lang.org](https://www.rust-lang.org/tools/install): +On Ubuntu (or Windows with WSL), you might need to install the following dependencies of Rust and `sc-meta` first: + +```bash +sudo apt-get install build-essential pkg-config libssl-dev +``` + +Install Rust as recommended on [rust-lang.org](https://www.rust-lang.org/tools/install): ```bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh @@ -116,7 +130,13 @@ cargo install twiggy ### Without mxpy (CI / CD) -For CI / CD, use the following: +On Ubuntu (or Windows with WSL), you might need to install the following dependencies of Rust and `sc-meta` first: + +```bash +sudo apt-get install build-essential pkg-config libssl-dev +``` + +For CI / CD, install Rust as follows: ```bash wget -O rustup.sh https://sh.rustup.rs && \ @@ -128,22 +148,16 @@ cargo install multiversx-sc-meta --locked [comment]: # (mx-context-auto) -### Handle missing dependencies of sc-meta - -`sc-meta` requires a few dependencies that are not installed by default on some systems. In this case, installation of `sc-meta` fails. - -For a workaround, please follow this [GitHub issue](https://github.com/multiversx/mx-sdk-py-cli/issues/338). +### Handle missing dependencies -[comment]: # (mx-context-auto) - -### Handle missing dependencies: build-essential - -On Ubuntu, you might also need to install `build-essential`: +On Ubuntu (or Windows with WSL), you might need to install the following dependencies of Rust and `sc-meta` before installing Rust: ```bash -sudo apt-get install build-essential +sudo apt-get install build-essential pkg-config libssl-dev ``` +Also see this [GitHub issue](https://github.com/multiversx/mx-sdk-py-cli/issues/338). + [comment]: # (mx-context-auto) ## Check your Rust installation diff --git a/static/developers/tutorial/config-screenshot.png b/static/developers/tutorial/config-screenshot.png index bf2fe1a1..26009ab3 100644 Binary files a/static/developers/tutorial/config-screenshot.png and b/static/developers/tutorial/config-screenshot.png differ diff --git a/static/developers/tutorial/dapp-architecture.png b/static/developers/tutorial/dapp-architecture.png index b5ab8a9b..3ddf76b3 100644 Binary files a/static/developers/tutorial/dapp-architecture.png and b/static/developers/tutorial/dapp-architecture.png differ diff --git a/static/developers/tutorial/dapp-problem.png b/static/developers/tutorial/dapp-problem.png index a67e9399..93290f84 100644 Binary files a/static/developers/tutorial/dapp-problem.png and b/static/developers/tutorial/dapp-problem.png differ diff --git a/static/developers/tutorial/faucet-screenshot.png b/static/developers/tutorial/faucet-screenshot.png index 00248ac2..24fab5b3 100644 Binary files a/static/developers/tutorial/faucet-screenshot.png and b/static/developers/tutorial/faucet-screenshot.png differ diff --git a/static/developers/tutorial/folder-structure.png b/static/developers/tutorial/folder-structure.png index 476f7f03..7ef850ab 100644 Binary files a/static/developers/tutorial/folder-structure.png and b/static/developers/tutorial/folder-structure.png differ