# 自定义OS镜像自动接入采集管理器UniAgent
本文档介绍如何在Linux环境和Windows环境下，基于应用运维服务的采集管理器UniAgent进行镜像打包。您可以使用打包的镜像购买新的ECS主机，为该主机自动安装采集管理器UniAgent。
#### 镜像概述
镜像是一个包含了软件及必要配置的云服务器或裸金属服务器模板，包含操作系统或业务数据，还可以包含应用软件（例如，数据库软件）和私有软件。镜像分为公共镜像、私有镜像、共享镜像和市场镜像。
镜像服务（Image Management Service）提供简单方便的镜像自助管理功能。用户可以灵活便捷地使用公共镜像、私有镜像或共享镜像申请云服务器。同时，用户还能通过已有的云服务器或使用外部镜像文件创建私有镜像。
#### 打包方式说明
表1打包方式 
| 打包方式                                                    | 说明                                                                                                                                                                                                           |
|:---|:---|
| [在Linux环境打包镜像（方式一）] | 先安装好UniAgent客户端，删除相关配置文件，再打包私有镜像。                                                                                                                                                                            |
| [在Linux环境打包镜像（方式二）]  | 执行镜像内置脚本，再打包私有镜像。 **使用该方式前需要确保打包镜像的Linux机器不能安装UniAgent。如果Linux机器已经安装了UniAgent，需要先[卸载UniAgent](https://support.huaweicloud.com/usermanual-aom2/agent_01_0006.html#section2)。** |
| [在Windows环境打包镜像]    | 安装UniAgent客户端，再打包私有镜像。                                                                                                                                                                                       |
   
 #### 在Linux环境打包镜像（方式一）
1. 用户基于使用的镜像创建一个弹性云服务器，详细操作请参考[弹性云服务器入门](https://support.huaweicloud.com/qs-ecs/ecs_01_0103.html)。
2. 在该弹性云服务器上，根据[UniAgent安装指导](https://support.huaweicloud.com/usermanual-aom2/agent_01_0005.html)，使用手动安装或者远程安装的方式安装好UniAgent。(可在AOM的UniAgent管理页面查看UniAgent是否安装成功。)
3. 待确认UniAgent安装成功后，执行如下命令停止UniAgent，并删除相关配置文件： 
   ```
   service uniagentd stop && rm -f /etc/uniagentd/uniagentd.sn && rm -rf  /usr/local/uniagentd/log /usr/local/uniagentd/tmp /usr/local/uniagentd/libexec  /usr/local/uniagentd/conf/uniagentd.conf
   ```
   
   
4. 在目标ECS弹性云服务器的操作列单击"更多 \> 镜像 \> 创建镜像"去创建私有镜像，详细操作请参考[创建镜像](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0202.html)。
5. 根据用户的使用需要，配置镜像信息。
 
 #### 在Linux环境打包镜像（方式二）
1. 用户基于使用的镜像创建一个弹性云服务器，详细操作请参考[弹性云服务器入门](https://support.huaweicloud.com/qs-ecs/ecs_01_0103.html)。
2. 执行命令将install_uniagentd_OS.sh脚本下载到弹性云服务器上的/root目录下： 
   下载命令的拼接规则：wget https://aom-uniagent-{region_id}.{obs_domain}/install_uniagentd_OS.sh
   以华北-北京四区域为例：
   - {region_id}=cn-north-4
   
   - {obs_domain}=obs.cn-north-4.myhuaweicloud.com 下载命令如下：
     
   
   
   ```
   wget https://aom-uniagent-cn-north-4.obs.cn-north-4.myhuaweicloud.com/install_uniagentd_OS.sh
   ```
   
   
3. 执行以下命令，将install_uniagentd_OS.sh脚本设置成开机自启动： 
   ```
   bash /root/install_uniagentd_OS.sh config
   ```
   如果在/etc/init.d/目录下有AOMInstall开机启动脚本，即设置成功。
   
   
4. 执行以下命令，删除配置脚本。**执行完之后，即可制作镜像，制作私有镜像之前，Linux机器不能重启。**
   
   ```
   rm -f /root/install_uniagentd_OS.sh
   ```
   
   
5. 在目标ECS弹性云服务器的操作列单击"更多 \> 镜像 \> 创建镜像"去创建私有镜像，详细操作请参考[创建镜像](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0202.html)。
6. 根据用户的使用需要，配置镜像信息。
 
 #### 在Windows环境打包镜像
1. 用户基于使用的镜像创建一个弹性云服务器，详细操作请参考[自定义购买ECS](https://support.huaweicloud.com/usermanual-ecs/ecs_03_7002.html)。
2. 在该弹性云服务器上，根据[UniAgent安装指导](https://support.huaweicloud.com/usermanual-aom2/agent_01_0005.html)，下载Windows环境的安装包，解压安装包后，单击uniagentd.msi去安装UniAgent。（**安装完成后，不要执行start.bat脚本。**）
3. 在目标ECS弹性云服务器的操作列单击"更多 \> 镜像 \> 创建镜像"去创建私有镜像，详细操作请参考[创建镜像](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0202.html)。
4. 根据用户的使用需要，配置私有镜像信息。
 
#### 后续操作
私有镜像打包完成后，您可以使用打包的私有镜像购买新的ECS主机，就可以为该主机自动安装采集管理器UniAgent。详情请参见[通过私有镜像购买ECS](https://support.huaweicloud.com/usermanual-ecs/ecs_03_7003.html)。