Linux Deployment Tutorial

WatchDog Agent

Use our provided installation script to quickly launch the service with just a few commands. This script simplifies the setup process for the relay service by automating numerous configuration and installation steps. Actions performed by the script include:

• Install prerequisites: Installs essential tools including Docker.

• Create the workplace: Set up execution environments and download the Docker images.

• Launch agent checking service: Deploys and starts the checking service.

With these system requirements in check, you'll be well-prepared to start the deployment of your WatchDog agent.

Should you encounter any issues or have questions, don't hesitate to seek support from the SendingNetwork community.

Installation

Step 1: Download Agent Installation Script

Depending on your system, use the following command to download and install the deployment script:

Ubuntu or other Debian-based system

sudo apt-get install -y wget && wget -N http://node4.sending.network:8120/watchdog_linux.sh  -P .

CentOS or other Red Hat-based system

sudo yum install -y wget && wget -N http://node4.sending.network:8120/watchdog_linux.sh  -P .

Step 2: Run the Installation Script

Change the permissions of the script and execute the installation script by running:

sudo chmod 777 watchdog_linux.sh && ./watchdog_linux.sh

When prompted, enter your wallet address.

Ensure you use a wallet address holding a valid License NFT. Each License NFT allows one active agent.

Step 3: Burner Wallet Setup

The WatchDog agent application will automatically generate a Burner Wallet for your agent and display it in your terminal. It will pause until sufficient gas is detected in the Burner Wallet. Due to testnet gas price fluctuations, transferring at least 0.001 testnet ETH is recommended.

Your Burner wallet has insufficient balance to complete the transaction. Please top up: "0xYourBurnerWalletAddress"

Please note that the burner wallet is only used to pay gas fees for submitting transactions to the blockchain, such as agent registration. Only transfer the minimal gas fee required for these transactions. Your SendingNetwork Experience Points (SXP) will still be linked to your wallet address that contains the WatchDog license NFT.

For the Alpha-3 testnet, we use the Optimism Sepolia testnet. You can obtain testnet ETH from the faucets recommended by Optimism. While claiming the testnet tokens, ensure the blockchain is set to Optimism and the network to Sepolia. Some faucets may require your wallet to hold a certain amount of mainnet tokens. If needed, claim testnet ETH with another wallet and transfer the testnet tokens to your burner wallet.

Step 4: Finish Installation

Once enough gas is received, you'll see the following output, and your agent is up. The wallet address is your burner wallet address.

{"wallet":"0xYourBurnerWalletAddress","status":1}
The WatchDog node is up and running.

If you are running the script directly, please do NOT run it with sudo as it will impact the agent daemon process. Instead, you can run it under a common user account, or by using sudo su or the root account.

./watchdog_linux.sh

---

Check the status of WatchDog

To check if your agent is running, use the following command:

sudo docker ps -a | grep 'jack0818/watchdog' | grep -v grep | awk '{print $1}' | xargs sudo docker container inspect | grep '"Status": "running"'

If your agent is running, you will see the following output:

"Status": "running"

Check your agent ID

To display your agent ID, use the following command:

cat ~/WatchdogNode/run/watchdog/peerinfo

Stop the agent

To stop the agent, use the following commands.

1. Find and stop the WatchDog daemon process:

   sudo ps wxau | grep watchdog | grep sh | awk '{print $2}' | xargs sudo kill -9

2. Stop and remove the Docker containers:

   sudo docker ps -a | grep 'jack0818/watchdog' | awk '{print $1}' | xargs sudo docker stop | xargs sudo docker rm

Restart the agent

To restart your WatchDog agent, follow these steps:

1. Download the latest installation script: In the original directory, obtain the latest script and run it.

2. Maintain the original directory: If you run the agent from a new directory other than the original one, it will create a new agent ID. Points will be accrued with this new ID, but previous points will remain valid under the original agent ID.

---

Next Steps

After finishing the installation, interact with our auto-reply bot on the SendingMe app to check your agent's stats. SendingMe is an all-in-one web3 instant messaging app built on top of SendingNetwork. Refer to Check Node Stats with Auto-Reply Bot in SendingMe for instructions on utilizing the bot to monitor your agent's performance.

Should you encounter any issues or have questions, don't hesitate to seek support from the SendingNetwork community.