Skip to main content

Install on Host

This document introduces the deployment process of SmartGate on mainstream Linux systems such as CentOS and Debian.

Download Installation Package​

Please log in to the Bonree ONE platform, go to Configuration > Agent Installation > SmartGate page, and download the latest SmartGate Linux installation package suitable for your system architecture.

Perform Installation/Update​

Follow the steps provided on the WEB interface to download and install SmartGate.

After the installation script completes execution, the program will automatically start running.

Installation with Specified Parameters​

You can specify necessary configuration parameters during installation:

# -a, --account Account GUID
# -u, --url Controller address
# --set-network-zone Network zone Default: default
# --set-cluster-name Cluster name Default: empty

sudo bash Bonree-SmartGate-xxx.sh config -a xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -u "https://xxx.xxx.com" --set-network-zone beijing01 --set-cluster-name cluster-1

Start, Stop, Restart Commands​

Use the following systemctl commands to manage the SmartGate service:

# Start service
systemctl start smartgate

# Stop service
systemctl stop smartgate

# Restart service
systemctl restart smartgate

Program Directory Structure​

SmartGate is installed by default in the /opt/bonree/smartgate directory with the following structure:

root@debian9:/opt/bonree/smartgate# tree
.
├── bin                    # Executable files directory
│   ├── smartgatewatchdog    
│   ├── smartgate
│   └── autoupdate
├── cache                  # Cache directory  
├── conf                   # Configuration files directory
│   ├── autoupdate.yml     # Auto-update configuration
│   └── smartgate.yml      # Program configuration
├── downloads              # Download directory
├── logs                   # Log files directory
│   ├── install
│   │   └── install.log    # Installation log 
│   ├── collector.log      # Middleware metrics collector log
│   ├── autoupdate.log     # Auto-update log
│   ├── smartgate.log      # Main program log
│   └── kubernetes.log     # Kubernetes cluster monitoring log
├── README.md              # User documentation
├── scripts                # Scripts directory
│   ├── smartgate.sh       # Control script
│   └── uninstall.sh       # Uninstall script
└── version.txt            # Version information file
warning

A /var/lib/bonree folder will be generated at runtime. Please do not delete it arbitrarily.

Uninstall Program​

Execute the uninstall script. The uninstallation process will automatically stop SmartGate from running.

Uninstall

sudo bash /opt/bonree/smartgate/scripts/uninstall.sh