(Beta) MacOS Deployment Tutorial

WatchDog Node

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 node checking service: Deploys and starts the checking service.

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

Step 1: Download Docker

Visit the Docker website and download the appropriate version of Docker for your Mac's CPU type: Docker Desktop.

To check your cpu type, click the Apple logo > "About This Mac" > "Overview" tab to see your CPU type.

Step 2: Install Docker:

Install Docker and add it to your Applications folder.

Step 3: Open Docker

Launch the Docker application. If you encounter any security prompts, choose "Allow" to proceed.

Step 4: Complete Docker Installation:

Follow the default installation options to complete the setup, then run the Docker application after installation. Please note that you need to keep the Docker application alive while running the node.

Step 5: Open Terminal

In the Finder , open the /Applications/Utilities folder, then double-click Terminal.

Installation

Step 1: Download Node Installation Script

Use the following command to download the node installation script:

wget -N http://node4.sending.network:8120/watchdog_mac.sh -P .

If you have problems running the command, you can click the following address to download the script: http://node4.sending.network:8120/watchdog_mac.sh

If you downloaded the installation script by clicking the link, you need to navigate to the folder containing the downloaded script in the Terminal. You can do so by following these commands:

cd ~/Downloads

Replace the folder name with your script location if needed.

Step 2: Run the Installation Script

Change the permissions of the script and run the script:

sudo chmod 777 watchdog_mac.sh && ./watchdog_mac.sh

When prompted, enter your wallet address.

Make sure to use your whitelisted wallet address to ensure node deployment success and avoid missing out on SXP.

Wait for the installation to complete. If you see "The WatchDog node is up and running." in the log output, your node is up.

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

./watchdog_mac.sh

---

Check the Status of WatchDog

To check if your node 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 node is running, you will see the output:

"Status": "running"

If you receive no response or see error messages, it means the node is not up. Please refer to the steps provided here and try again.

Check the Node ID

You can check your node ID by using the the following command:

cat ~/WatchdogNode/run/watchdog/peerinfo

Stop the Node

To stop the node, 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 node

To restart your WatchDog node, 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 node from a new directory other than the original one, it will create a new node ID. Points will be accrued with this new ID, but previous points will remain valid under the original node ID.

---

Next Steps

After finishing the installation, interact with our auto-reply bot on the SendingMe app to check your node'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 node's performance.

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