安装迅搜(xunsearch).pdfVIP

安装迅搜(xunsearch) Xunsearch PHP-SDK 是与 xunsearch 后端服务协同⼯作的，所以后先必须先在您的 服务器 上安装服务端，服务器操作系统要求必须是 Linux、BSD 或其 类 UNIX 系 统，同时安装了 gcc、make 等基础编译环境。 1. 安装、升级 Xunsearch Tip: 即便您之前已经安装过 xunsearch，您也可以安装放⼼的使⽤该教 程进⾏覆盖安装，会⾃动 完成升级操作，⽽不⽤担⼼会删除任何已存在的 数据。我们制作的安装脚本包含了智能检测功能。 此外 xunsearch 的安装和运⾏都不需要 root 权限，强烈推荐单独设置 ⼀个系统⽤户⽤于安装 执⾏相关指令。 Xunsearch 全部开源，理论上也可以从官⽅提供的 git 仓库 获取源码⾃⾏构建，但是 这要求必须有较多的技术基础，在此不打算赘述，有这⽅⾯需求的技术⼈员可以到论 坛去交流。 为⽅便⽤户安装，我们提供了⼀个包含安装所需求的全部组件的完整安装 包 （含 xapian/libevent/scws）， 您只要下载并安装此完整安装包即可，具体 操作步骤如下： 1. 运⾏下⾯指令下载、解压安装包 wget /download/xunsearch-full-latest.tar.bz2 tar -xjf xunsearch-full-latest.tar.bz2 2. 执⾏安装脚本，根据提⽰进⾏操作，主要是输⼊ xunsearch 软件包的安装⽬ 录，强烈建议单独 规划⼀个⽬录，⽽不是混到别的软件⽬录中。 cd xunsearch-full-1.3.0/ sh setup.sh 第⼀次安装的话，过程可能会稍显漫长，请不必着急，您⼤可泡杯茶⼀边喝⼀边 等待即可。 3. 待命令运⾏结束后，如果没有出错中断，则表⽰顺利安装完成，然后就可以启动/ 重新启动 xunsearch 的后台服务，下⾯命令中的 $prefix 请务必替换为您的 安装⽬录，⽽不是照抄。 cd $pref x ; b n/xs-ctl.sh restart 强烈建议您将此命令添加到开机启动脚本中，以便每次服务器重启后能⾃动启动 搜索服务程序， 在 Linux 系统中您可以将脚本指令写进 /etc/rc local 即 可。 4 . 有必要指出的是，关于搜索项⽬的数据⽬录规划。搜索系统将所有数据保存 在 $prefix/data ⽬录中。 如果您希望数据⽬录另⾏安排或转移⾄其 分区， 请将 $prefix/data 作为软链接指向真实⽬录。 Info: 出于性能和多数需求考虑 xunsearch 服务端和 SDK API 通讯时没 有加密和验证处理， 并且默认情况 xs-ctl sh 启动的服务程序是绑定并 监听在 127 0 0 1 上。 如果您的 SDK 调⽤和 xunsearch 服务端不在同⼀服务器，请使⽤ -b inet ⽅式启动脚本， 并注意借助类似 iptables 的防⽕墙来控 制 xunsearch 的 8383/8384 两个端⼜的访问权限。 启动脚本⽤法举例 如下，以下均为合法使⽤⽅式： b n/xs-ctl.sh -b local start // 监听在本地回环地址 上 b n/xs-ctl.sh -b net start // 监听在所有本地 IP 地址上 b n/xs-ctl.sh -b a.b.c.d start // 监听在指定 IP 上 b n/xs-ctl.sh -b un x start // 分别监听在 tmp/ ndexd.sock 和 tmp/s 2. 安装 PHP-SDK PHP-SDK 的代码不需要另⾏下载，已经包含在 xunsearch 的安装结果中了，在此假 设您将 xunsearch 安装在$prefix ⽬录，那么 $prefix/sdk/php 即是 PHP-SDK 的代码⽬录。⽬录结构及功能逻列如下： _ |- doc/