Installing Toolpack

Applies to version(s) v2.8 to v2.9

Get installation package

• You need to obtain the new version of the Toolpack software from the designated location. Please contact the TelcoBridges support team to know which version to use. The package name starts with TBToolPack.
• Upload this package to the server running Toolpack with scp or a SFTP tool like FileZilla

Toolpack installation options

Option	Description
dbhost	Toolpack database hostname
dbpass	Toolpack database password
dbuser	Toolpack database user
dbdriver	Toolpack database ODBC driver
systemid	Toolpack System Id (previously know as tbxgwport)
primip	IP address of primary ethernet interface of the localhost. Also known as tbxgwaddr0
redip	IP address of the redundant ethernet interface of the localhost. Also known as tbxgwaddr1

Usage examples

TMP6400 usage example installing release 2-4-24 on a CentOS 5 64 bits host:

 TBToolPack-2.4.24-Linux-centos5-x86_64-Install

TMG3200/TMG800

For the TMG3200/TMG800 you need to use the right installer.

WARNING: Failure to use the correct installer for the TMG3200/TMG800 will damage your system.

Follow this link for the How to select the proper TBLinux installer

TMG3200/TMG800 usage example, installing release 2-4-24:

Warning: For TMG3200/TMG800 setting --primip and --redip is mandatory and needs to be set to --primip 172.31.1.2 --redip 172.31.1.2.

 TBToolPack-2.4.24-Linux-tbrel-1-28-ppc-Install --primip 172.31.1.2 --redip 172.31.1.2

Toolpack Multi system support

Toolpack installer now allows to have more than one setup being configured on the same host.

To enable this feature, the directory tree changed a little, here's what it looks like now:

 /lib/tb/toolpack/setup/12358/service
 /lib/tb/toolpack/setup/12358/2.4/apps
 /lib/tb/toolpack/setup/12358/2.4/licenses
 /lib/tb/toolpack/setup/12358/2.4

Note: 12358 was added in the setup path.

Each setup is installed as a service of the Operating System, under the following name:

 tbtoolpack_${SystemId}  -> ie: tbtoolpack_12358

Each service instance can be managed individually using "tbtoolpack" command.

 tbtoolpack start 12358
 tbtoolpack stop 12390

Note: If no SystemId is given, the tbtoolpack will prompt the user to select one among the installed one.

Toolpack Text-mode Installation

If your host has more than one network interface. It is recommended to set --primip and --redip parameters.

TMG3200/TMG800

TMG3200/TMG800 usage example, installing release 2-4-44:

Warning: For TMG3200 setting --primip and --redip is mandatory and needs to be set to --primip 172.31.1.2 --redip 172.31.1.2.

 TBToolPack-2.4.44-Linux-tbrel-1-28-ppc-Install --primip 172.31.1.2 --redip 172.31.1.2

The next example shows the installation of Toolpack on the TB Linux

 # ./TBToolPack-2.4.44-Linux-tbrel-1-28-ppc-Install --primip 172.31.1.2 --redip 172.31.1.2
 
 1.8.6 >= 1.8.5
 0.9.4 >= 0.9.0

This will configure TBToolPack version 2.4.44 on your computer. Continue? [n/Y]Y

Basic parameters

 System Id [12358]
 
 
 Service Start Type ("Auto Start" "Demand Start") [Auto Start]

• System Id: This is the tbx gateway port and will install tbtoolpack_${SystemId} OS service.
• Service Start Type: "Auto Start" is use to start the Toolpack service at host boot up, "Demand Start" requires manual start.

Multi-Host parameters

 Multi-Host System [y/N] N

• Multi-Host System: Tells if the system wil be composed of more than one host. For TMG users, only choose "N".

Primary Database Connection

 OdbcDriver (MySQL) [MySQL]
 
 
 Primary Database Hostname [TB005996] 172.31.1.2
 
 
 Primary Database Redundant IP []
 
 
 Primary Database Username [tbdb]
 
 
 Primary Database Password [tbdbpw]
 
 
 Primary Database Port [3306]

• HostName: localhost and 127.0.0.1 are not allowed.

Optional License Installation

Note: If you want to add a new license after the installation, simply copy it in the pkg/licenses/ of your toolpack installation.

 License Location (*.zip/*.dat)

Installation Progress

 Installing TBToolPack...
 Copying
 Copying /lib/tb/toolpack/setup/12358/2.4/apps/toolpack_sys_manager/toolpack_sys_manager
 Copying /lib/tb/toolpack/tbtoolpack

Installation Complete

 Installation of TBToolPack complete.
 
 To start tbtoolpack service, type the following command at a shell prompt:
 tbtoolpack start
 
 For more options:
 tbtoolpack help
 #

Note: It is not necessary for you to start tbtoolpack again if you didn't stop it before. If you are not sure, always start tbtoolpack at this point.