首页 帮助中心 基调听云Server 安装
基调听云Server

 对应x86/x86_64处理器的各个Linux发行版本，基调听云提供6个安装包，请选择适合您系统的安装包安装。

通常情况下：

  • RHEL, CentOS, SUSE：请使用RPM安装包。
  • Debian, Ubuntu：请使用DEB安装包。
  • 其他Linux发行版：请使用BIN安装包。

RPM安装包

RPM安装包适用于已经安装了rpm系统的Linux发行版，包括(但不限于) CentOS 5及以后版本、RHEL 5及以后版本、SUSE 10.0及以后版本。

安装步骤:

  1. 执行rpm安装。

    • 32位版本
    sudo rpm -Uvh tingyun-agent-php-版本.i386.rpm
    • 64位版本
    sudo rpm -Uvh tingyun-agent-php-版本.x86_64.rpm

  2. 将探针关联到PHP。

    sudo networkbench-install.sh

    在接下来的录入界面输入license：

    Enter license key (请录入授权码):_

  3. 重启PHP宿主服务(apache或php-fpm)。

DEB安装包

DEB安装包适用于已经安装了dpkg系统的Linux发行版，包括(但不限于) Debian 5及以后版本、Ubuntu 9.10及以后版本。

安装步骤:

  1. 执行DEB安装。

    • 32位版本
    sudo dpkg -i tingyun-agent-php-版本.i386.deb
    • 64位版本
    sudo dpkg -i tingyun-agent-php-版本.x86_64.deb

  2. 将探针关联到PHP。

    sudo networkbench-install.sh

    在接下来的录入界面输入license：

    Enter license key (请录入授权码):_

  3. 重启PHP宿主服务(apache或php-fpm)。

BIN安装包

与RPM安装包和DEB安装包相比，BIN安装包的适用范围更广。

BIN安装包适用于基于x86/x86_64、内核版本高于2.6.13，GLIBC版本高于2.5的Linux服务器发行版。 在没有dpkg和rpm的系统中可以使用bin包安装。

在需要探针以非root权限安装、运行或需要将探针安装到用户指定目录下时，必须使用bin包进行安装。

安装步骤:

  1. 运行bin包进行安装，默认安装到 /usr 下。

    • 32位版本
    tingyun-agent-php-版本.i386.bin

    如果您需要将bin包安装到指定位置，请使用 --prefix 参数。

    tingyun-agent-php-版本.i386.bin --prefix=/path/to
    • 64位版本
    tingyun-agent-php-版本.x86_64.bin

    如果您需要将bin包安装到指定位置，请使用 --prefix 参数。

    tingyun-agent-php-版本.x86_64.bin --prefix=/path/to

    说明：

    • 如果指定的安装路径没有写权限，安装过程中会提示更改安装路径，安装路径下存储so文件和bin文件。
    • 如果默认安装路径不在/usr, 安装过程中会提示指定运行路径，默认/var， 运行路径下为log文件和pid文件。
    • 如果提示由于权限原因导致失败，可以按照手工安装步骤操作，见“故障排查”中“手动安装PHP扩展”。

  2. 将探针关联到PHP。

    sudo networkbench-install.sh

    在接下来的录入界面输入license：

    Enter license key (请录入授权码):_

  3. 重启PHP宿主服务(apache或php-fpm)。

安装PHP扩展的脚本

用途

PHP探针程序需要安装PHP扩展模块到PHP环境中才能正常工作，并且需要授权码才能提供数据服务。各个系统的PHP版本和环境有很大差别，因此，我们需要有程序来做检测和安装的工作。安装脚本充当了这个角色。

脚本安装位置

/usr/bin/networkbench-install.sh

安装步骤

  1. 启动安装脚本。

    sudo sh /usr/bin/networkbench-install.sh

  2. 选择安装或卸载。

    安装脚本启动后，首先需要您选择是安装到PHP环境还是从PHP环境卸载探针。

    Please select from one of the following options:

1)  Install
2)  Uninstall

0)  Exit

   Enter choice (1-2, 0 to exit): _

    键盘输入"1" 将继续安装。

  3. 输入授权码。

    授权码是您从基调听云获得的服务授权号，请勿泄漏。

    Enter license key (请录入授权码): _

    输入您的授权码，继续安装。

  4. 输入网站应用名称。

    应用名称是给您的网站起一个名称，方便在报表显示。

    Enter App name (请输入应用名称): _

    输入网站的应用名称（直接回车则默认应用名称为PHP Application），继续安装。

  5. PHP版本选择。

    如果您的系统中安装了多个版本的PHP， 安装脚本会提示您做出选择，安装到某个指定版本的PHP或全部安装。

    Below is a list of the directories in which we found a copy of PHP. Please
select the directory or directories for which you wish to install Networkbench.
You can select either a single directory or multiple directories by separating
each choice with either a space or a comma. To select all of the directories
shown, please enter the special keyword 'all' (without the quotes).

   1)   /usr/bin
   2)   /usr/local/php/5.3.23/bin

   0)   Exit

   Selection (1-2, 0 to exit or all):

    键入您选择的序号，或者all全部安装。

  6. 安装结束。

    如果一切顺利，您将看到如下提示:

    Networkbench is now installed on your system. Congratulations!

    如果安装失败，请使用手动安装PHP扩展的方式。

  7. 重启apache、php-fpm等fast-cgi服务。

手动安装PHP扩展

当无法在标准位置查找到PHP或缺少PHP某些信息时，自动安装PHP扩展失败，此时需要我们手动安装。

%prefix% 为探针安装路径，so文件和bin文件放在此路径下，默认探针安装路径为 /usr， bin包安装时可以使用prefix参数指定。

  1. 确认操作系统是32位还是64位。

    uname -a

  2. 获取PHP信息。

    • PHP API 版本
    • 是否启用了线程模式(ZTS)
    • 扩展路径
    • 配置文件路径

    获取方式包括两种：

    • 优先使用 phpinfo() 函数来验证:

      echo "<?php phpinfo(); ?>" > /path/to/info.php

      使用浏览器访问 /path/to/info.php * PHP API 版本

      • 是否启用了线程模式(ZTS)
      • 扩展路径
      • 配置文件路径

    • 使用 php -i | grep 来验证:

      • PHP API 版本

        php -i | grep "PHP API"

      • 是否启用了线程模式(ZTS)

         php -i | grep "Thread Safety"

      • 扩展路径

         php -i | grep "extension_dir"

      • 配置文件路径

        php -i | grep "Loaded Configuration File" 
php -i | grep "Scan this dir for additional"

  3. 安装扩展 。

    在PHP扩展路径下，做一个软链接 networkbench.so 到 %prefix%/lib/networkbench/agent/ 下的对应版本的so扩展。

    这里假设：

    • 操作系统是64位
    • PHP版本是5.3，对应API版本为20090626
    • PHP启用了zts (zend thread safe)
    • 扩展路径为/usr/lib64/php/modules/

    对应命令为：

    ln -s /usr/lib/networkbench/agent/x64/networkbench-20090626-zts.so /usr/lib64/php/modules/networkbench.so

    PHP版本和探针so对应关系如下表所示：

    PHP 版本PHP API启用zts禁用zts
    5.320090626networkbench-20090626-zts.sonetworkbench-20090626.so
    5.420100525networkbench-20100525-zts.sonetworkbench-20100525.so
    5.520121212networkbench-20121212-zts.sonetworkbench-20121212.so
    5.620131226networkbench-20131226-zts.sonetworkbench-20131226.so
    7.020151012networkbench-20151012-zts.sonetworkbench-20151012.so
    7.120160303networkbench-20160303-zts.sonetworkbench-20160303.so
    7.220170718networkbench-20170718-zts.sonetworkbench-20170718.so
    7.320180731networkbench-20180731-zts.sonetworkbench-20180731.so
    7.420190902networkbench-20190902-zts.sonetworkbench-20190902.so

  4. 增加配置文件。

    如果PHP信息中附加的配置文件路径不为空（即Scan this dir for additional不为"none"）， 将配置文件模版networkbench.ini.template复制到php扩展配置的文件夹，并改名为networkbench.ini。

    假设附加的php扩展配置路径为：/etc/php.d/。

    命令为：

    cp /usr/lib/networkbench/scripts/networkbench.ini.template /etc/php.d/networkbench.ini 
vi /etc/php.d/networkbench.ini

    如果附加的配置路径为空（即“Scan this dir for additional” 值为 "none"），将配置文件模版networkbench.ini.template的内容添加到PHP主配置文件（"Loaded Configuration File"项指定的文件）后面。

    假设PHP主配置文件路径为：/etc/php.ini。

    命令为：

    cp /etc/php.ini /etc/php.ini.bak 
cat /usr/lib/networkbench/scripts/networkbench.ini.template >> /etc/php.ini 
vi /etc/php.ini

  5. 修改授权码。

    修改配置文件内 nbs.license_key 为您的授权码：

    vi /path/to/networkbench.ini		    
修改 nbs.license_key=

    注意： 如果您使用了bin包安装，还需要创建%runtime_root%/log/networkbench/ 文件夹并赋予其足够的权限。

    假设 nbs.runtime_root=/home/mike，

     mkdir /home/mike/log/networkbench 
 chmod 777 /home/mike/log/networkbench

    然后修改配置文件内的nbs.prefix 为指定的安装路径，修改nbs.runtime_root为运行路径。

     vi /path/to/networkbench.ini
修改 nbs.prefix=/{path}/prefix
修改 nbs.runtime_root=/home/mike

  6. 重启Web容器。

    sudo service httpd start

    或

    sudo service php-fpm start