IP修改工具操作说明书.pdf

### IP修改工具操作指南 #### 1. 概述 **1.1 软件功能** 本IP修改工具主要用于海康平台服务器IP地址变更后的系统调整。当核心服务所在服务器的IP地址发生变化时，必须使用该工具来更新配置文件、缓存信息以及数据库中的相关IP信息。如果不进行这些必要的修改，系统将无法正常运行。具体来说，该工具能够实现以下功能： - 修改核心服务配置文件中的IP信息； - 更新核心服务数据库内的IP记录； - 清除Redis缓存中的旧IP信息； - 更改Nginx.conf文件中的IP地址配置； - 更新集群（Cluster）配置文件中的IP设置； - 修改Agent配置文件中的IP参数； - 替换组件配置文件config.properties里的IP条目； - 更新组件私有配置文件中的IP信息； - 调整组件数据库内的IP记录。 **1.2 特殊说明** **1.2.1 特殊场景一** 若需要交换两台服务器的IP地址，不能简单地在`ip.xml`文件中直接进行配置，因为这样会导致所有IP都变成同一地址。正确的做法是通过中间IP进行过渡。例如，假设服务器A的IP为`ip1`，服务器B的IP为`ip2`，目标是让A使用`ip2`而B使用`ip1`。操作步骤如下： 1. 将`ip1`更改为`ip3`； 2. 将`ip2`更改为`ip1`； 3. 最后将`ip3`更改为`ip2`。 **1.2.2 特殊场景二** 对于服务器B的IP字段包含服务器A的IP的情况，如服务器A的IP地址为`1.1.1.1`，服务器B的IP地址为`1.1.1.11`。如果要将A的IP变更为`1.1.1.2`，B的IP变更为`1.1.1.12`，则需要注意以下事项： - 在`ip.xml`文件中设置新IP时，确保新IP`ipD`不包含旧IP`ipA`。 - 在`ip.xml`文件中，先写入`ipB->ipD`，然后再写入`ipA->ipC`。 #### 2. 操作说明 **2.1 注意事项** - 在服务器IP更改后，应等待至少15分钟再运行IP修改工具，以避免部分组件连接数据库失败的问题。 - 对于多机部署环境，应首先在中心节点运行该工具，并重启服务器，然后依次在其他非中心节点上执行相同的操作。 - 确保在看到“modifyend!pleaserestartcomputer!!!!”的提示之后再重启服务器。 **2.2 工具放置** - **Windows操作系统**：可以将`IP_Tool`放置在服务器上的任意位置。 - **Linux操作系统**：应将工具放置在与核心服务相同的磁盘分区下，通常是`/opt`目录下。 **2.3 修改IP** - **配置**：在`ip.xml`文件中输入需要替换的IP信息。其中`old`代表原IP地址，`new`代表新IP地址。对于分布式部署场景，所有涉及IP变更的服务器都需要执行此工具，并且每个服务器上的`ip.xml`文件内容保持一致。 - **执行**：首先在核心服务所在的服务器上执行该工具，然后重启服务器；对于其他服务器，则重复上述步骤。在Windows操作系统下，需以管理员身份运行`IP_Tool.exe`程序；在Linux环境下，需要使用`root`用户权限，进入`IP_Tool`路径并通过命令`chmod -R 777 .`设置文件夹权限后执行`IP_Tool`文件。 - **日志查看**：在工具执行完毕后，可以在当前文件夹下的`ip.log`文件中查看日志信息，确认操作是否成功。如果遇到错误级别日志，需要检查是否对系统功能造成影响。 **2.4 结果** - 核心服务配置文件、数据库及Redis缓存中的IP信息均被更新至新地址。 - Nginx.conf文件、集群配置文件、Agent配置文件以及组件配置文件中的IP信息被正确替换。 - 组件数据库内的IP记录得到同步更新。 #### 3. 附录 **3.1 工具执行完后注意事项** - 设置完成后，需要确保所有涉及的服务都已经重启。 - 验证系统各项功能是否正常运行，包括但不限于视频监控、报警通知等。 - 如果系统出现异常，需要根据日志信息排查原因，必要时可回滚操作或联系技术支持寻求帮助。 通过上述详细介绍，用户可以全面了解海康IP修改工具的功能及其使用方法，以便在实际操作过程中能够准确无误地完成IP地址变更任务，确保系统的稳定运行。