Toolpack installer B
From TBwiki
(Difference between revisions)
(→Toolpack installation options) |
|||
| (One intermediate revision by one user not shown) | |||
| Line 6: | Line 6: | ||
*You need to obtain the new version of the Toolpack software from the designated location. Please contact the [mailto:support@telcobridges.com TelcoBridges support team] to know which version to use. The package name starts with TBToolPack. | *You need to obtain the new version of the Toolpack software from the designated location. Please contact the [mailto:support@telcobridges.com 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 [http://filezilla-project.org/ FileZilla] | *Upload this package to the server running Toolpack with scp or a SFTP tool like [http://filezilla-project.org/ FileZilla] | ||
| + | |||
| + | === Usage examples === | ||
| + | Start the installer with no arguments will start the "Text-mode" installation. | ||
| + | |||
| + | # ./TBToolPack-2.9.26-Linux-centos7-x86_64-Install | ||
== Toolpack installation options == | == Toolpack installation options == | ||
| + | Those options will be prompt by the installer. | ||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
| Line 13: | Line 19: | ||
!! width="275" style="background:LightBlue" | Description | !! width="275" style="background:LightBlue" | Description | ||
|- | |- | ||
| − | | dbhost || Toolpack database hostname | + | | Primary Database IP (dbhost) || Toolpack database hostname or IP |
|- | |- | ||
| − | | dbpass || Toolpack database password | + | | Primary Database Password (dbpass)|| Toolpack database password |
|- | |- | ||
| − | | dbuser || Toolpack database user | + | | Primary Database Username (dbuser)|| Toolpack database user |
|- | |- | ||
| − | | dbdriver || Toolpack database ODBC driver | + | | OdbcDriver (dbdriver) || Toolpack database ODBC driver (MySQL by default) |
|- | |- | ||
| − | | [[System_Id|systemid]] || Toolpack System Id (previously know as [[Gateway_Port|tbxgwport]]) | + | | System Id ([[System_Id|systemid]]) || Toolpack System Id (previously know as [[Gateway_Port|tbxgwport]]) |
|- | |- | ||
| − | | primip || IP address of | + | | Primary Local IP (primip) || This is the local host IP address of the Primary ethernet interface by which communication with the TMedia takes place. If the field is left blank, IP address gets auto-detected. Also known as [[Gateway_Address|tbxgwaddr0]] |
|- | |- | ||
| − | | | + | | Redundant local IP (redid) || This is the local host IP address, of the Redundant ethernet interface, by which communication with the TMedia takes place when Primary interface is down. This Field can be left blank on a non-redundant network system. Also known as [[Gateway_Address|tbxgwaddr1]] |
|} | |} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==== TMG3200/TMG800 ==== | ==== TMG3200/TMG800 ==== | ||
| − | + | The --[[Gateway_Address|primip]] and --[[Gateway_Address|redip]] are mandatory and needs to be set to 172.31.1.2 for both "primip" and "redip". | |
| − | + | Usage example, installing release 2.9.26: | |
| − | + | ||
| − | + | ||
| − | + | # ./TBToolPack-2.9.26-Linux-centos7-x86_64-Install --[[Gateway_Address|primip]] 172.31.1.2 --[[Gateway_Address|redip]] 172.31.1.2 | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
=== Toolpack Multi system support === | === Toolpack Multi system support === | ||
| Line 73: | Line 66: | ||
== Toolpack Text-mode Installation == | == Toolpack Text-mode Installation == | ||
| − | + | # ./TBToolPack-2.9.26-Linux-centos7-x86_64-Install --nodeps | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | # ./TBToolPack-2. | + | |
| − | + | This will install TBToolpack version 2.9.26 on your computer. Continue? [n/Y] | |
| − | + | ||
| − | + | ===== Basic parameters ===== | |
| + | Where do you want to install TBToolpack? [/lib/tb] | ||
| + | *'''/lib/tb''' is the default directory where all TelcoBridges packages is installed. | ||
| − | + | [[System Id|System Id]] [12358] | |
| + | *This is the tbx gateway port and will install '''tbtoolpack_${[[System Id|SystemId]]}''' OS service. | ||
| − | + | Service Start Type ("Auto Start" "Demand Start") [Auto Start] | |
| − | + | *"Auto Start" is use to start the Toolpack service at host boot up, "Demand Start" requires manual start. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Primary local IP [] | |
| − | + | ||
| + | Redundant local IP [] | ||
| + | *Local host IP address of the Primary and Secondary ethernet interface by which communication with the TMedia takes place. If the field is left blank, IP address gets auto-detected. | ||
===== Multi-Host parameters ===== | ===== Multi-Host parameters ===== | ||
| Line 108: | Line 89: | ||
Multi-Host System [y/N] N | Multi-Host System [y/N] N | ||
| − | * | + | *Tells if the system wil be composed of more than one host. For TMG, only choose "N" (unless installing for 1+1 system) |
===== Primary Database Connection ===== | ===== Primary Database Connection ===== | ||
| Line 115: | Line 96: | ||
| − | Primary Database Hostname [ | + | Primary Database Hostname [centos-tb] |
| − | + | * localhost and 127.0.0.1 are not allowed. Put the hostname or the IP of the primary control interface. | |
| − | + | ||
Primary Database Redundant IP [] | Primary Database Redundant IP [] | ||
| − | + | * localhost and 127.0.0.1 are not allowed. Can be left blank on a non Multi-Host System. | |
Primary Database Username [tbdb] | Primary Database Username [tbdb] | ||
| − | |||
Primary Database Password [tbdbpw] | Primary Database Password [tbdbpw] | ||
| − | |||
Primary Database Port [3306] | Primary Database Port [3306] | ||
| − | + | * press "Enter" to use the default values. | |
| − | * | + | |
===== ''Optional'' License Installation ===== | ===== ''Optional'' License Installation ===== | ||
| − | + | License Location (*.zip/*.dat) | |
| − | + | *If you want to add a new license after the installation, simply copy it in the pkg/licenses/ of your toolpack installation. | |
| − | + | ||
===== Installation Progress ===== | ===== Installation Progress ===== | ||
| Line 141: | Line 118: | ||
Installing TBToolPack... | Installing TBToolPack... | ||
Copying | Copying | ||
| − | Copying /lib/tb/toolpack/setup/12358/2. | + | Copying /lib/tb/toolpack/setup/12358/2.9/apps/toolpack_sys_manager/toolpack_sys_manager |
Copying /lib/tb/toolpack/tbtoolpack | Copying /lib/tb/toolpack/tbtoolpack | ||
| + | ... | ||
===== Installation Complete ===== | ===== Installation Complete ===== | ||
Latest revision as of 14:57, 13 May 2016
Applies to version(s) v2.8 to v2.9
Contents |
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
Usage examples
Start the installer with no arguments will start the "Text-mode" installation.
# ./TBToolPack-2.9.26-Linux-centos7-x86_64-Install
Toolpack installation options
Those options will be prompt by the installer.
| Option | Description |
|---|---|
| Primary Database IP (dbhost) | Toolpack database hostname or IP |
| Primary Database Password (dbpass) | Toolpack database password |
| Primary Database Username (dbuser) | Toolpack database user |
| OdbcDriver (dbdriver) | Toolpack database ODBC driver (MySQL by default) |
| System Id (systemid) | Toolpack System Id (previously know as tbxgwport) |
| Primary Local IP (primip) | This is the local host IP address of the Primary ethernet interface by which communication with the TMedia takes place. If the field is left blank, IP address gets auto-detected. Also known as tbxgwaddr0 |
| Redundant local IP (redid) | This is the local host IP address, of the Redundant ethernet interface, by which communication with the TMedia takes place when Primary interface is down. This Field can be left blank on a non-redundant network system. Also known as tbxgwaddr1 |
TMG3200/TMG800
The --primip and --redip are mandatory and needs to be set to 172.31.1.2 for both "primip" and "redip".
Usage example, installing release 2.9.26:
# ./TBToolPack-2.9.26-Linux-centos7-x86_64-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
# ./TBToolPack-2.9.26-Linux-centos7-x86_64-Install --nodeps This will install TBToolpack version 2.9.26 on your computer. Continue? [n/Y]
Basic parameters
Where do you want to install TBToolpack? [/lib/tb]
- /lib/tb is the default directory where all TelcoBridges packages is installed.
System Id [12358]
- This is the tbx gateway port and will install tbtoolpack_${SystemId} OS service.
Service Start Type ("Auto Start" "Demand Start") [Auto Start]
- "Auto Start" is use to start the Toolpack service at host boot up, "Demand Start" requires manual start.
Primary local IP [] Redundant local IP []
- Local host IP address of the Primary and Secondary ethernet interface by which communication with the TMedia takes place. If the field is left blank, IP address gets auto-detected.
Multi-Host parameters
Multi-Host System [y/N] N
- Tells if the system wil be composed of more than one host. For TMG, only choose "N" (unless installing for 1+1 system)
Primary Database Connection
OdbcDriver (MySQL) [MySQL] Primary Database Hostname [centos-tb] * localhost and 127.0.0.1 are not allowed. Put the hostname or the IP of the primary control interface.
Primary Database Redundant IP [] * localhost and 127.0.0.1 are not allowed. Can be left blank on a non Multi-Host System. Primary Database Username [tbdb] Primary Database Password [tbdbpw] Primary Database Port [3306]
- press "Enter" to use the default values.
Optional License Installation
License Location (*.zip/*.dat)
- If you want to add a new license after the installation, simply copy it in the pkg/licenses/ of your toolpack installation.
Installation Progress
Installing TBToolPack... Copying Copying /lib/tb/toolpack/setup/12358/2.9/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.
