> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/tmedia-documentation/server-and-os-administration/toolpack-prerequisite-centos5-2-5-manual.md). # Toolpack prerequisite CentOS5 2-5 manual This page shows how to manually install the prerequisites for Toolpack 2-5 on CentOS 5.x (instead of using the [repository procedure](/tmedia-documentation/server-and-os-administration/toolpack-prerequisites-for-centos-5.md)) ### Toolpack Prerequisites #### Toolpack Basic packages The software listed below is required by the host machines. ``` yum install gcc zlib-devel gdbm ``` #### Toolpack System Database The Toolpack system database is used by the main host and requires mySQL database server. The system database packages are as follows: ``` yum install mysql-server mysql-devel ``` Depending on the CentOS installation, the command paths for the database (i.e. mysql\_install\_db, mysqladmin, mysql) and system tools (chkconfig, service, etc) may not be included in the active PATH environment variable. MySql is usually installed in /usr/bin and system tools in sbin. 1. start and enable mysql /sbin/chkconfig mysqld on /sbin/service mysqld start 2. Setup initial database root password /usr/bin/mysqladmin -u root password tbdbpw **IMPORTANT**: Please read the ['Securing the Initial MySQL Accounts'](http://dev.mysql.com/doc/refman/5.1/en/default-privileges.html) article to learn how to manage users and privileges. 3. Install the database. mysql\_install\_db 4. Configure MySQL Users * Set password for the root user to 'tbdbpw' (TelcoBridges recommends that you set your own password for root) * Enable root connection from localhost only * Create a tbdb user (required by Toolpack) * Remove anonymous connection Example: ``` /usr/bin/mysqladmin -u root password tbdbpw mysql -uroot -ptbdbpw DELETE FROM mysql.user WHERE !(Host = 'localhost' AND User = 'root'); FLUSH PRIVILEGES; CREATE USER 'tbdb'@'%' IDENTIFIED BY 'tbdbpw'; GRANT ALL PRIVILEGES ON *.* TO 'tbdb'@'%' IDENTIFIED BY 'tbdbpw'; FLUSH PRIVILEGES; exit ``` To verify if the user is created: ``` mysql -uroot -ptbdbpw SELECT * FROM mysql.user; exit ``` 5.Install odbc driver and driver manager ``` yum install mysql-connector-odbc ``` 5a. For 32 bits system: ``` wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/linux/mysql-connector-odbc-3.51.27-linux-x86-32bit.tar.gz tar -zxf mysql-connector-odbc-3.51.27-linux-x86-32bit.tar.gz mkdir -p /lib/tb/toolpack/3rdparty/odbc-connector/ cp mysql-connector-odbc-3.51.27-linux-x86-32bit/lib/libmyodbc3_r-3.51.27.so /lib/tb/toolpack/3rdparty/odbc-connector/ ``` 5b. For 64 bits system: ``` wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/linux/mysql-connector-odbc-3.51.27-linux-x86-64bit.tar.gz tar -zxf mysql-connector-odbc-3.51.27-linux-x86-64bit.tar.gz mkdir -p /lib/tb/toolpack/3rdparty/odbc-connector/ cp mysql-connector-odbc-3.51.27-linux-x86-64bit/lib/libmyodbc3_r-3.51.27.so /lib/tb/toolpack/3rdparty/odbc-connector/ ``` 6\. Manually configure the odbc manager. Make sure mysql driver is enable(removing the comments for the mysql driver). Set the Driver as the previous command answer. ``` vim /etc/odbcinst.ini ``` Here is an example: 1. Driver from the MyODBC package 2. Setup from the unixODBC package \[MySQL] <----- This line must NOT start with a '#' Description = ODBC for MySQL Driver = /lib/tb/toolpack/3rdparty/odbc-connector/libmyodbc3\_r-3.51.27.so Setup = /usr/lib/libodbcmyS.so FileUsage = 1 3. Configure mysql to support database replication (Will not interfere if your system do not use it). vim /etc/my.cnf Add 2 new variable in the mysql config file Add log-bin and server-id. The value of server-id needs to be unique on each host( do not use 0 ). Make sure it is in the \[mysqld] section ``` log-bin server-id=''[UniqueId]'' ``` 1. Added to remove mysql dependency on DNS/nameserver skip-name-resolve Example: ``` [root@TL-CENTOS64-02 tblab]# cat /etc/my.cnf [mysqld] datadir=/var/lib/mysql socket=/var/lib/mysql/mysql.sock user=mysql log-bin server-id=1 ``` 1. Added to remove mysql dependency on DNS/nameserver skip-name-resolve 2. Default to using old password format for compatibility with mysql 3.x 3. clients (those using the mysqlclient10 compatibility package). old\_passwords=1 \[mysqld\_safe] log-error=/var/log/mysqld.log pid-file=/var/run/mysqld/mysqld.pid \[root\@TL-CENTOS64-02 tblab]# Reboot the mysql service ``` /sbin/service mysqld restart ``` #### Toolpack System Web Portal The Toolpack System Web Portal is required in order to host the Toolpack Web Portal. It requires the execution of all following commands: 1. Manually install fcgi: wget tar -xzf fcgi-2.4.0.tar.gz cd fcgi-2.4.0 ./configure make make install cd ../ 2. Install the following packages: yum install pcre libxml2 openssl-devel bzip2-libs 3. Install lighttpd: 3a. For 32 bits sytem: ``` wget -c http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/centos/lighttpd-1.4.18-1.el5.rf.i386.rpm wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/centos/lighttpd-fastcgi-1.4.18-1.el5.rf.i386.rpm rpm -ivh lighttpd-1.4.18-1.el5.rf.i386.rpm lighttpd-fastcgi-1.4.18-1.el5.rf.i386.rpm ``` 3b. For 64 bits sytem: ``` wget -c http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/centos/lighttpd-1.4.18-1.el5.rf.x86_64.rpm wget http://download.distribution.telcobridges.com/3rdparty/prerequisite/bin/centos/lighttpd-fastcgi-1.4.18-1.el5.rf.x86_64.rpm rpm -ivh lighttpd-1.4.18-1.el5.rf.x86_64.rpm lighttpd-fastcgi-1.4.18-1.el5.rf.x86_64.rpm ``` 4\. Install ruby wget tar -zxf ruby-1.8.7-p299.tar.gz cd ruby-1.8.7-p299 For 32 bits system: ./configure --libdir=/usr/local/lib --enable-shared For 64 bits system: ./configure --libdir=/usr/local/lib64 --enable-shared Then, execute the following for either 32 or 64 bits system: make make install cd ext/openssl/ ruby extconf.rb make make install cd ../../.. ln -s /usr/local/bin/ruby /usr/bin/ruby For 32 bits system: ln -s /usr/local/lib/libruby.so.1.8 /lib/libruby.so.1.8 For 64 bits system: ln -s /usr/local/lib64/libruby.so.1.8 /lib64/libruby.so.1.8 5. Install RubyGems 1.3.7 wget tar -zxf rubygems-1.3.7.tgz cd rubygems-1.3.7 ruby setup.rb cd .. 6. Install gem fcgi /usr/local/bin/gem install fcgi Make sure that the firewall enables these following services and ports. Failure to open those ports will render socket communication between the distributed software elements unavailable. Service: http (12358/tcp) Port: All ports (tcp/udp) enabled for local networks Make sure that SELinux is disabled. #### Toolpack Stream Server The Tmedia Toolpack Stream Server requires the execution of the following commands: ``` yum install libpcap ``` #### Toolpack Development Prerequisite The Toolpack System Development prerequisite section is only required for customers that will develop their own application using the Toolpack API: ``` yum install gcc-c++ libxml2-devel libpcap-devel unixODBC-devel ``` ### Validation Guide (highly recommended) If you would like to verify your installation go to the [Toolpack Validation Guide](/tmedia-documentation/legacy-releases-toolpack-v2.x/toolpack-v2-5/validate-toolpack-installation-2-5.md) ### Toolpack System installation Now that the prerequisite are installed, now it is time to install the Toolpack system --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://prosbcdocs.telcobridges.com/tmedia-documentation/server-and-os-administration/toolpack-prerequisite-centos5-2-5-manual.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.