> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/tmedia-documentation/server-and-os-administration/upgrading-toolpack-system.md).

# Upgrading Toolpack System

There are three types of Toolpack upgrades. They are major, minor and license upgrades.

Note: A fourth type of intervention, not considered to be an upgrade, is a system reconfiguration.

**Before proceeding with an upgrade, ensure that the active configuration is activated and that there are no errors**

```
Global -&gt;&nbsp;Systems -&gt; Edit -&gt;&nbsp;Activate
```

### Software Upgrades

#### Toolpack Upgrades

**Since v2.7.148**, it is possible to do minor and major upgrades using the web portal:

* [Toolpack v2.9: Package Upgrade](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/web-portal-2-9-system-settings/README.md#package-upgrade)
* [Toolpack v2.8: Package Upgrade](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/web-portal-2-8-system-settings/README.md#package-upgrade)
* [Toolpack v2.7: Package Upgrade](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/tmedia-tsig-and-tdev-web-portal-2-7-tutorial-guide/README.md#minor-package-upgrade)

**Major Upgrade (previous to 2.7.148)**

It is considered to be a **major upgrade** when changing from one full release version or a major point release to another. For example, v2.2 to v2.3 or v2.3 to v2.4.

\*NOTE\*: Major upgrades needs service interruption.

* [Major upgrade procedure for Toolpack release v2.7](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/platforms/tmedia-major-upgrade/README.md) (previous to 2.7.148)
* [Major upgrade procedure for Toolpack release v2.6 from v2.3, v2.4 or v2.5](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-6/README.md)
  * For Toolpack release v2.2, follow the [Major upgrade procedure for Toolpack release v2.3](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-3/README.md) followed by the [Major upgrade procedure for Toolpack release v2.6](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-6/README.md)
* [Major upgrade procedure for Toolpack release v2.5 from v2.3 or v2.4](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-5/README.md)
  * For Toolpack release v2.2, follow the [Major upgrade procedure for Toolpack release v2.3](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-3/README.md) followed by the [Major upgrade procedure for Toolpack release v2.5](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-5/README.md)
* Major upgrade procedure for Toolpack release v2.4
  * From Toolpack release v2.3 (No new prerequisites, [v2.4 major upgrade procedure](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-4/README.md))
  * From Toolpack release v2.2 (Refer to [v2.3 major upgrade procedure](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-3/README.md))
* [Major upgrade procedure for Toolpack release v2.3](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-major-upgrades-2-3/README.md)

**Minor Upgrades**

It is considered to be a \*\*minor upgrade \*\* when moving from one minor point release to another. For example, v2.3.1 to v2.3.2. Minor upgrades can be done without service interruption if the system is configured as High Availability (HA).

* [Minor upgrade procedure for Toolpack release v2.7](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/tmedia-tsig-and-tdev-web-portal-2-7-tutorial-guide/README.md#minor-package-upgrade)
* Minor upgrade procedure for Toolpack release v2.6
* Minor upgrade procedure for Toolpack release v2.5
* Minor upgrade procedure for Toolpack release v2.4 (Refer to v2.3 minor upgrade procedure)
* [Minor upgrade procedure for Toolpack release v2.3](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-minor-upgrades-2-3/README.md)

#### Operating System Upgrades

The TMG-CONTROL software is running over Telcobridges operating system. To upgrade the operating system, it requires the following procedure:

* [Upgrade Telcobridges Linux](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/upgrade-telcobridges-linux-software-packages/README.md)

### License Upgrades

A **license upgrade** activates new functionality or capacity in the system. Examples of license upgrades include adding SS7 signalling, or unlocking additional IVR capabilities.

* [License upgrade procedure for Toolpack](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/add-change-licenses/README.md#change-licenses)

### System Reconfiguration

A **system reconfiguration** is required when:

* Upgrading to a multi-host system
* Upgrading to a database HA system
* Modifying basic parameters such as [SystemId](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/misc/system-id/README.md), [Primary local IP](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/gateway-address/README.md), or [Secondary local IP](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/gateway-address/README.md)
* Modifying configuration databases parameters

**Important: System reconfiguration requires an interruption of service.**

To reconfigure the [SystemId](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/misc/system-id/README.md) follow this procedure:

* [SystemId reconfiguration procedure for Toolpack release v2.3](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-system-systemid-reconfiguration-2-3/README.md)

For all other types of reconfiguration follow this procedure:

* [System reconfiguration procedure for Toolpack release v2.3](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/legacy/toolpack-system-reconfiguration-2-3/README.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://prosbcdocs.telcobridges.com/tmedia-documentation/server-and-os-administration/upgrading-toolpack-system.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
