首页 帮助中心 基调听云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