# UboltAgent Linux Installation Manual

To ensure that users can view cloud server metric data and generate alerts through SCloud  Cloud Monitoring, the official monitoring Agent must be deployed on the target host. The collection of cloud server metric data depends on the monitoring Agent.

---

## Prerequisites

- Installing a new version of UboltAgent will uninstall the historical Python version `uma` (if installed).
- The command to obtain the UboltAgent installation package must be executed inside an SCloud  host, otherwise it cannot be downloaded properly.
- To ensure monitoring data is reported normally, the TCP protocol port `8088` must be allowed inside the cloud host operating system.
- If SELinux is in enforcing mode, set `SELINUX=disabled` in `/etc/selinux/config`, and restart the server for it to take effect.

---

## Linux Installation Steps

### 1. Log in to the Cloud Host as Root

The installation process requires logging in as the root user.

---

### 2. Download the Monitoring Component (using `wget` as an example)

**amd64 architecture:**

```bash
wget http://umon.api.service.ucloud.cn/static/cloudwatch/uboltagent-v1.3.4-linux-amd64.tar.gz
```

**arm64 architecture:**

```bash
wget http://umon.api.service.ucloud.cn/static/cloudwatch/uboltagent-v1.3.4-linux-arm64.tar.gz
```

> Note:  
> Before downloading the monitoring component via the intranet, please log in to the Linux instance and ensure that the cloud server uses the intranet DNS. Otherwise, the download address cannot be resolved.  
> If `wget` is not installed, please install `wget` first or use the `curl` command to download.

---

### 3. Install the Monitoring Component

#### Extract the Installation Package

**amd64 architecture:**

```bash
tar -zxf uboltagent-v1.3.4-linux-amd64.tar.gz
```

**arm64 architecture:**

```bash
tar -zxf uboltagent-v1.3.4-linux-arm64.tar.gz
```

#### Enter Installation Directory and Grant Script Permission

```bash
cd uboltagent
chmod a+x manage.sh
```

#### Run the Installation Script

```bash
./manage.sh install
```

> If errors occur during installation, check the log file:  
> `/var/log/uboltagent_install.log`

---

### 4. Verify Installation Status

#### Check if the Process Has Started

Run the following command:

```bash
ps -ef | grep uboltagent
```

If the execution result is similar to the screenshot below, it indicates that UboltAgent processes have started successfully, meaning the installation was successful.

![verify install status](https://cdn.udelivrs.com/2025/08/5d717120e9eecf7aad42dc7f973f2bf3_1756180396529.png)

#### Check Service Status

Run the following command:

```bash
service uboltagent status
# or
systemctl status uboltagent
```

If the execution result is similar to the screenshot below, it indicates that the UboltAgent service is running normally.

![check service status](https://cdn.udelivrs.com/2025/08/d0f4178e128c5b1da74ade7971f49a51_1756180396537.png)

#### Confirm in Cloud Monitoring

Wait about 5 minutes, then go to **Cloud Monitoring → CloudWatch → Product Monitoring → Resource Details** to check if metric charts are displayed correctly.

---

## Linux Uninstallation

1. Run the following command to uninstall:

```bash
./manage.sh uninstall
```

2. Run the following command to confirm if the process has stopped:

```bash
ps -ef | grep uboltagent
```

If no related processes are found, it means the uninstallation was successful.

![Linux uninstall](https://cdn.udelivrs.com/2025/08/f590b8438b0c2fa0d5e79355724e07e4_1756180396542.png)

---

## Notes

1. Firewall and Security Groups: Ensure that firewall and security group settings allow the cloud host to access the monitoring server address.
2. UboltAgent Version Compatibility: Ensure the downloaded UboltAgent version is compatible with your cloud host operating system.
3. Regular Updates: It is recommended to check and update UboltAgent regularly to obtain the latest features and security patches.
4. Troubleshooting: If you encounter issues during installation, check the installation log for detailed information or contact technical support.