更新时间:2024-01-16 13:28:17

单独安装应用执行器

如用户需要单独安装应用执行器,必须通过client_cli进行安装。

查看client_cli install的帮助信息

Windows:client_cli.bat install
Linux/Unix:./client_cli install

安装应用执行器命令

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安装应用runner.png

Linux、Unix安装应用runner.png

安装应用插件

查看client_cli addplugin的帮助信息

Windows:client_cli.bat addplugin
Linux/Unix:./client_cli addplugin

安装应用插件命令

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安装应用插件.png

Linux、Unix安装应用插件.png

查看已安装的插件

Windows:client_cli.bat listplugin xxx
Linux/Unix:./client_cli listplugin xxx

xxx参数说明:

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

调用应用工具

查看client_cli call的帮助信息

Windows:client_cli.bat call
Linux/Unix:./client_cli call

调用应用执行器工具命令

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脚本。

Windows调用应用执行器工具.png

Linux、Unix调用应用执行器工具.png

管理执行器

查看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

启用/禁用执行器

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无法再次被拉起。

查看所有安装的runner状态

Windows: client_cli.bat runner status
Linux/Unix: ./client_cli runner status

状态说明:

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

查看所有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参数为执行器用户,根据实际填写,如果只有一个用户安装了该执行器,该参数可省略)

停止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会强制杀死任务进程,导致任务状态出现已停止失败等情况,当有任务正在执行时谨慎使用。

启动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为启动状态时,如再次启动则可能显示“服务的实例已在运行中”,为正常现象。

重启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

查看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
  • 选择云环境部署的客户端不支持该工具。

修改selfip

Windows: client_cli.bat config selfip xxx
Linux/Unix: ./client_cli config selfip xxx

xxx参数:当前客户端的selfip

修改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可以生成新的机器码。

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

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