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

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

通常:
* RHEL, CentOS, SUSE 请使用RPM安装包
* Debian, Ubuntu 请使用DEB安装包
* 其他Linux发行版 请使用BIN安装包

RPM安装包

RPM安装包适用于已经安装了rpm系统的linux发行版,包括(但不限于) CentOS5及以后版本、RHEL5及以后版本、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发行版,包括(但不限于) Debian5及以后版本、Ubuntu9.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. 确认操作系统位数

    uname -a
    

    确认操作系统是32位还是64位

  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.3 20090626 networkbench-20090626-zts.so networkbench-20090626.so
    5.4 20100525 networkbench-20100525-zts.so networkbench-20100525.so
    5.5 20121212 networkbench-20121212-zts.so networkbench-20121212.so
    5.6 20131226 networkbench-20131226-zts.so networkbench-20131226.so
    7.0 20151012 networkbench-20151012-zts.so networkbench-20151012.so
    7.1 20160303 networkbench-20160303-zts.so networkbench-20160303.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.prefix 为指定的安装路径,修改nbs.runtime_root为运行路径

    假设 nbs.runtime_root=/home/mike

    mkdir /home/mike/log/networkbench 
    chmod 777 /home/mike/log/networkbench 
    vi /path/to/networkbench.ini
    修改 nbs.prefix=/path/to/prefix
    修改 nbs.runtime_root=/home/mike 
    
  6. 重启web容器

    sudo service httpd start
    

    sudo service php-fpm start