KB 214001 - Fix: UFM Service Not Starting on UFM Appliance UFM-MUA9502H

Note: This appliance UFM-MUA9502H is EOL as of 2022.

Pre-requisites

Ensure the following conditions are met before attempting to start the UFM service:

Ensure the license is attached.
Verify bond0 is configured with eth0 and eth1.
1. Command: show interface bond0
Set the management interface on eth0 or eth1.
1. Commands:
```
config terminal
ufm mgmt-interface eth0
```
Ensure eth0/eth1 is up.
1. Command:
```
show interfaces
```

Starting UFM Service

Once the prerequisites are met, attempt to start the UFM service:

Command:
```
ufm start
```

Troubleshooting: SM Already Running

If the service does not start and you see a message indicating that the Subnet Manager (SM) is already running:

Stop SM on the connected InfiniBand switch.
Run the following command to safely stop the SM running on UFM:
```
ufm safe-stop
```
Retry starting UFM:
```
ufm start
```
Check the status:
```
show ufm status
```

Issue: UFM Shows as Stopped but Other Services are Running

If you see the message "ufm: stopped but other services are running", follow the steps below to update the UFM appliance firmware.

Fix: Update UFM Appliance Firmware to 4.11.1.1

Firmware Version: image-ufm_appliance-x86_64-UFMAPL_4.11.1.1_UFM_6.12.1.1-20230209-111043.img

Downloading the New Firmware

Go to the NVIDIA Networking Portal (NPN).
Click the "Get Help" tab > Click "Enterprise Support" button.
You will be redirected to the Enterprise Support Portal.
Click the "Downloads" tab.
Select "Software" > "UFM Appliance".
You will be redirected to the Licensing Portal.
Click the "Software Downloads" tab.
Search for "UFM Appliance".
Select the version mentioned above and download the firmware.

Updating the UFM Appliance

Log in to the Management Portal of UFM.
Upload the downloaded .img file.
Initiate the update process and reboot the appliance.

Once the update is complete, the UFM service issue should be resolved. Verify that the service is running by executing:

show ufm status

Conclusion: Following the above steps should resolve the issue of the UFM service not starting on the UFM Appliance UFM-MUA9502H. If the problem persists, consider reaching out to enterprise support for further assistance.