更新时间：2023-12-08 16:36:59

单独安装应用执行器

如用户需要单独安装应用执行器，必须通过client_cli进行安装，具体安装命令为：

Windows：client_cli.bat install xxx

Linux/Unix：./client_cli install xxx

xxx参数说明：

  • File：通过从控制台下载执行器安装包，安装File执行器

  • File --path=/opt/File.tar.gz：通过指定本地执行器安装包，安装File执行器

注意:

  • Basic执行器只能通过整包中的install.sh安装，应用执行器不允许通过执行器安装包中的install.sh安装。
  • 一次只允许安装一个应用执行器。
  • 指定本地执行器安装包必须是绝对路径，且必须是.tar.gz或.zip压缩文件。

安装应用插件

Windows：client_cli.bat addplugin xxx

Linux/Unix：./client_cli addplugin xxx

xxx参数说明：

  • File root plugin1： 执行器用户为root的File执行器安装插件（通过从控制台下载插件）

  • File root plugin1 --path=/opt/plugin.tar.gz：执行器用户为root的File执行器安装插件（通过指定本地插件安装包）

注意：

  • 从控制台下载插件前需要确保控制台已上传插件。
  • 一次只允许安装一个插件。
  • 指定本地执行器安装包必须是绝对路径，且必须是.tar.gz或.zip压缩文件。

查看已安装的插件

Windows：client_cli.bat listplugin xxx

Linux/Unix：./client_cli listplugin xxx

xxx参数说明：

File root：显示执行器用户为root的File执行器已安装的插件

调用应用工具

Windows：client_cli.bat call xxx

Linux/Unix：./client_cli call xxx

xxx参数说明：

multiuser File root ：调用执行器用户为root的File执行器的multiuser工具

注意：
client_cli call自动扫描应用执行器安装目录下 /tool 目录里的 *.sh 或 *.bat脚本。

管理执行器

  1. 查看client_cli runner 的帮助信息

    Windows: client_cli.bat runner help

    Linux/Unix: ./client_cli runner help

    参数说明：

    • 【help】帮助信息
    • 【enable】启用应用runner
    • 【disable】禁用应用runner
    • 【status】查看runner状态
    • 【detail】查看runner的.pid文件
    • 【start】启动runner
    • 【stop】停止runner主进程
    • 【stopall】停止runner所有进程
    • 【restart】重启runner

  2. 启用/禁用执行器

    Windows: client_cli.bat runner enable(disable) xxx

    Linux/Unix: ./client_cli runner enable(disable) xxx

    enable：启用执行器

    disable：禁用执行器

    xxx参数说明：

    File root ：启用/禁用File执行器（root参数为执行器用户，根据实际填写，如果只有一个用户安装了该执行器，该参数可省略）

    注意：

    • 只有应用runner可以被启用/禁用。
    • 被禁用后的runner无法再次被拉起。

  3. 查看所有安装的runner状态

    Windows: client_cli.bat runner status

    Linux/Unix: ./client_cli runner status

    状态说明：

    • alived：runner正常
    • dead：runner挂掉
    • disbaled：runner禁用状态
    • abnormal：runner有异常

  4. 查看所有runner的进程pid

    Windows: client_cli.bat runner detail xxx

    Linux/Unix: ./client_cli runner detail xxx

    xxx参数说明：

    • all：显示所有runner进程pid

    • Basic：显示Basicrunner进程pid

    • File root ：显示File执行器的进程pid（root参数为执行器用户，根据实际填写，如果只有一个用户安装了该执行器，该参数可省略）

  5. 停止runner

    Windows: client_cli.bat runner stop(stopall) xxx

    Linux/Unix: ./client_cli runner stop(stopall) xxx

    stop: 停止runner

    stopall：停止runner所有进程

    xxx参数说明：

    • all：停止所有runner（所有进程）

    • Basic：停止Basic（所有进程）

    • File root ：停止File执行器（所有进程）（root参数为执行器用户，根据实际填写，如果只有一个用户安装了该执行器，该参数可省略）

    注意：
    stopall会强制杀死任务进程，导致任务状态出现已停止或失败等情况，当有任务正在执行时谨慎使用。

  6. 启动runner

    Windows: client_cli.bat runner start xxx

    Linux/Unix: ./client_cli runner start xxx

    xxx参数说明：

    • all：启动所有runner

    • Basic：启动Basic

    • File root ：启动File执行器（root参数为执行器用户，根据实际填写，如果只有一个用户安装了该执行器，该参数可省略）

    注意：
    Windows中runner为启动状态时，如再次启动则可能显示“服务的实例已在运行中”，为正常现象。

  7. 重启runner

    Windows: client_cli.bat runner restart xxx

    Linux/Unix: ./client_cli runner restart xxx

    xxx参数说明：

    • all：重启所有runner

    • Basic：重启Basic

    • File root ：重启File执行器（root参数为执行器用户，根据实际填写，如果只有一个用户安装了该执行器，该参数可省略）

修改IP

  1. 查看client_cli config的帮助信息

    Windows: client_cli.bat config

    Linux/Unix: ./client_cli config

    参数说明：

    • 【selfip】更新selfip

    • 【target】更新targetip及端口

    注意：

    • 执行client_cli config修改相关配置后，需要重启所有runner才能生效：(Linux/Unix) ./client_cli runner restart all, (Windows) client_cli.bat runner restart all
    • 选择云环境部署的客户端不支持该工具。

  2. 修改selfip

    Windows: client_cli.bat config selfip xxx

    Linux/Unix: ./client_cli config selfip xxx

    xxx参数：当前客户端的selfip

  3. 修改targetip及端口

    Windows: client_cli.bat config target xx1 xx2

    Linux/Unix: ./client_cli config target xx1 xx2

    • xx1参数：为连接到控制台的serverip

    • xx2参数：为连接到控制台的端口，一般为9614

生成新机器码

注意：

  • 执行该工具时会停止所有执行器及其进程，包括eefproc进程，使用前请检查是否有备份/恢复任务正在执行中。
  • 机器码根据CPU信息、MAC地址生成，如果这两个参数相同，生成的机器码也会相同。

相同机器码的客户端在控制台被认为一个客户端，需要两个不同的机器码进行区分，使用client_cli newmaccode可以生成新的机器码。

执行命令：
Windows: client_cli.bat newmaccode
Linux/Unix: ./client_cli newmaccode

用户确认，成功之后会显示生成的机器码。