Tmedia Major Upgrade

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(creation)
 
(Stop and start tbtoolpack)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This article shows how to upgrade a Toolpack v2.5 or v2.6 system to Toolpack v2.7.
+
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.
 +
 
 +
*[[Toolpack:System_Settings_A#Package_Upgrade|Toolpack v2.8 package upgrades]]
 +
*[[Web_Portal_Tutorial_Guide_v2.7#Minor_Package_Upgrade|Toolpack v2.7 package upgrades]]
 +
 
 +
 
 +
== Manual Upgrade ==
 +
'''Important: You need to use this procedure if your system runs version before 2.7.148'''.
  
 
'''Warning:''' Major upgrades require service interruption.
 
'''Warning:''' Major upgrades require service interruption.
Line 5: Line 17:
 
'''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)
 
'''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 ====
  
==== Stop Toolpack Service  ====
+
'''Note:''' Only applicable for units shipped <u>before to February 7th 2013</u> needs to install the following gems.
  
  tbtoolpack stop
+
===== Install prerequisites =====
  
==== Lawful Intercept gems installation ====
+
Verify Ruby gem version:
 +
gem –v
 +
Result:
 +
1.3.6  (or later release)
  
Units shipped <u>before to February 7th 2013</u>, needs to install the following gems.  
+
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
  
===== Install gems =====
 
  
 
  wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/linux/bundler-1.2.3.gem
 
  wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/linux/bundler-1.2.3.gem
Line 23: Line 43:
  
  
===== Validate gems installation =====
+
===== Validate prerequisites installation =====
  
Execute the following command to list installed gems
+
Execute the following command:
 
  gem list
 
  gem list
  
If the gems are installed properly you should see the following:
+
If installed properly, you should see the following:
 
  *** LOCAL GEMS ***
 
  *** LOCAL GEMS ***
 
   
 
   
Line 35: Line 55:
 
  json (1.7.7)      <--- json 1.7.7
 
  json (1.7.7)      <--- json 1.7.7
  
 +
'''Note:''' If the results deviates from the above, please contact TelcoBridges Support.
  
 
==== Install package  ====
 
==== Install package  ====
Line 43: Line 64:
 
Verify that the system will run on the correct version:
 
Verify that the system will run on the correct version:
  
  cat /lib/tb/toolpack/setup/12358/service/config.txt | grep  /lib/tb/toolpack
+
  cat /lib/tb/toolpack/setup/12358/service/config.txt | grep  tb/toolpack
  
 
Example of a v2.7 system configuration
 
Example of a v2.7 system configuration
Line 57: Line 78:
  
  
==== Copy audio files from [[TB_StreamServer|StreamServer]]  ====
+
==== Copy audio files from [[TB_StreamServer|StreamServer]] (optional) ====
 +
 
 +
'''Note:''' Only applicable if you have custom audio files.
 +
 
 
Customs audio files played by the [[TB_StreamServer|StreamServer]] are not copied automatically by the system. Therefore, it must be done manually.
 
Customs audio files played by the [[TB_StreamServer|StreamServer]] are not copied automatically by the system. Therefore, it must be done manually.
  
Line 65: Line 89:
  
  
==== Start Toolpack Service  ====
+
==== Restart Toolpack Service  ====
  
 +
  tbtoolpack stop
 
   tbtoolpack start
 
   tbtoolpack start

Latest revision as of 15:46, 19 September 2017

This article shows how to do a major upgrade.

Contents

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 (optional)

Note: Only applicable if you have custom audio files.

Customs audio files played by the StreamServer 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
Personal tools