DHCP功能操作指导手册.docx

1、DHCP功能操作指导手册DHCP功能操作指导手册和版本更新说明产品版本资料版本资料编号资料更新说明V16.18.221.0手册第一次发行V16.18.301.1增加2.5 动态路由配置，更新基站协商日志查询接口V16.18.41R711.2增加 2.8. 查询DHCP服务作者资料版本日期作者审核者批准者1.02018-06-29王友亮1.12018-09-03王友亮1.22018-12-13王友亮1. 概述为了支持SPU PNP开通功能，统一规划基站网元资源，5G网管UME提供DHCP服务。其经典的部署包括UME NET_NE直连基站交换机部署（如图1）和UME云部署（如图2），其中黄色服务的

2、为DHCP Service服务。在运行PNP开通功能时，4G/5G IPv4/IPv6基站网元DHCP客户端通过三层交换机中继与DHCP Service服务协商获取基站网元配置信息，进行前台建链，从SWR服务获取版本，进而完成PNP开站。其中，三层交换机DHCP Agent需要在SPU PNP开站前配置好DHCP中继。图 1 UME NET_NE直连基站交换机部署图2 UME云部署UME DHCP Service服务是比较底层的服务，为用户实现了必须的基本的最少功能集。这些功能包括DHCP资源配置、DHCP协商日志、DHCP协议和基础数据备份恢复。其中，DHCP资源配置和DHCP协商日志是RE

3、ST服务，SPU服务已经在该REST服务的基础上完成了用户操作更友好的资源配置和协商日志查询；DHCP协议是DHCP客户端和UME DHCP Service交互的规范标准，用户不需要关心，PNP开站时会自动触发；基础数据备份恢复，在ABR服务中可以手动触发配置数据、DHCP协商日志备份或者恢复，从而提高UME DHCP服务的高可用性。配置好DHCP中继是PNP开站、UME DHCP智能运维的前提条件，并且很多用户不熟悉DHCP中继配置，所以显得很重要。下面按照用户关注的重点从高到低依次对DHCP中继配置、DHCP资源配置、DHCP协商日志、基础数据备份恢复和DHCP协议进行阐述。2. DHCP

4、中继配置基站网元与UME DHCP服务通常位于不同网络，基站DHCP广播需要经过层三路由才能与UME DHCP服务交互，其组网方式包括广播到广播的大二层组网和广播到单播的DHCP中继组网，但是大二层组网会广播泛洪，影响网络性能，所以对于层三路由的DHCP服务推荐采用DHCP中继组网，基站广播通过基站侧VLAN子接口中继到位于不同VLAN的UME DHCP服务。大多数三层交换机都支持DHCP中继，本文以中兴5928E配置DHCPv4中继为例（中兴3252A不支持DHCP中继，中兴5928E、5950、5960等支持DHCP中继），交换机中继基站DHCP报文到UME，即，基站交换机和UME直接相连

5、（该种组网的静态路由配置在UME DHCP Service重启后需要重新配置静态路由，有一种可选解决方案是在UME和基站交换机间增加一台三层云交换机（如图2），该组网方案需要配置基站交换机到UME DHCP Service和三层云交换机到基站交换机的双向路由）。DHCP中继配置主要在基站侧交换机配置，为基站、服务端分配VLAN，为DHCP报文转发配置DHCP中继；另外，为了保证基站和服务端互通，还需要附加配置静态路由或者动态路由。下面以基站连端口11，VLAN ID为106；服务端连端口10，VLAN ID为100；UME DHCP Server和VLAN 100相连为例说明DHCP中继的配置

6、过程，其配置情况如下（对于不同交换机配置命令可能不一样，需要参考相关交换机的用户手册）。2.1. 基站VLAN配置ZXR10(config)#switchvlan-configurationZXR10(config-swvlan)#vlan 106ZXR10(config-swvlan-sub-106)#switchport pvid gei-0/1/1/11ZXR10(config-swvlan-sub-106)#exitZXR10(config-swvlan)#exitZXR10(config)#interface vlan106ZXR10(config-if-vlan106)#ip ad

7、dress 192.106.0.1 255.255.0.0ZXR10(config-if-vlan106)#no shutdownZXR10(config-if-vlan106)#exitZXR10(config)#2.2. DHCP Server VLAN配置ZXR10(config)#switchvlan-configurationZXR10(config-swvlan)#vlan 100ZXR10(config-swvlan-sub-100)#switchport pvid gei-0/1/1/10ZXR10(config-swvlan-sub-100)#exitZXR10(config

8、-swvlan)#exitZXR10(config)#interface vlan100ZXR10(config-if-vlan100)#ip address 192.169.10.1 255.255.0.0ZXR10(config-if-vlan100)#no shutdownZXR10(config-if-vlan100)#exit2.3. DHCP中继配置ZXR10(config)#ip dhcp relay server group 5ZXR10(config-dhcpr-server-group)#server 1 192.169.0.17 masterZXR10(config-dh

9、cpr-server-group)#exitZXR10(config)#dhcpZXR10(config-dhcp)#enableZXR10(config-dhcp)#interface vlan106ZXR10(config-dhcp-if-vlan106)#mode relayZXR10(config-dhcp-if-vlan106)#relay agent 192.106.0.1ZXR10(config-dhcp-if-vlan106)#relay server group 5ZXR10(config-dhcp-if-vlan106)#exitZXR10(config-dhcp)#exi

10、tZXR10(config)#2.4. 静态路由配置中兴交换机VLAN间不需要配置路由，相互间可以直接访问。但是UME DHCP Server不知道怎么到达VLAN106，所以，需要对该服务容器配置到达VLAN106的静态路由，其配置过程如下，所有命令如图3：图 3 容器路由配置1)查询DHCP服务的镜像UUID，如图4。图 4 查询DHCP容器镜像UUID2）查询DHCP K8S 运行结点，如图 5图 5 查询DHCP K8S 运行结点3）在DHCP部署的结点上通过下面的命令查询运行镜像的PID。docker inspect 27988abf40c56b3b3f88da118e4787413

11、5848bbb7e55af1df3ea04b6b09e2c25 | grep Pid4）运行下面的命令增加到vlan106 192.106.0.0/16的静态路由。nsenter -t 11489 -n route add -net 192.106.0.0/16 gw 192.169.10.15）运行下面的命令查看路由是否配置成功docker exec 2ad8593c566cf04344008ae4939f4648262da091d7e484718ed368af92dfe03a route -n2.5. 动态路由配置除了配置静态路由可以保证基站侧和UME DHCP Service互通，也可以

12、通过配置动态路由来实现，比如OSPF或者RIP协议等，请参考相关交换机用户手册。2.6. TRUNK配置在上面的基础上可以增加端口，配置其为TURNK模式，同时允许多个vlan的基站与DHCP Server相连，从而实现交换机堆叠，增加端口和VLAN的作用。比如：ZXR10(config-swvlan-if-gei-0/1/0/1)#switchport mode trunkZXR10(config-swvlan-if-gei-0/1/0/1)#switchport trunk native vlan 106ZXR10(config-swvlan-if-gei-0/1/0/1)#switchp

13、ort trunk vlan 100ZXR10(config-swvlan-if-gei-0/1/0/1)#switchport trunk vlan 1062.7. 确认服务端和基站端互通在交换机组网配置完成后，检查确保UME DHCP Service和基站侧互通：UME DHCP Service能ping通基站侧基站所在VLAN默认网关，基站侧能ping通UME DHCP Service（可以直接在基站侧交换机上发起ping命令），否则需要检查配置相关路由。2.8. 查询DHCP服务2.8.1. 查询DHCP服务IPUME网管组网分为直通组网和SLB组网，在直通组网条件下，基站DHCP中继

14、目的IP地址填DHCP服务net_ne网络平面IP；在SLB组网条件下，基站DHCP中继目的IP地址填UME网管业务IP。2.8.1.1. 直通组网DHCP中继目的IP查询输入 https:/umeserverip/portal/，打开UME PAAS，进入应用管理，如图2.8.1 UME网管应用管理，搜索dhcp找到dhcp应用，点击点击相继进入dhcp-dhcp-service服务详情和微服务详情，基本信息页net_ne网络平面对应的IPv4/IPv6值就是DHCPv4/DHCPv6的服务IP，即DHCP中继需要配置的目的IP，如图 2.8.2 DHCP服务微服务详情。图2.8.1 UME

15、网管应用管理图 2.8.2 DHCP服务微服务详情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.3 DHCP服务容器图 2.8.4 DHCPv4微服务2.8.3. PING基

16、站侧VLAN默认网关 在图2.8.3中，点击DHCP服务的打开终端，则可以在终端中ping基站的默认网关。3. DHCP资源配置配置数据REST服务可以通过网管操作，比较形象直观（请参考文档4G PNP 开通功能操作手册）；也可以通过REST接口操作，比较方便快捷。REST操作，首先需要通过msb查询dhcp-service服务，然后点击操作列图标（如图6红色矩形框标明的图标），在弹出的服务查看页面查看发布地址（如图7红色矩形框标明的地址），接着加上以下各小节接口的访问路径就可以实现DHCP配置数据的增删改查。图6 通过MSB查询dhcp-service微服务图7 查看微服务dhcp-serv

17、ice发布地址REST配置数据接口如下：CREATE TABLE dhcpres(neid character varying(49) NOT NULL,nealias character varying(100),ipaddress character varying(100),ipmask character varying(100),ipgateway character varying(100),omcip character varying(100),omcgateway character varying(100),omcvlanid smallint DEFAULT 1:smal

18、lint,lastmodifiedtime character varying(100),isassign smallint DEFAULT 0:smallint,subnetwork character varying(49) DEFAULT 0,ccslotno smallint DEFAULT 0,eid character varying(100),rowid bigserial NOT NULL,omcport character varying(6),CONSTRAINT dhcpres_pkey PRIMARY KEY (rowid),CONSTRAINT dhcpres_eid

19、_key UNIQUE (eid),CONSTRAINT dhcpres_subnetwork_neid_ccslotno_key UNIQUE (subnetwork, neid, ccslotno)备注：1.唯一约束：EID字段唯一，subnetwork, neid, ccslotno组合唯一;2.可更新字段：除了rowid、subnetwork, neid, ccslotno、isassign、lastmodifiedtime字段都可以按照subnetwork, neid, ccslotno做update更新.3.请求参数校验：1）ipaddress、ipmask、ipgateway、o

20、mcip和omcgateway必须是有效的IP地址；2）ccslotno是short类型；3）omcvlanid取值区间是1, 4094；4）eid长度不能超过40个字符3.1. 新增DHCP配置数据接口定义描述URI/dhcp/dhcpres操作类型POST正常响应码201方向DHCP UI - DHCP Service【Path参数】无【请求参数】信息元素必选实例个数数据类型描述MnKeyValuePair需要创建的DHCP配置数据，在4G中，subnetwork，neid，ccslotno不能为空；在5G中，neid不能为空例如：eId: 323334353637555,neId: 5,

21、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【响应参数】信息元素必选实例个数数据类型描述resultM1String成功0,失败1,部分成功2detailO1String操作失败原因例如：result: 0,detail: re

22、sult: 0,errMsg: ,eId: 323334353637555,subnetwork: 5,neId: 53.2. 删除DHCP数据接口定义描述URI/dhcp/dhcpres操作类型DELETE正常响应码204方向DHCP UI -DHCP Service【Path参数】无【请求参数】信息元素必选实例个数数据类型描述SUBNETWORKO1stringdhcp记录的子网号，5G情况下为0NEIDM1stringdhcp记录的网元号CCSLOTNOO1stringdhcp记录的CC槽位编号，5G情况下为0【响应参数】信息元素必选实例个数数据类型描述resultM1String成功0

23、,失败1,部分成功2detailO1String操作失败原因例如：请求URI：http:/host:18080/dhcp/dhcpres?subnetwork=5&neId=5&ccslotno=0请求结果：result: 0,errMsg: 3.3. 更新一条DHCP配置数据接口定义描述URI/dhcp/dhcpres操作类型PUT正常响应码201方向DHCP UI - DHCP Service方法根据子网、网元、槽位号更新DHCP数据【Path参数】无【请求参数】信息元素必选实例个数数据类型描述M1KeyValuePair需要更新的DHCP配置数据例如：eId: 3233343536376

24、66,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【响应参数】信息元素必选实例个数数据类型描述resultM1String成功0,失败1,记录不存在3errMsgO1String操作失败原因例如：result:

25、0,errMsg: 3.4. 核查所有DHCP配置数据接口定义描述URI/dhcp/dhcpres操作类型GET正常响应码200方向DHCP UI - DHCP Service【Path参数】无【请求参数】无【响应参数】信息元素必选实例个数数据类型描述dhcpresMnKeyValuePair所有DHCP数据errMsgO1String操作失败原因例如：result: eId: null,neId: 2,neAlias: null,ipAddress: null,ipMask: null,ipGateway: null,omcIp: null,omcPort: null,omcGateway:

26、 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,subn

27、etwork: 5,ccslotno: 5,errMsg: 3.5. 按EID核查所有DHCP配置数据接口定义描述URI/dhcp/dhcpres操作类型GET正常响应码200方向DHCP UI - DHCP Service【Path参数】eid【请求参数】无【响应参数】信息元素必选实例个数数据类型描述dhcpresMnKeyValuePair所有DHCP数据errMsgO1String操作失败原因例如：result: eId: 3233343536374444,neId: 4,neAlias: essss,ipAddress: 20.2.100.5,ipMask: 255.255.255.0

28、,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协商日志也可以通过网管操作核查，比较形象直观（请查看文档4G PNP 开通功能操作手册）；也可以通过REST接口操作核查，比较方便快捷，其REST发布地址与基站配置数据的REST发布地址一样，在发布地址后加上REST访问URI路径，然后就可以实现如下基站DHCP日志的核查操作。4.1. 按子网网元槽位号核查基站DHCP日志接口定义描述URIdhcp/log操作类型GET正常响应码200方向DHCP UI - DHCP Service【Path参数】无