> For the complete documentation index, see [llms.txt](https://tmediadocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tmediadocs.telcobridges.com/operations-and-support/upgrades/software-upgrades/tmedia-major-upgrade.md).

# Tmedia Major Upgrade

This article shows how to do a major upgrade.

### Web Portal Upgrade

**Important: You need to run version 2.7.148 or later, to do a major upgrade through the web**.

The procedure is the same as a minor upgrade.

### Manual Upgrade

**Important: You need to use this procedure if your system runs version before 2.7.148**.

**Warning:** Major upgrades require service interruption.

**Note:** For high availability systems, all the following commands needs to be executed on both units (for 1+1 systems) and both TMG7800-CTRL (for TMG7800 systems)

**Lawful Intercept prerequisites**

**Note:** Only applicable for units shipped before to February 7th 2013 needs to install the following gems.

**Install prerequisites**

Verify Ruby gem version: gem –v Result: 1.3.6 (or later release)

Verify Ruby gem folder: which gem Result: /usr/bin/gem

If both of these are ok, continue with the pre-requisites, otherwise, contact <support@telcobridges.com>

```
wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/linux/bundler-1.2.3.gem
gem install --local ./bundler-1.2.3.gem

wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/linux/json-1.7.7.gem
gem install --local ./json-1.7.7.gem
```

**Validate prerequisites installation**

Execute the following command: gem list

If installed properly, you should see the following: - LOCAL GEMS \*\*\*

```
bundler (1.2.3)    <--- bundler 1.2.3
fcgi (0.8.7)
json (1.7.7)       <--- json 1.7.7
```

**Note:** If the results deviates from the above, please contact TelcoBridges Support.

**Install package**

* Transfer new installer using sftp on the Tmedia unit
* Run installer on the unit

Verify that the system will run on the correct version:

```
cat /lib/tb/toolpack/setup/12358/service/config.txt | grep  tb/toolpack
```

Example of a v2.7 system configuration

```
application= /lib/tb/toolpack/setup/12358/2.7/apps/tboamapp/tboamapp_wd_cfg.ini
```

**Install licenses**

If not already done through the installer, copy the licenses in the licenses directory

```
/lib/tb/toolpack/pkg/licenses/
```

**Copy audio files from** [**StreamServer**](/other-pages/operations/tb-streamserver.md) **(optional)**

**Note:** Only applicable if you have custom audio files.

Customs audio files played by the [StreamServer](/other-pages/operations/tb-streamserver.md) are not copied automatically by the system. Therefore, it must be done manually.

Example of copying custom audio files from a v2.6 to v2.7 system: cp /lib/tb/toolpack/setup/12358/2.6/apps/tbstreamserver/*.wav /lib/tb/toolpack/setup/12358/2.7/apps/tbstreamserver cp /lib/tb/toolpack/setup/12358/2.6/apps/tbstreamserver/prompts/*.wav /lib/tb/toolpack/setup/12358/2.7/apps/tbstreamserver/prompts

**Restart Toolpack Service**

```
tbtoolpack stop
tbtoolpack start
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://tmediadocs.telcobridges.com/operations-and-support/upgrades/software-upgrades/tmedia-major-upgrade.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.