# Software Upgrade for NMS Inverter: Remote Debugging and Local Operation Guide

## Abstract
This guide provides a comprehensive framework for upgrading Network Management System (NMS)-integrated inverter software, covering both remote debugging and local operation procedures. It emphasizes pre-upgrade checks, containerized deployment requirements, and post-upgrade validation, drawing on real-world examples from Huawei’s SUN2000 series and SevOne NMS upgrades.

## 1. Introduction
Modern NMS inverters, such as Huawei’s SUN2000 series and SevOne-monitored systems, require regular software upgrades to enhance functionality, security, and compatibility. This guide outlines best practices for remote debugging and local operations, addressing challenges like containerized architectures, AWS instance migrations, and real-time monitoring during upgrades.

## 2. Pre-Upgrade Preparation

### 2.1 Hardware and Software Compatibility Checks
- **SevOne NMS**: Verify AWS instance types (e.g., migration from r4. to r6i. for SevOne 8.0.0) and ensure vCPU/RAM meet minimum requirements. For example, SevOne 8.0.0 requires ≥16 vCPU cores and 64GB RAM for large clusters.
- **Huawei SUN2000**: Confirm firmware compatibility with hardware models (e.g., SUN2000-4.95KTL-NHL2 supports V200R023C10SPC209). Check mounting bracket dimensions and cable specifications to avoid physical damage during upgrades.

### 2.2 Backup and Data Integrity
- **SevOne**: Use `kubectl exec` to back up containerized configurations. Example command:
```bash
kubectl exec -n sevone -- tar czf /backup/config_backup.tar.gz /etc/sevone
```
- **Huawei**: Export logs via the COM port or antenna interface before upgrading SUN2000 inverters. Use Huawei’s SmartLogger 1000A to archive historical data.

### 2.3 Network and Port Configuration
- **SevOne**: Ensure port 60006 is open for pre-upgrade checks. Validate Kubernetes ingress rules for NMS API endpoints.
- **Huawei**: Verify RF performance (e.g., Bluetooth Low Energy for SUN2000-8KTL-M2) using STM32CubeMonitor-RF to detect communication bottlenecks.

## 3. Remote Debugging Procedures

### 3.1 Containerized Debugging with SevOne
SevOne’s shift to containerized deployment (v7.0.0+) necessitates remote debugging within Kubernetes pods:
1. **Attach to Leader Pod**:
```bash
kubectl get pods -n sevone | grep leader
kubectl exec -it -n sevone -- bash
```
2. **Monitor Real-Time Metrics**:
Use `sevone-cli` to stream performance data:
```bash
sevone-cli monitor --metric "cpu_usage" --interval 5s
```
3. **Debug Custom Scripts**:
If scripts fail in read-only containers, modify them to write to `/tmp` and use `kubectl cp` to transfer files:
```bash
kubectl cp /local/script.sh sevone/:/tmp/script.sh
```

### 3.2 STM32CubeMonitor for Huawei Inverters
For Huawei inverters with STM32 microcontrollers (e.g., SUN600-5KTL-L0), use STM32CubeMonitor to debug firmware:
1. **Configure Node-RED Flows**:
Visualize variables like DC input voltage (PV1+/PV1–) in real time.
2. **Remote Access**:
Deploy Node-RED on a Raspberry Pi connected to the inverter’s COM port for low-latency monitoring.

## 4. Local Operation Guide

### 4.1 SevOne Local Upgrade Steps
1. **Download Migration Tarball**:
Request signed tarballs from IBM Support Portal for versions like 8.0.0.
2. **Execute Upgrade Script**:
```bash
cd /data/upgrade
tar xzf sevone_8.0.0_migration.tar.gz
./upgrade.sh --version 8.0.0 --force
```
3. **Validate Post-Upgrade**:
Check container status:
```bash
kubectl get pods -n sevone | grep -v Running
```

### 4.2 Huawei SUN2000 Local Upgrade
1. **Physical Installation**:
- Secure the DC switch with M6x60 expansion bolts to prevent accidental startup.
- Connect PV1+/PV1– and PV2+/PV2– terminals using 4mm² cables (per IEC 62446).
2. **Firmware Flashing**:
Use Huawei’s FusionSolar App to upload V200R023C10SPC209 via Bluetooth. For offline upgrades, insert a USB drive with the `.bin` file into the COM port.
3. **Commissioning**:
Verify LED indicators:
- **Green**: Normal operation.
- **Red**: Fault (e.g., ground failure or DC switch error).

## 5. Post-Upgrade Validation

### 5.1 Functional Testing
- **SevOne**: Run `sevone-cli test-connectivity` to validate API endpoints.
- **Huawei**: Perform a grid synchronization test using the “Cascading” feature on SUN2000-20KTL-M2.

### 5.2 Security Audits
- **SevOne**: Check for deprecated namespaces (e.g., `Device.custom` replacing legacy namespaces).
- **Huawei**: Use SDASD (Software-Defined Active Synchronous Detection) to scan for power bot attacks on inverter controllers.

## 6. Troubleshooting

### 6.1 Common SevOne Issues
- **Error**: “Container read-only file system”
**Solution**: Rebuild containers with writable volumes for custom scripts.
- **Error**: “AWS instance type incompatible”
**Solution**: Migrate to r6i. instances and update Kubernetes node labels.

### 6.2 Huawei SUN2000 Issues
- **Error**: “DC switch fault”
**Solution**: Re-tighten the M6 screw securing the switch (torque: 1.2 N·m).
- **Error**: “RF communication lost”
**Solution**: Re-pair Bluetooth using the FusionSolar App’s “Device Reset” option.

## 7. Conclusion
Upgrading NMS inverters requires meticulous planning, especially for containerized systems like SevOne and hardware-specific platforms like Huawei SUN2000. By following pre-upgrade checks, leveraging remote debugging tools (e.g., STM32CubeMonitor), and validating post-upgrade functionality, operators can minimize downtime and ensure compliance with standards like IEC 62446. For complex upgrades, consult IBM SevOne Support or Huawei’s Expert Labs to mitigate risks associated with custom scripts or AWS migrations.

**References**
1. IBM SevOne NMS Upgrade Process Guide (2025).
2. Huawei SUN2000MB V200R023C10 Upgrade Guide (2025).
3. Li, Y. (2018). *SDN-Enabled Cyber-Physical Security in Networked Microgrids*. IEEE Transactions on Sustainable Energy.