Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(docs): update fullnode deployment testnet & devnet configurations #4021

Merged
merged 6 commits into from
Nov 14, 2024
Merged

feat(docs): update fullnode deployment testnet & devnet configurations #4021

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ef89242
Doc: update fullnode deployment alphanet and testnet configurations
FranCerdan Nov 12, 2024
0a7f612
Doc: update fullnode deployment devnet and testnet configurations
FranCerdan Nov 12, 2024
b630fc2
Doc: update fullnode deployment devnet and testnet configurations
FranCerdan Nov 12, 2024
7c208a8
Doc: update fullnode deployment devnet and testnet configurations
FranCerdan Nov 12, 2024
01b3cea
Doc: update fullnode deployment devnet and testnet configurations
FranCerdan Nov 13, 2024
212d78b
Merge branch 'develop' into devops/update_deployment_documentation
FranCerdan Nov 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docker/fullnode/docker-compose.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,10 @@ services:
volumes:
- ./fullnode-template.yaml:/opt/iota/config/fullnode.yaml:ro
- ./genesis.blob:/opt/iota/config/genesis.blob:ro
- ./migration.blob:/opt/iota/config/migration.blob:ro
- ./iotadb:/opt/iota/db:rw
command: [
"/opt/iota/bin/iota-node",
"/usr/local/bin/iota-node",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you please describe this change in the PR/issue why it's needed or why you do the adjustment?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done 👍

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just wondering, with the old path, wasn't it actually working?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, the old path was not working, it showed the following error:

Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: exec: "/opt/iota/bin/iota-node": stat /opt/iota/bin/iota-node: no such file or directory: unknown

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The origin "/opt/iota/bin/iota-node" works for me for my local built image. Which image do you use? Did you build the image via iota/docker/iota-node/build.sh by using ./build.sh -t iota-node --no-cache?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The image I'm using is the latest one build by the github CI/CD:
image: docker-registry.iota.org/iota-tools:v0.7.0-alpha

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh, I was using the iota-tools, this image does not contain the binary at the /opt/iota/bin/iota-node, with iota-node the deployment works properly thanks for the feedback! I will update now.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

update done

"--config-path",
"/opt/iota/config/fullnode.yaml",
]
Expand Down
47 changes: 29 additions & 18 deletions docs/content/operator/iota-full-node.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,13 +111,19 @@ Open a terminal or console to the `iota` directory you downloaded in the previou
1. Install the required prerequisites.
1. Make a copy of the [Full node YAML template](https://github.com/iotaledger/iota/blob/develop/crates/iota-config/data/fullnode-template.yaml):
`cp crates/iota-config/data/fullnode-template.yaml fullnode.yaml`
1. Download the genesis blob for the network to use:
1. Download the genesis and migration blob for the network to use:
- [Alphanet genesis blob](https://dbfiles.iota-rebased-alphanet.iota.cafe/genesis.blob):
`curl -fLJO https://dbfiles.iota-rebased-alphanet.iota.cafe/genesis.blob`
- [Testnet genesis blob](https://github.com/iotaledger/iota/TODO):
`curl -fLJO TODO`
- [Alphanet migration blob](https://dbfiles.iota-rebased-alphanet.iota.cafe/migration.blob):
`curl -fLJO https://dbfiles.iota-rebased-alphanet.iota.cafe/migration.blob`
- [Testnet genesis blob](https://dbfiles.testnet.iota.cafe/genesis.blob):
`curl -fLJO https://dbfiles.testnet.iota.cafe/genesis.blob`
- [Testnet migration blob](https://dbfiles.testnet.iota.cafe/migration.blob ):
`curl -fLJO https://dbfiles.testnet.iota.cafe/migration.blob `
- [Mainnet genesis blob](https://github.com/iotaledger/iota/TODO):
`curl -fLJO TODO`
- [Mainnet migration blob](https://github.com/iotaledger/iota/TODO):
`curl -fLJO TODO`
1. For Alphanet or Testnet: Edit the `fullnode.yaml` file to include peer nodes for state synchronization. Append the following to the end of the current configuration:

<Tabs groupId="network">
Expand All @@ -128,7 +134,7 @@ Open a terminal or console to the `iota` directory you downloaded in the previou
p2p-config:
seed-peers:
- address: /dns/access-0.r.iota-rebased-alphanet.iota.cafe/udp/8084
peer-id: 10cbea76ea5ec3f7ee827f0c11f612f0059949127876dd964b09304bf8808d18
peer-id: 8f80689ff7bb93bf9dc256f68af916fc5782b0061b0cda4b51c198b6b4e31611
```

</TabItem>
Expand All @@ -137,8 +143,10 @@ Open a terminal or console to the `iota` directory you downloaded in the previou
```yaml
p2p-config:
seed-peers:
- address: TODO # Example: /dns/yto-tnt-ssfn-01.testnet.iota.io/udp/8084
peer-id: TODO # Example: 2ed53564d5581ded9b6773970ac2f1c84d39f9edf01308ff5a1ffe09b1add7b3
- address: /dns/access-0.r.testnet.iota.cafe/udp/8084
peer-id: ee042a2f2903527981295d9d7eff881cf1f78d4dc7e60bc3ee138120bdb600da
- address: /dns/access-1.r.testnet.iota.cafe/udp/8084
peer-id: 17535fb7901ab2feafecd02306a0fcea0af7bfdee6057fa3b0d204726ba9ab12
```

</TabItem>
Expand All @@ -153,7 +161,10 @@ Open a terminal or console to the `iota` directory you downloaded in the previou
genesis:
genesis-file-location: "/iota-fullnode/genesis.blob"
```

1. Update the `migration-tx-data-path` with the path to the migration.blob
```yaml
migration-tx-data-path: "/opt/iota/config/migration.blob"
```
### Compiling the node

Run the following command to compile the `iota-node`.
Expand Down Expand Up @@ -217,9 +228,9 @@ If you followed the instructions for Building from Source, use the following ste
```shell
cd iota
```
1. Remove the database and 'genesis.blob' file:
1. Remove the database, 'genesis.blob' and 'migration.blob' file:
```shell
rm -r iotadb genesis.blob
rm -r iotadb genesis.blob migration.blob
```
1. Fetch the source from the latest release:
```shell
Expand All @@ -229,15 +240,15 @@ If you followed the instructions for Building from Source, use the following ste
```shell
git checkout -B <BRANCH-NAME> --track upstream/<BRANCH-NAME>
```
1. Download the latest genesis blob:
- [Devnet genesis blob](https://github.com/iotaledger/iota):
```shell
curl -fLJO TODO
```
- [Testnet genesis blob](https://github.com/iotaledger/iota):
```shell
curl -fLJO TODO
```
1. Download the latest genesis and migration blob:
- [Alphanet genesis blob](https://dbfiles.iota-rebased-alphanet.iota.cafe/genesis.blob):
`curl -fLJO https://dbfiles.iota-rebased-alphanet.iota.cafe/genesis.blob`
- [Alphanet migration blob](https://dbfiles.iota-rebased-alphanet.iota.cafe/migration.blob):
`curl -fLJO https://dbfiles.iota-rebased-alphanet.iota.cafe/migration.blob`
- [Testnet genesis blob](https://dbfiles.testnet.iota.cafe/genesis.blob):
`curl -fLJO https://dbfiles.testnet.iota.cafe/genesis.blob`
- [Testnet migration blob](https://dbfiles.testnet.iota.cafe/migration.blob ):
`curl -fLJO https://dbfiles.testnet.iota.cafe/migration.blob `
1. Update your `fullnode.yaml` configuration file, if needed.
1. Recompile your IOTA Full node with the same command as in [Compiling the node](#compiling-the-node):
1. Restart your IOTA Full node:
Expand Down
Loading