#更换服务器IP

在线重部署是一个可计划的事项，应与其所依赖的前置操作（例如服务器IP变更）一起规划和执行，在此期间数据库服务虽未停止运行，但不应该进行任何业务操作。

YashanDB提供yasboot工具和一系列命令选项，便于在必要时快速调用对数据库执行在线重部署操作，该操作仅适用于单机部署。

本文主要介绍当一个单机部署的数据库集群中，一台或多台服务器的IP发生变更时，管理员如何通过yasboot ipchange命令进行数据库层面的IP更换操作，最终使得数据库恢复可用。

下述操作将以一主两备环境中的两台服务器IP发生变更为例进行描述：

服务器名称	旧IP	角色	新IP
服务器1	192.168.1.2	主	192.168.1.5
服务器2	192.168.1.3	备	192.168.1.6
服务器3	192.168.1.4	备	192.168.1.4

IP更换执行的顺序为yasom > yasagent > host，若无需更新某个工具/服务器的IP可跳过，继续更新下一个工具/服务器的IP，但不能乱序操作。

# 前提条件

执行下述操作前，请确保新IP的环境仍满足YashanDB的各项部署要求，具体请查阅安装前准备。

# 步骤1：进入YashanDB产品安装目录

在线重部署需要在安装YashanDB时的安装目录下进行，以yashan用户登录服务器并进入install目录：

$ cd /home/yashan/install

# 步骤2：更换yasom IP

查看yasom服务所在服务器信息。

查看安装目录下的hosts.toml文件中的如下内容可以获取yasom服务所在服务器的相关信息：
```
[om]
  hostid = "host0001"
  [om.config]
    LISTEN_ADDR = "192.168.1.2:1675"
```
根据上述信息，yasom部署于hostid为host0001的服务器上，该服务器的IP为192.168.1.2，需要更换。

更换yasom服务的IP。

$ cd /home/yashan/install
$ yasboot ipchange yasom -t hosts.toml -n 192.168.1.5

更换完成后，yasom可以正常提供服务。

# 步骤3：更换yasagent IP

查看yasagent服务所在服务器信息。

查看安装目录下的hosts.toml文件中的如下内容可以获取yasagent服务所在服务器的相关信息：

[[host]]
  hostid = "host0001"
[host.yasagent]
    [host.yasagent.config]
      LISTEN_ADDR = "192.168.1.2:1676"

[[host]]
  hostid = "host0002"
[host.yasagent]
    [host.yasagent.config]
      LISTEN_ADDR = "192.168.1.3:1676"

[[host]]
  hostid = "host0003"
[host.yasagent]
    [host.yasagent.config]
      LISTEN_ADDR = "192.168.1.4:1676"

根据上述信息，hostid为host0001和host0002的服务器上的yasagent使用了旧IP（192.168.1.2和192.168.1.3），需要更换。hostid为host0003服务器上的yasagent无需更换IP，可以正常提供服务。

执行如下命令，依次更换host0001和host0002服务器上的yasagent的IP。

## 更换host0001服务器上的yasagent IP
$ yasboot ipchange yasagent -t hosts.toml -n 192.168.1.5 --host-id host0001

## 更换host0002服务器上的yasagent IP
$ yasboot ipchange yasagent -t hosts.toml -n 192.168.1.6 --host-id host0002

更换完成后，所有yasagent可以正常提供服务。

# 步骤4：更换yasdb IP

更换yasdb IP包括对yasdb进程的数据库监听地址和主备复制链路地址的更换，yasdb进程所在的服务器信息与上述yasagent服务所在服务器信息一致。

Note:

更换yasdb IP时，所有yasdb进程将被停止，数据库服务关闭。

## 更换host0001服务器上的yasdb IP
$ yasboot ipchange host -t hosts.toml -l 192.168.1.5 -r 192.168.1.5 --host-id host0001

## 更换host0002服务器上的yasdb IP
$ yasboot ipchange host -t hosts.toml -l 192.168.1.6 -r 192.168.1.6 --host-id host0002

# 步骤5：启动数据库

执行如下命令启动数据库服务：

$ yasboot cluster start -c yashandb

# 步骤6：检查IP更换结果

执行如下命令查询数据库集群的各项信息，校验IP是否已更换：

$ yasboot cluster status -c yashandb -d

 hostid   | node_type | nodeid | pid    | instance_status | database_status | database_role | listen_address   | data_path
-----------------------------------------------------------------------------------------------------------------------------------
 host0001 | db        | 1-1:1  | 114864 | open            | normal          | standby       | 192.168.1.5:1688 | /data/yashan/yasdb_data/db-1-1
----------+-----------+--------+--------+-----------------+-----------------+---------------+------------------+--------------------
 host0002 | db        | 1-2:2  | 114862 | open            | normal          | standby       | 192.168.1.6:1688 | /data/yashan/yasdb_data/db-1-2
----------+-----------+--------+--------+-----------------+-----------------+---------------+------------------+--------------------
 host0003 | db        | 1-3:3  | 6921   | open            | normal          | primary       | 192.168.1.4:1688 | /data/yashan/yasdb_data/db-1-3
----------+-----------+--------+--------+-----------------+-----------------+---------------+------------------+--------------------