ueransim/CLI_HANDOVER_SOLUTION.md

UERANSIM CLI Handover 解决方案

问题解决

错误: ERROR: No node found with name: 127.0.0.1

原因: UERANSIM CLI 不使用IP地址连接，而是使用节点名称。

正确的CLI使用方法

1. 查看所有可用节点

cd /home/uenr-3.2.7/ueransim
./build/nr-cli --dump

输出示例：

UERANSIM-gnb-286-1-1
imsi-286010000000001
imsi-286010000000002
imsi-286010000000003
imsi-286010000000004
imsi-286010000000005

2. 连接到gNB节点

# 错误的方法 (不要使用IP地址)
./build/nr-cli 127.0.0.1 -e help  # ❌ 这会失败

# 正确的方法 (使用节点名称)
./build/nr-cli UERANSIM-gnb-286-1-1 -e commands  # ✅ 正确

3. 查看可用命令

./build/nr-cli UERANSIM-gnb-286-1-1 -e commands

输出：

info       | Show some information about the gNB
status     | Show some status information about the gNB
amf-list   | List all AMFs associated with the gNB
amf-info   | Show some status information about the given AMF
ue-list    | List all UEs associated with the gNB
ue-count   | Print the total number of UEs connected the this gNB
ue-release | Request a UE context release for the given UE
handover   | Trigger handover for a UE to target gNB

4. 使用Handover命令

查看handover语法：

./build/nr-cli UERANSIM-gnb-286-1-1 -e "handover"

输出：

Trigger handover for a UE to target gNB 
Usage:
  handover <ue-id> <target-gnb-id>

实际触发handover：

# 语法: handover <UE-ID> <目标gNB-ID>
./build/nr-cli UERANSIM-gnb-286-1-1 -e "handover 1 2"

完整的测试流程

步骤1: 启动环境

确保gNB和UE都在运行：

# 终端1: 启动gNB
./build/nr-gnb -c config/custom-gnb.yaml

# 终端2: 启动UE  
./build/nr-ue -c config/custom-ue.yaml

步骤2: 检查连接状态

# 查看gNB信息
./build/nr-cli UERANSIM-gnb-286-1-1 -e "info"

# 查看连接的UE数量
./build/nr-cli UERANSIM-gnb-286-1-1 -e "ue-count"

# 列出连接的UE
./build/nr-cli UERANSIM-gnb-286-1-1 -e "ue-list"

步骤3: 触发Handover

# 格式: handover <ue-id> <target-gnb-id>
./build/nr-cli UERANSIM-gnb-286-1-1 -e "handover 1 2"

重要说明

1. 节点发现机制: UERANSIM使用进程表 /tmp/UERANSIM.proc-table/ 来发现节点，不直接使用IP地址
2. 节点名称: 必须使用确切的节点名称，如 UERANSIM-gnb-286-1-1
3. UE状态: UE必须处于已注册并连接到gNB的状态才能执行handover
4. 目标gNB: 需要有另一个运行的gNB作为handover目标

常用命令参考

# 列出所有节点
./build/nr-cli --dump

# 连接到gNB查看命令
./build/nr-cli UERANSIM-gnb-286-1-1 -e commands

# 查看gNB信息
./build/nr-cli UERANSIM-gnb-286-1-1 -e info

# 查看UE列表
./build/nr-cli UERANSIM-gnb-286-1-1 -e ue-list

# 触发handover
./build/nr-cli UERANSIM-gnb-286-1-1 -e "handover <ue-id> <target-gnb-id>"

# 查看UE状态
./build/nr-cli imsi-286010000000001 -e status