8. Software Tarball

In this step you will download and extract the xx network software for the gateway computer.

About the Tarball

The xx network software is distributed in a compressed archive know as a tarball. With the exception of the PostgreSQL database, all of the xx network binaries, scripts, libraries, configuration files, and logs are located in the /opt/xxnetwork/ directory of the filesystem.

Gateway Tarball Directory Structure and Files

xxnetwork/
├── bin                          > binaries directory
│   └── xxnetwork-chain          > xx Network chain binary
├── config                       > configuration files directory
│   └── gateway.yaml             > Gateway binary configuration file
├── cred                         > TLS files directory
│   ├── network-management.crt   > Wrapper script TLS certificate
│   └── scheduling-cert.crt      > Scheduling server TLS certificate
├── db                           > xx chain data directory
├── gateway-wrapper.py           > Gateway binary management script
├── log                          > log files directory
│   └── gateway-cmd              > remote command log files directory
├── xxnetwork-chain.service      > xx chain service file
└── xxnetwork-gateway.service    > Gateway Wrapper script service file

6 directories, 7 files

Download the Gateway Tarball

cd /opt && sudo curl -L -O https://docs.xx.network/mainnet/gateway.tar.gz

Verify the Tarball Checksum

Verify the tarball

Visit the xx Network Tarball Page

Find the SHA256 checksum of the Gateway tarball and compare it with the output of the following command.

sha256sum /opt/gateway.tar.gz

Below is example output and it may differ from the current tarball's checksum.

5351fbbb288aedc782c8b08c2c9f818e56f15abc649d8287c08432fdc53ec06c  gateway.tar.gz

Please get help, if the output does not match the current tarball's checksum found on the xx Network Tarball Page

Extract the Tarball

sudo tar -xvf gateway.tar.gz

Claim Ownership Of /opt/xxnetwork

sudo chown $USER:$USER -Rv /opt/xxnetwork/