主机
主机管理
Agent

一、什么是行云管家Agent

通过前面的章节,我们已经了解到在行云管家中,我们通过API来实现云主机的管理,通过Proxy来实现局域网主机的管理(私有部署版还可以通过直连模式来实现),但不论是云主机还是局域网主机,背后所管理的资源都是主机。

在默认情况下,云主机通过API已经能够获得大部分管理功能。而局域网主机由于缺乏监控手段,无法实现监控功能。另外在自动化运维场景中,我们除了SSH快捷方式这一种执行方式外,还需要一种更稳定更可靠的执行方案。

在这种需求下,我们推出行云管家Agent这一产品,将其部署在目标主机上,以完成局域网主机监控、自动化运维等高级特性。

二、行云管家Agent工作原理

需要注意的是,行云管家Agent是通过内网安装和工作的,也就是说它需要依托于Proxy(私有部署版直连模式可以依托于门户中转),如果您要在云主机上安装Agent,请先在网络中安装Proxy来启用内网访问,局域网主机天然已经具备了内网访问能力。而行云管家Agent工作过程中的监控数据汇报、自动化运维脚本和命令执行、文件分发,都是通过Proxy来与门户进行通信的。

三、行云管家Agent安装

3.1、安装行云管家Agent前置条件

了解了行云管家Agent工作原理,我们可以知道行云管家Agent在工作时,只会与内网络中的Proxy进行通信,所汇报的数据统一由Proxy提交给行云管家门户,行云管家Agent成功安装的前提有以下几点:

  • Proxy模式:内网中的Proxy工作正常;

  • Proxy模式:安装Agent的主机能够访问Proxy宿主机的8326端口;

  • 直连模式:安装Agent的主机能够访问行云管家门户服务器的80端口(默认是80);

  • 安装Agent的主机能够通过内网创建会话,远程桌面/终端能够正常访问;

  • 安装Agent时,需要使用系统管理员身份安装;

3.2、单台主机安装行云管家Agent

(a)如果您只需在单台主机上安装行云管家Agent,请进入主机详情页,在主机基本信息Agent状态处,点击“未安装”,将打开Agent安装对话框。

(b)行云管家为您提供了自动安装和手动安装两种方式。

(c)如果您选择自动安装,您只需要输入这台主机的登录凭证,系统将会登录这台主机,自动为您执行安装操作;

(d)如果您选择手动安装,请根据您的操作系统类型,登录到主机的远程桌面/终端,执行这段脚本进行安装;

3.3、批量安装行云管家Agent

(a)进入“网络”栏目,将列出您名下所有云账户及其下的区域和专有网络(以下简称VPC);

(b)找到您需要主机所在的区域/VPC并进入,如果Proxy运行正常,那么可以看到右侧的主机列表下方的“批量安装主机Agent”是可点击的。

(c)点击打开Agent批量安装向导,首先需要选择主机操作系统,如果您的主机既有Windows也有Linux,请分批安装,下面以Linux为例来介绍安装过程;

(d)接下来设置主机的安装信息,为了方便您快速便捷的安装,如果您的主机SSH连接信息都是标准化的,建议您通过批量设置功能设置安装信息(也可以指定SSH快捷方式);

(e)点击“批量设置”,在弹出的窗口中填写主机的SSH端口、账户、登录凭证后,点击“设置”,请注意:如果使用非root身份安装,请确保该用户能够执行sudo;

(f)设置完成后,勾选相应的主机,点击“下一步”按钮,开始安装;

(g)显示安装过程,列表中将列出每台主机的安装进度;

(h)安装完成后,自动显示最终安装结果,如果有安装失败的情况,将在这里统一展示,您可以将错误信息发送给我们的在线客服进行排查。

3.4、手动下载安装包安装行云管家Agent

如果您的服务器环境,Powershell和Bat脚本都无法执行(一般出现在Windows2003操作系统),那么您可以通过下载安装包的方式来安装行云管家Agent,但请注意以下两点:

  • 这种方式仅适用于Windows服务器,Linux请通过脚本安装;

  • 这种方式依旧需要确保Proxy的8326端口已经向目标主机开放;

(a)下载行云管家Agent 根据您的操作系统类型从以下地址将行云管家Agent安装包下载到目标主机上(如果是私有部署版,请将域名https://dl.cloudbility.com修改成您的实际行云管家门户地址):

32位:https://dl.cloudbility.com/downloads/cloudGateway/YunAgent-windows32-latest.zip

64位:https://dl.cloudbility.com/downloads/cloudGateway/YunAgent-windows64-latest.zip

(b)解压文件 以Windows为例,在目标主机上手工创建目录:C:\Program Files (x86)\Cloudbility\(32位系统目录是:C:\Program Files\Cloudbility\),并将安装包解压到这个目录中;

(c)获取安装信息 以Windows为例,打开行云管家Agent的安装窗口,切换到“Windows主机”,按照下图中的2,找到安装脚本中这段信息,将其复制下来,第一段是导入key,第二段信息是一个ip地址列表,表示一个或多个IP,用逗号连接,IP之间无空格;

(d)修改配置文件 用文本编辑器打开解压目录下的文件:\wrapper\conf\parameter_file.conf,将上一步拷贝的信息,粘贴到文件末尾最后一行,并保存。如图所示:

(e)安装并启动服务 使用管理员身份打开CMD命令提示行,根据操作系统32位或64位来选择执行以下命令:

32位:"C:\Program Files\Cloudbility\YunAgent\wrapper\bin\AppCommand.bat" installstart 64位:"C:\Program Files (x86)\Cloudbility\YunAgent\wrapper\bin\AppCommand.bat" installstart 如果结果如下图所示,则表示行云管家Agent安装成功。

四、如何卸载Agent

Agent是纯绿色软件,卸载后不会在系统中留下任何垃圾或隐患,当您确认要卸载Agent时,请按以下步骤执行卸载操作:

4.1、在网页上删除Agent

在“主机”菜单页面,进入要卸载Agent的那台主机详情,在主机Agent这一项下点击卸载Agent;

4.2、执行卸载脚本

如果卸载后宿主机上的Agent并未完全卸载成功,您可以按照以下方式进行卸载:

a)Linux版本

进入Agent安装目录(默认是:cd /usr/local/YunAgent/bin),执行以下命令:

./uninstallYunAgent.sh

b)Windows版本

进入Agent安装目录(默认是:C:\Program Files (x86)\Cloudbility\YunAgent\bin),双击执行以下脚本:

uninstallYunAgent.bat

五、行云管家Agent安装常见错误处理

如果您在Agent安装过程中出现失败的情况,您可以查看Agent的FAQ指引尝试自助处理;