Toolpack installer 2-3

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Creation, needs to add pictures and text mode)
 
Line 1: Line 1:
 +
=== Toolpack installation options ===
 +
 +
{| class="wikitable" border="1"
 +
! width="225" style="background:LightBlue"  | Option
 +
!! width="275" style="background:LightBlue"  | Description
 +
|-
 +
| dbhost || Toolpack database hostname
 +
|-
 +
| dbpass || Toolpack database password
 +
|-
 +
| dbuser || Toolpack database user
 +
|-
 +
| dbdriver || Toolpack database ODBC driver
 +
|-
 +
| tbxgwport || Toolpack Tbx Gw Port
 +
|-
 +
| webuser || Lighttpd User credentials (*nix machines)
 +
|-
 +
| webgrp || Lighttpd Group credentials (*nix machines)
 +
|-
 +
| tbxgwaddr0 || Toolpack Tbx Gw Addr 0
 +
|-
 +
| tbxgwaddr1 || Toolpack Tbx Gw Addr 1
 +
|}
 +
 +
 +
=== Usage examples ===
 +
TMP6400 usage example installing release 2-3-1 on a CentOS 5 64 bits host:
 +
 +
  TBToolPack-2.3.1-Linux-centos5-x86_64-Install
 +
 +
TMG3200 usage example, installing release 2-3-1:
 +
 +
  TBToolPack-2.3.1-Linux-tbrel-1-ppc-Install --tbxgwaddr0 172.31.1.2 --tbxgwaddr1 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.3/apps
 +
  /lib/tb/toolpack/setup/12358/2.3/licenses
 +
  /lib/tb/toolpack/setup/12358/2.3
 +
 +
'''Note:''' ''12358'' was added in the setup path.
 +
 +
Each setup is installed as a service of the Operating System, under the following name:
 +
  tbtoolpack_${TbxGwPort}  -> ie: tbtoolpack_12358
 +
 +
Each service instance can be managed individually using "tbtoolpack" command.
 +
  tbtoolpack start 12358
 +
  tbtoolpack stop 12390
 +
 +
'''Note:''' If no TbxGwPort is given, the tbtoolpack will prompt the user to select one among the installed one.
 +
 +
 
== Toolpack Graphical Installation ==
 
== Toolpack Graphical Installation ==
  
−
Launch TBtoolpack installer with [color=green]administrator[/color] rights.:
 
  
−
  * **Welcome screen**
+
===== Welcome screen =====
−
[[Image:filename|thumb|widthpx| ]]
+
 
−
[[Image:Example.jpg|Welcome Pane]]
+
[[Image:Toolpack_welcome_screen_2-3.jpg|||Toolpack Welcome Screen Release 2-3]]
−
{{tbgw:tbs2gw:sshot-1.png|Welcome Pane}}
+
 
−
----
+
 
−
  * **Installation Type Pane**: Typical means will hide advanced parameters. Custom shows all parameters.
+
===== Installation Type Pane =====
 +
 
 +
[[Image:Toolpack_typical_screen_2-3.jpg|||Toolpack Typical Pane Screen Release 2-3]]
 +
[[Image:Toolpack_custom_screen_2-3.jpg|||Toolpack Custom Pane Screen Release 2-3]]
 +
 
 +
 
 +
===== Basic parameters screen =====
 +
 
 +
Fields with <span style="color:Red">*</span> are advanced parameters not show in typical setup.
 +
 
 +
[[Image:Toolpack_basic_param_screen_2-3.jpg|||Toolpack Basic Parameter Pane Screen Release 2-3]]
 +
 
 +
* '''TbxGwPort''': This is the tbx gateway port and will install '''tbtoolpack_${TbxGwPort}''' OS service.
 +
* '''Multi-Host System''': Tells if the system wil be composed of more than one host.  (Must be true for DBHA)
 +
* '''TbxGwAddr0''': For TMG3200, it should always be set to 172.31.1.2. For TMP6400, this value should be set if the host has multiple network interfaces.
 +
* '''TbxGwAddr1''': For TMG3200, it should always be set to 172.31.1.2. For TMP6400, this value should be set if the host has multiple network interfaces.
 +
 
 +
 
 +
===== Multi-Host parameters screen =====
 +
 
 +
[[Image:Toolpack_multi_host_screen_2-3.jpg|||Toolpack Multi-Host Pane Screen Release 2-3]]
 +
 
 +
* '''HostRole''': Set to '''Primary''' on host responsible for '''File replication''' and/or the '''HA database''' configuration.
 +
* '''Database HA''': Yes to use two databases in HA mode.
 +
 
 +
 
 +
===== Primary Database Connection Pane =====
 +
 
 +
Toolpack requires access to a MySQL database through ODBC. Provide required connection parameters.
 +
 
 +
Fields with <span style="color:Red">*</span> are advanced parameters not show in typical setup.
 +
 
 +
[[Image:Toolpack_prim_db_screen_2-3.jpg|||Toolpack Primary Database Pane Screen Release 2-3]]
 +
 
 +
* '''HostName''': localhost and 127.0.0.1 are not allowed.
 +
* '''OdbcDriver''': Name of the ODBC driver to use.
 +
 
 +
'''Note''': MySQL® Connector/ODBC (aka MyODBC) version 3.51 needs to be installed on all platforms prior to toolpack installation.  On Unix machines, unixODBC must also be installed and properly configured (ie: must have an entry [MySql] in /etc/odbcinst.ini).  See [[Toolpack_installation_2-3|Toolpack prerequisite]] for details.
 +
 
 +
 
 +
===== Secondary Database Connection Pane =====
 +
Toolpack requires access to a MySQL database through ODBC. Provide required connection parameters.
 +
Fields with <span style="color:Red">*</span> are advanced parameters not show in typical setup.
  
−
{{knowledgebase:toolpack:sshot-1.png|Typical}} {{knowledgebase:toolpack:sshot-2.png|Custom}}
+
[[Image:Toolpack_sec_db_screen_2-3.jpg|||Toolpack Secondary Database Pane Screen Release 2-3]]
−
----
+
−
  * **Basic parameters screen**
+
−
Fields with [color=red]*[/color] are advanced parameters not show in typical setup.
+
  
−
{{knowledgebase:toolpack:sshot-3.png|Basic parameters screen}}
+
* '''HostName''': localhost and 127.0.0.1 are not allowed.
  
−
  * **TbxGwPort**: This is the tbx gateway port and will install **tbtoolpack_${TbxGwPort}** OS service.
+
'''Note''': Hostname for the Secondary database must differ from the Primary database hostname.
−
  * **Multi-Host System**: Tells if the system wil be composed of more than one host.  (Must be true for DBHA)
+
−
  * **TbxGwAddr0**: For TMG only.
+
−
  * **TbxGwAddr1**: For TMG only.
+
−
\\
+
−
----
+
−
  * **Multi-Host parameters screen**
+
−
{{knowledgebase:toolpack:sshot-4.png|Multi-Host parameters screen}}
+
  
−
  * **HostRole**: Set to **Primary** on host responsible for **File replication** and/or the **HA database** configuration.
 
−
  * **Database HA**: Yes to use two databases in HA mode.
 
−
\\
 
−
----
 
−
  * **Primary Database Connection Pane**: Toolpack requires access to a MySQL database thru ODBC. Provide required connection parameters.
 
−
Fields with [color=red]*[/color] are advanced parameters not show in typical setup.
 
  
−
{{knowledgebase:toolpack:sshot-5.png|Primary Database Connection Pane}}
+
===== ''Optional'' License Installation Pane =====
 +
Installer can optionally install license(s) for the Tmedia products.
 +
License file can be either a single license (*.dat), or a group of licenses (*.zip).
 +
To skip license installation , press '''Next''' button.
  
−
  * **HostName**: localhost and 127.0.0.1 are not allowed.
+
[[Image:Toolpack_license_screen_2-3.jpg|||Toolpack License Pane Screen Release 2-3]]
−
  * **OdbcDriver**: Name of the ODBC driver to use.
+
  
−
**Note**: MySQL® Connector/ODBC (aka MyODBC) version 3.51 needs to be installed on all platforms prior to toolpack installation.  On Unix machines, unixODBC must also be installed and properly configured (ie: must have an entry [MySql] in /etc/odbcinst.ini).  See [[knowledgebase:odbc|knowledgebase:odbc]] for details.
 
  
−
\\
+
===== Installation Review Pane =====
−
----
+
−
  * **Secondary Database Connection Pane**: Toolpack requires access to a MySQL database thru ODBC. Provide required connection parameters.
+
−
Fields with [color=red]*[/color] are advanced parameters not show in typical setup.
+
  
−
{{knowledgebase:toolpack:sshot-7.png|Secondary Database Connection Pane}}
+
[[Image:Toolpack_review_screen_2-3.jpg|||Toolpack Review Screen Release 2-3]]
  
−
  * **HostName**: localhost and 127.0.0.1 are not allowed.
 
  
−
**Note**:  Hostname for the Secondary database must differ from the Primary database hostname.
+
=====Installation Progress Pane =====
  
−
\\
+
[[Image:Toolpack_progress_screen_2-3.jpg|||Toolpack Progress Screen Release 2-3]]
−
----
+
−
  * **//Optional// License Installation Pane**: Installer can optionally install license(s) for the Tmedia products.\\ License file can be either a single license (*.dat), or a group of licenses (*.zip).\\ To skip license installation , press **Next** button.
+
−
{{tbgw:tbs2gw:sshot-2.png|License Installation Pane}}
+
−
----
+
−
  * **Installation Review Pane**
+
−
{{tbgw:tbs2gw:sshot-5.png|Installation Review Pane}}
+
−
----
+
−
  * **Installation Progress Pane**
+
−
{{tbgw:tbs2gw:sshot-6.png|Installation Progress Pane}}
+
−
----
+
−
  * **Installation Complete Pane**: After having clicked **Finish**. Type [color=blue]tbtoolpack start[/color] at a shell prompt to start the service, or simply launch [color=blue]${INSTALLDIR}/toolpack/service/tbtoolpack_service[/color] with [color=green]administrator[/color] rights.
+
−
{{tbgw:tbs2gw:sshot-7.png|}}
+
  
  
 +
===== Installation Complete Pane =====
  
 +
After having clicked '''Finish'''. Type <span style="color:Blue">tbtoolpack start</span> at a shell prompt to start the service, or simply launch <span style="color:Blue">${INSTALLDIR}/toolpack/service/tbtoolpack_service</span> with <span style="color:Green">administrator</span> rights.
 +
[[Image:Toolpack_complete_screen_2-3.jpg|||Toolpack complete Screen Release 2-3]]
  
  
 
== Toolpack Text-mode Installation ==
 
== Toolpack Text-mode Installation ==

Revision as of 13:29, 15 May 2009

Contents

Toolpack installation options

Option Description
dbhost Toolpack database hostname
dbpass Toolpack database password
dbuser Toolpack database user
dbdriver Toolpack database ODBC driver
tbxgwport Toolpack Tbx Gw Port
webuser Lighttpd User credentials (*nix machines)
webgrp Lighttpd Group credentials (*nix machines)
tbxgwaddr0 Toolpack Tbx Gw Addr 0
tbxgwaddr1 Toolpack Tbx Gw Addr 1


Usage examples

TMP6400 usage example installing release 2-3-1 on a CentOS 5 64 bits host: 

 TBToolPack-2.3.1-Linux-centos5-x86_64-Install

TMG3200 usage example, installing release 2-3-1: 

 TBToolPack-2.3.1-Linux-tbrel-1-ppc-Install --tbxgwaddr0 172.31.1.2 --tbxgwaddr1 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.3/apps
 /lib/tb/toolpack/setup/12358/2.3/licenses
 /lib/tb/toolpack/setup/12358/2.3

Note: 12358 was added in the setup path.

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

 tbtoolpack_${TbxGwPort}  -> ie: tbtoolpack_12358

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

 tbtoolpack start 12358
 tbtoolpack stop 12390

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


Toolpack Graphical Installation

Welcome screen

Toolpack Welcome Screen Release 2-3


Installation Type Pane

Toolpack Typical Pane Screen Release 2-3 Toolpack Custom Pane Screen Release 2-3


Basic parameters screen

Fields with * are advanced parameters not show in typical setup.

Toolpack Basic Parameter Pane Screen Release 2-3

  • TbxGwPort: This is the tbx gateway port and will install tbtoolpack_${TbxGwPort} OS service.
  • Multi-Host System: Tells if the system wil be composed of more than one host. (Must be true for DBHA)
  • TbxGwAddr0: For TMG3200, it should always be set to 172.31.1.2. For TMP6400, this value should be set if the host has multiple network interfaces.
  • TbxGwAddr1: For TMG3200, it should always be set to 172.31.1.2. For TMP6400, this value should be set if the host has multiple network interfaces.


Multi-Host parameters screen

Toolpack Multi-Host Pane Screen Release 2-3

  • HostRole: Set to Primary on host responsible for File replication and/or the HA database configuration.
  • Database HA: Yes to use two databases in HA mode.


Primary Database Connection Pane

Toolpack requires access to a MySQL database through ODBC. Provide required connection parameters.

Fields with * are advanced parameters not show in typical setup.

Toolpack Primary Database Pane Screen Release 2-3

  • HostName: localhost and 127.0.0.1 are not allowed.
  • OdbcDriver: Name of the ODBC driver to use.

Note: MySQL® Connector/ODBC (aka MyODBC) version 3.51 needs to be installed on all platforms prior to toolpack installation. On Unix machines, unixODBC must also be installed and properly configured (ie: must have an entry [MySql] in /etc/odbcinst.ini). See Toolpack prerequisite for details.


Secondary Database Connection Pane

Toolpack requires access to a MySQL database through ODBC. Provide required connection parameters. Fields with * are advanced parameters not show in typical setup.

Toolpack Secondary Database Pane Screen Release 2-3

  • HostName: localhost and 127.0.0.1 are not allowed.

Note: Hostname for the Secondary database must differ from the Primary database hostname.


Optional License Installation Pane

Installer can optionally install license(s) for the Tmedia products. License file can be either a single license (*.dat), or a group of licenses (*.zip). To skip license installation , press Next button.

Toolpack License Pane Screen Release 2-3


Installation Review Pane

Toolpack Review Screen Release 2-3


Installation Progress Pane

Toolpack Progress Screen Release 2-3


Installation Complete Pane

After having clicked Finish. Type tbtoolpack start at a shell prompt to start the service, or simply launch ${INSTALLDIR}/toolpack/service/tbtoolpack_service with administrator rights. Toolpack complete Screen Release 2-3


Toolpack Text-mode Installation

Retrieved from "https://docs.telcobridges.com/mediawiki/index.php?title=Toolpack_installer_2-3&oldid=484"
Personal tools