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