> 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/software-upgrade.md).

# Software:Upgrade

This procedure will show how to upgrade a Toolpack system with host redundancy.

### Major Upgrade

TelcoBridges suggests to use 1 of the following 2 procedures:

* Minimize Risk Method. Simpler procedure but longer downtime.
* Minimize Downtime Method. More steps in the procedure but shorter downtime.

#### Requirements

Whichever procedure you will use, it is critical that you get the following information before upgrading your system.

* Read the rest of this procedure before starting.
* Do a backup of Toolpack configuration database.
* Toolpack host can access the internet to download new prerequisites (It is also possible to download the prerequisites and copy them on the server to install them manually)
* New major version license for all the Tmedia in your system (New license can be generate on \[Support:License\_server| TelcoBridges license server]
* Active your currently active configuration to make sure that there isn't any changes that you are not aware of.
* Download the Toolpack installer from the web

**Less Risk Method**

* Stop the Toolpack running on the both host (system will be down at this point).
* Run the [migration guides](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/upgrading-toolpack-system/README.md#major-upgrades) on the both host (Install new prerequisites only).
* Run the new installer on the both host.
* Verify that the primary host will start your new version (modify the 'application=' line to contain new version: '2.5' for version 2.5). vi /lib/tb/toolpack/setup/12358/service/config.txt (Linux) notepad C:\TelcoBridges\toolpack\setup\12358\service\config.txt (Windows)
* Start Toolpack on the primary host.
* Wait for the system to upgrade and that the system gets backup (downtime about 5 to 6 minutes per tmedia).
* Verify that both Toolpack service are started, you are able to connect to the Web Portal and the system is up.

**Minimize Downtime Method**

* Stop the Toolpack running on the primary host (this may cause a swithcover)
* Run the [migration guides](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/upgrading-toolpack-system/README.md#major-upgrades) on the primary host (Install new prerequisites only)
* Run the new installer on the primary host.
* Verify that the primary host will start your new version (modify the 'application=' line to contain new version: '2.5' for version 2.5). vi /lib/tb/toolpack/setup/12358/service/config.txt (Linux) notepad C:\TelcoBridges\toolpack\setup\12358\service\config.txt (Windows)
* Stop the Toolpack running on the secondary host (system will be down at this point)
* Start Toolpack on the primary host
* Wait for the system to upgrade and that the system gets backup
* Run the [migration guides](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/upgrading-toolpack-system/README.md#major-upgrades) on the secondary host (Install new prerequisites only)
* Run the new installer on the secondary host.
* Start Toolpack on the secondary host.
* Verify that both Toolpack service are started, you are able to connect to the Web Portal and the system is up.

### Minor Upgrade

#### Requirements

* Read the rest of this procedure before starting.
* Do a backup of Toolpack configuration database.
* Active your currently active configuration to make sure that there isn't any changes that you are not aware of.
* Download the Toolpack installer from the web.

**Minor Upgrade Method**

* Run the new installer on the primary host only.
* Wait 2 minutes for the primary host to copy the package to the secondary host.
* Switch package using the Web Portal.
* The system will update itself (downtime about 5 to 6 minutes per tmedia).
* Verify that both Toolpack service are started, you are able to connect to the Web Portal and the system is up.


---

# 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/software-upgrade.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.