DHCP功能操作指导手册.docx
《DHCP功能操作指导手册.docx》由会员分享，可在线阅读，更多相关《DHCP功能操作指导手册.docx（28页珍藏版）》请在冰豆网上搜索。
DHCP功能操作指导手册
DHCP功能操作指导手册
和
版本更新说明
产品版本
资料版本
资料编号
资料更新说明
V16.18.22
1.0
手册第一次发行
V16.18.30
1.1
增加2.5动态路由配置，更新基站协商日志查询接口
V16.18.41R71
1.2
增加2.8.查询DHCP服务
作者
资料版本
日期
作者
审核者
批准者
1.0
2018-06-29
王友亮
1.1
2018-09-03
王友亮
1.2
2018-12-13
王友亮
1.概述
为了支持SPUPNP开通功能，统一规划基站网元资源，5G网管UME提供DHCP服务。
其经典的部署包括UMENET_NE直连基站交换机部署（如图1）和UME云部署（如图2），其中黄色服务的为DHCPService服务。
在运行PNP开通功能时，4G/5GIPv4/IPv6基站网元DHCP客户端通过三层交换机中继与DHCPService服务协商获取基站网元配置信息，进行前台建链，从SWR服务获取版本，进而完成PNP开站。
其中，三层交换机DHCPAgent需要在SPUPNP开站前配置好DHCP中继。
图1UMENET_NE直连基站交换机部署
图2UME云部署
UMEDHCPService服务是比较底层的服务，为用户实现了必须的基本的最少功能集。
这些功能包括DHCP资源配置、DHCP协商日志、DHCP协议和基础数据备份恢复。
其中，DHCP资源配置和DHCP协商日志是REST服务，SPU服务已经在该REST服务的基础上完成了用户操作更友好的资源配置和协商日志查询；DHCP协议是DHCP客户端和UMEDHCPService交互的规范标准，用户不需要关心，PNP开站时会自动触发；基础数据备份恢复，在ABR服务中可以手动触发配置数据、DHCP协商日志备份或者恢复，从而提高UMEDHCP服务的高可用性。
配置好DHCP中继是PNP开站、UMEDHCP智能运维的前提条件，并且很多用户不熟悉DHCP中继配置，所以显得很重要。
下面按照用户关注的重点从高到低依次对DHCP中继配置、DHCP资源配置、DHCP协商日志、基础数据备份恢复和DHCP协议进行阐述。
2.DHCP中继配置
基站网元与UMEDHCP服务通常位于不同网络，基站DHCP广播需要经过层三路由才能与UMEDHCP服务交互，其组网方式包括广播到广播的大二层组网和广播到单播的DHCP中继组网，但是大二层组网会广播泛洪，影响网络性能，所以对于层三路由的DHCP服务推荐采用DHCP中继组网，基站广播通过基站侧VLAN子接口中继到位于不同VLAN的UMEDHCP服务。
大多数三层交换机都支持DHCP中继，本文以中兴5928E配置DHCPv4中继为例（中兴3252A不支持DHCP中继，中兴5928E、5950、5960等支持DHCP中继），交换机中继基站DHCP报文到UME，即，基站交换机和UME直接相连（该种组网的静态路由配置在UMEDHCPService重启后需要重新配置静态路由，有一种可选解决方案是在UME和基站交换机间增加一台三层云交换机（如图2），该组网方案需要配置基站交换机到UMEDHCPService和三层云交换机到基站交换机的双向路由）。
DHCP中继配置主要在基站侧交换机配置，为基站、服务端分配VLAN，为DHCP报文转发配置DHCP中继；另外，为了保证基站和服务端互通，还需要附加配置静态路由或者动态路由。
下面以基站连端口11，VLANID为106；服务端连端口10，VLANID为100；UMEDHCPServer和VLAN100相连为例说明DHCP中继的配置过程，其配置情况如下（对于不同交换机配置命令可能不一样，需要参考相关交换机的用户手册）。
2.1.基站VLAN配置
ZXR10（config）#switchvlan-configuration
ZXR10（config-swvlan）#vlan106
ZXR10（config-swvlan-sub-106）#switchportpvidgei-0/1/1/11
ZXR10（config-swvlan-sub-106）#exit
ZXR10（config-swvlan）#exit
ZXR10（config）#interfacevlan106
ZXR10（config-if-vlan106）#ipaddress192.106.0.1255.255.0.0
ZXR10（config-if-vlan106）#noshutdown
ZXR10（config-if-vlan106）#exit
ZXR10（config）#
2.2.DHCPServerVLAN配置
ZXR10（config）#switchvlan-configuration
ZXR10（config-swvlan）#vlan100
ZXR10（config-swvlan-sub-100）#switchportpvidgei-0/1/1/10
ZXR10（config-swvlan-sub-100）#exit
ZXR10（config-swvlan）#exit
ZXR10（config）#interfacevlan100
ZXR10（config-if-vlan100）#ipaddress192.169.10.1255.255.0.0
ZXR10（config-if-vlan100）#noshutdown
ZXR10（config-if-vlan100）#exit
2.3.DHCP中继配置
ZXR10（config）#ipdhcprelayservergroup5
ZXR10（config-dhcpr-server-group）#server1192.169.0.17master
ZXR10（config-dhcpr-server-group）#exit
ZXR10（config）#dhcp
ZXR10（config-dhcp）#enable
ZXR10（config-dhcp）#interfacevlan106
ZXR10（config-dhcp-if-vlan106）#moderelay
ZXR10（config-dhcp-if-vlan106）#relayagent192.106.0.1
ZXR10（config-dhcp-if-vlan106）#relayservergroup5
ZXR10（config-dhcp-if-vlan106）#exit
ZXR10（config-dhcp）#exit
ZXR10（config）#
2.4.静态路由配置
中兴交换机VLAN间不需要配置路由，相互间可以直接访问。
但是UMEDHCPServer不知道怎么到达VLAN106，所以，需要对该服务容器配置到达VLAN106的静态路由，其配置过程如下，所有命令如图3：
图3容器路由配置
1）查询DHCP服务的镜像UUID，如图4。
图4查询DHCP容器镜像UUID
2）查询DHCPK8S运行结点，如图5
图5查询DHCPK8S运行结点
3）在DHCP部署的结点上通过下面的命令查询运行镜像的PID。
dockerinspect27988abf40c56b3b3f88da118e47874135848bbb7e55af1df3ea04b6b09e2c25|grepPid
4）运行下面的命令增加到vlan106192.106.0.0/16的静态路由。
nsenter-t11489-nrouteadd-net192.106.0.0/16gw192.169.10.1
5）运行下面的命令查看路由是否配置成功
dockerexec2ad8593c566cf04344008ae4939f4648262da091d7e484718ed368af92dfe03aroute-n
2.5.动态路由配置
除了配置静态路由可以保证基站侧和UMEDHCPService互通，也可以通过配置动态路由来实现，比如OSPF或者RIP协议等，请参考相关交换机用户手册。
2.6.TRUNK配置
在上面的基础上可以增加端口，配置其为TURNK模式，同时允许多个vlan的基站与DHCPServer相连，从而实现交换机堆叠，增加端口和VLAN的作用。
比如：
ZXR10（config-swvlan-if-gei-0/1/0/1）#switchportmodetrunk
ZXR10（config-swvlan-if-gei-0/1/0/1）#switchporttrunknativevlan106
ZXR10（config-swvlan-if-gei-0/1/0/1）#switchporttrunkvlan100
ZXR10（config-swvlan-if-gei-0/1/0/1）#switchporttrunkvlan106
2.7.确认服务端和基站端互通
在交换机组网配置完成后，检查确保UMEDHCPService和基站侧互通：
UMEDHCPService能ping通基站侧基站所在VLAN默认网关，基站侧能ping通UMEDHCPService（可以直接在基站侧交换机上发起ping命令），否则需要检查配置相关路由。
2.8.查询DHCP服务
2.8.1.查询DHCP服务IP
UME网管组网分为直通组网和SLB组网，在直通组网条件下，基站DHCP中继目的IP地址填DHCP服务net_ne网络平面IP；在SLB组网条件下，基站DHCP中继目的IP地址填UME网管业务IP。
2.8.1.1.直通组网DHCP中继目的IP查询
输入https:
//umeserverip/portal/，打开UMEPAAS，进入应用管理，如图2.8.1UME网管应用管理，搜索dhcp找到dhcp应用，点击点击相继进入dhcp-dhcp-service服务详情和微服务详情，基本信息页net_ne网络平面对应的IPv4/IPv6值就是DHCPv4/DHCPv6的服务IP，即DHCP中继需要配置的目的IP，如图2.8.2DHCP服务微服务详情。
图2.8.1UME网管应用管理
图2.8.2DHCP服务微服务详情
2.8.1.2.SLB组网DHCP中继目的IP查询
在SLB组网条件下，DHCP中继目的IP填UME网管业务IP，UME网管业务IP查询请参考SLB组网相关文档。
2.8.2.查询DHCP服务日志
点击DHCP服务微服务详情中的容器标签页，切换到DHCP容器页，再点击dhcp-service，进入DHCPv4微服务dhcp-service-sl，如图2.8.4，点击日志，则可以查看该微服务的日志输出（如果点击dhcp-v6-sl则进入DHCPv6的微服务）。
图2.8.3DHCP服务容器
图2.8.4DHCPv4微服务
2.8.3.PING基站侧VLAN默认网关
在图2.8.3中，点击DHCP服务的打开终端，则可以在终端中ping基站的默认网关。
3.DHCP资源配置
配置数据REST服务可以通过网管操作，比较形象直观（请参考文档《4GPNP开通功能操作手册》）；也可以通过REST接口操作，比较方便快捷。
REST操作，首先需要通过msb查询dhcp-service服务，然后点击操作列图标（如图6红色矩形框标明的图标），在弹出的服务查看页面查看发布地址（如图7红色矩形框标明的地址），接着加上以下各小节接口的访问路径就可以实现DHCP配置数据的增删改查。
图6通过MSB查询dhcp-service微服务
图7查看微服务dhcp-service发布地址
REST配置数据接口如下：
CREATETABLEdhcpres
（
neidcharactervarying（49）NOTNULL,
nealiascharactervarying（100）,
ipaddresscharactervarying（100）,
ipmaskcharactervarying（100）,
ipgatewaycharactervarying（100）,
omcipcharactervarying（100）,
omcgatewaycharactervarying（100）,
omcvlanidsmallintDEFAULT1:
:
smallint,
lastmodifiedtimecharactervarying（100）,
isassignsmallintDEFAULT0:
:
smallint,
subnetworkcharactervarying（49）DEFAULT0,
ccslotnosmallintDEFAULT0,
eidcharactervarying（100）,
rowidbigserialNOTNULL,
omcportcharactervarying（6）,
CONSTRAINTdhcpres_pkeyPRIMARYKEY（rowid）,
CONSTRAINTdhcpres_eid_keyUNIQUE（eid）,
CONSTRAINTdhcpres_subnetwork_neid_ccslotno_keyUNIQUE（subnetwork,neid,ccslotno）
）
备注：
1.唯一约束：
EID字段唯一，subnetwork,neid,ccslotno组合唯一;
2.可更新字段：
除了rowid、subnetwork,neid,ccslotno、isassign、lastmodifiedtime字段都可以按照subnetwork,neid,ccslotno做update更新.
3.请求参数校验：
1）ipaddress、ipmask、ipgateway、omcip和omcgateway必须是有效的IP地址；2）ccslotno是short类型；3）omcvlanid取值区间是[1,4094]；4）eid长度不能超过40个字符
3.1.新增DHCP配置数据
接口定义
描述
URI
/dhcp/dhcpres
操作类型
POST
正常响应码
201
方向
DHCPUI->DHCPService
【Path参数】
无
【请求参数】
信息元素
必选
实例个数
数据类型
描述
M
n
KeyValuePair
需要创建的DHCP配置数据，
在4G中，subnetwork，neid，ccslotno不能为空；
在5G中，neid不能为空
例如：
[{
"eId":
"323334353637555",
"neId":
5,
"subnetwork":
5,
"ccslotno":
5,
"neAlias":
"essss",
"ipAddress":
"20.2.100.5",
"ipMask":
"255.255.255.0",
"ipGateway":
"255.255.255.0",
"omcIp":
"10.2.100.1",
"omcPort":
"1200",
"omcGateway":
"10.2.100.1",
"omcVlanId":
"1",
"lastmodifiedtime":
"",
"isAssign":
"0"
}]
【响应参数】
信息元素
必选
实例个数
数据类型
描述
result
M
1
String
成功0,失败1,部分成功2
detail
O
1
String
操作失败原因
例如：
{
"result":
"0",
"detail":
[
{
"result":
"0",
"errMsg":
"",
"eId":
"323334353637555",
"subnetwork":
5,
"neId":
5
}
]
}
3.2.删除DHCP数据
接口定义
描述
URI
/dhcp/dhcpres
操作类型
DELETE
正常响应码
204
方向
DHCPUI->DHCPService
【Path参数】
无
【请求参数】
信息元素
必选
实例个数
数据类型
描述
SUBNETWORK
O
1
string
dhcp记录的子网号，5G情况下为0
NEID
M
1
string
dhcp记录的网元号
CCSLOTNO
O
1
string
dhcp记录的CC槽位编号，5G情况下为0
【响应参数】
信息元素
必选
实例个数
数据类型
描述
result
M
1
String
成功0,失败1,部分成功2
detail
O
1
String
操作失败原因
例如：
请求URI：
http:
//host:
18080/dhcp/dhcpres?
subnetwork=5&neId=5&ccslotno=0
请求结果：
{
"result":
"0",
"errMsg":
""
}
3.3.更新一条DHCP配置数据
接口定义
描述
URI
/dhcp/dhcpres
操作类型
PUT
正常响应码
201
方向
DHCPUI->DHCPService
方法
根据子网、网元、槽位号更新DHCP数据
【Path参数】
无
【请求参数】
信息元素
必选
实例个数
数据类型
描述
M
1
KeyValuePair
需要更新的DHCP配置数据
例如：
{
"eId":
"323334353637666",
"neId":
5,
"subnetwork":
5,
"ccslotno":
5,
"neAlias":
"essss",
"ipAddress":
"20.2.100.5",
"ipMask":
"255.255.255.0",
"ipGateway":
"255.255.255.0",
"omcIp":
"10.2.100.1",
"omcPort":
"1200",
"omcGateway":
"10.2.100.1",
"omcVlanId":
"1",
"lastmodifiedtime":
"",
"isAssign":
"0"
}
【响应参数】
信息元素
必选
实例个数
数据类型
描述
result
M
1
String
成功0,失败1,记录不存在3
errMsg
O
1
String
操作失败原因
例如：
{
"result":
"0",
"errMsg":
""
}
3.4.核查所有DHCP配置数据
接口定义
描述
URI
/dhcp/dhcpres
操作类型
GET
正常响应码
200
方向
DHCPUI->DHCPService
【Path参数】
无
【请求参数】
无
【响应参数】
信息元素
必选
实例个数
数据类型
描述
dhcpres
M
n
KeyValuePair
所有DHCP数据
errMsg
O
1
String
操作失败原因
例如：
{
"result":
[
{
"eId":
"null",
"neId":
2,
"neAlias":
null,
"ipAddress":
null,
"ipMask":
null,
"ipGateway":
null,
"omcIp":
null,
"omcPort":
null,
"omcGateway":
null,
"omcVlanId":
1,
"lastmodifiedtime":
null,
"isAssign":
0,
"subnetwork":
2,
"ccslotno":
2
},
{
"eId":
"323334353637666",
"neId":
5,
"neAlias":
"essss",
"ipAddress":
"20.2.100.5",
"ipMask":
"255.255.255.0",
"ipGateway":
"255.255.255.0",
"omcIp":
"10.2.100.1",
"omcPort":
null,
"omcGateway":
"10.2.100.1",
"omcVlanId":
1,
"lastmodifiedtime":
null,
"isAssign":
0,
"subnetwork":
5,
"ccslotno":
5
}
],
"errMsg":
""
}
3.5.按EID核查所有DHCP配置数据
接口定义
描述
URI
/dhcp/dhcpres
操作类型
GET
正常响应码
200
方向
DHCPUI->DHCPService
【Path参数】
eid
【请求参数】
无
【响应参数】
信息元素
必选
实例个数
数据类型
描述
dhcpres
M
n
KeyValuePair
所有DHCP数据
errMsg
O
1
String
操作失败原因
例如：
{
"result":
[
{
"eId":
"3233343536374444",
"neId":
4,
"neAlias":
"essss",
"ipAddress":
"20.2.100.5",
"ipMask":
"255.255.255.0",
"ipGateway":
"255.255.255.0",
"omcIp":
"10.2.100.1",
"omcPort":
null,
"omcGateway":
"10.2.100.1",
"omcVlanId":
1,
"lastmodifiedtime":
null,
"isAssign":
0,
"subnetwork":
4,
"ccslotno":
4
}
],
"errMsg":
""
}
4.DHCP协商日志
与基站配置数据一样，基站DHCP协商日志也可以通过网管操作核查，比较形象直观（请查看文档《4GPNP开通功能操作手册》）；也可以通过REST接口操作核查，比较方便快捷，其REST发布地址与基站配置数据的REST发布地址一样，在发布地址后加上REST访问URI路径，然后就可以实现如下基站DHCP日志的核查操作。
4.1.按子网网元槽位号核查基站DHCP日志
接口定义
描述
URI
dhcp/log
操作类型
GET
正常响应码
200
方向
DHCPUI->DHCPService
【Path参数】
无
升级会员 