# Upgrade Manager

**Upgrade Manager** lets you manage firmware and TBOS (OS package) updates on your ProSBC and TMG devices from the MaaS portal. Open from **TB Nodes > Upgrade Manager > Overview**.

<figure><img src="/files/0pOVBv7OUcxmLAwnfF3B" alt=""><figcaption><p>Upgrade Manager — fleet grid and detail panel</p></figcaption></figure>

***

## Layout

The page is split into two panels:

* **Fleet Grid (left)** — every device you can access, with firmware version, topology, active call count, and serial number. Auto-refreshes every 48 seconds. Devices with a `Site` tag are grouped by site. Click a device to open its detail panel.
* **Detail Panel (right)** — device information, system hosts (Primary and Secondary), and action buttons.

***

## Actions

| Action                       | What It Does                                                                                                   |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Check for TBOS Updates**   | Checks all hosts in the system for available OS package updates.                                               |
| **Update TBOS**              | Applies available OS package updates to all hosts.                                                             |
| **Upload & Install**         | Uploads a firmware file from the server to the device's Primary host.                                          |
| **Check Available Versions** | Lists firmware packages currently installed on the device.                                                     |
| **Validate**                 | Validates a firmware package before activation.                                                                |
| **Activate**                 | Activates a firmware package. Toolpack restarts — active calls are preserved during switchover on 1+1 systems. |
| **Switch to Primary**        | For 1+1 HA only — switches the Active gateway to the Primary unit.                                             |

### Scope

* **TBOS updates** target every host in the system (Primary and Secondary).
* **Firmware operations** (upload, validate, activate) target the Primary host only — changes replicate to the Secondary automatically.

***

## How Actions Run

All actions run in the background.

1. Click the button — you'll see a status message immediately.
2. Progress updates appear automatically without needing to refresh.
3. The result is displayed when the action completes.

During an action, all buttons are disabled to prevent conflicts. You can safely navigate away — when you return and select the same device, any running or recently completed action is restored.

***

## Important Behaviors

### Activation

Activating a firmware package **restarts Toolpack** on the device (not the whole device). On a 1+1 HA system, traffic fails over to the standby unit during activation — active calls are preserved. The status display shows when the device is back online.

### HA Switchover Safety

If the Secondary unit is currently Active (carrying traffic), a warning shows the number of active call legs. A **30-second countdown** runs to ensure the switchover completes safely.

{% hint style="warning" %}
Do not navigate away from the page during the countdown.
{% endhint %}

### Major Version Upgrades

Upgrading to a different major version (e.g. 3.x → 4.x) is currently blocked in the UI while being validated. **Rollback to a previous major version is allowed.** Contact support if you need a forward major-version upgrade.

***

## History

Every action is logged. See [Action Log](/maas-documentation/maintenance/action-log.md) for the full history.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://prosbcdocs.telcobridges.com/maas-documentation/maintenance/upgrade-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.