Juniper NETWORKS Bng Cups 智能会话负载平衡
瞻博网络公司
1133创新方式
加利福尼亚州桑尼维尔 94089
美国 408-745-2000
www.juniper.net
Juniper Networks、Juniper Networks 徽标、Juniper 和 Junos 是 Juniper Networks, Inc. 在美国和其他国家/地区的注册商标。所有其他商标、服务标记、注册商标或注册服务
商标归其各自所有者所有。Juniper Networks 对本文档中的任何错误不承担任何责任。Juniper Networks 保留更改、修改、转让或以其他方式修订本出版物的权利，恕不另行通知。
Juniper BNG CUPS 安装指南
版权所有 © 2024 瞻博网络公司。保留所有权利。 本文档中的信息截至扉页上的日期均为最新信息。
2000 年通知
瞻博网络硬件和软件产品符合 2000 年标准。 到 2038 年，Junos OS 没有已知的时间相关限制。但是，众所周知，NTP 应用程序在 2036 年会遇到一些困难。
最终用户许可协议
本技术文档所涉及的 Juniper Networks 产品由 Juniper Networks 软件组成（或旨在与 Juniper Networks 软件配合使用）。此类软件的使用须遵守最终用户许可的条款和条件。
协议（“EULA”）发布于 https://support.juniper.net/support/eula/. 下载、安装或使用此类软件，即表示您同意该 EULA 的条款和条件。
关于本指南
使用本指南规划、安装、升级和迁移到 Juniper BNG CUPS 软件。完成安装后，请参阅 Juniper BNG CUPS 用户指南以进行进一步的软件配置。
Juniper BNG CUPS 安装
安装 Juniper BNG CUPS 2
如何使用 Juniper BNG CUPS 控制器实用程序命令 | 10
安装 Juniper BNG CUPS
概括
本节介绍 Juniper BNG CUPS 的安装过程和系统要求。
在这个部分
开始之前 | 2
安装 Juniper BNG CUPS 控制器 | 3
启动 BNG CUPS 控制器 | 8
安装 BNG 用户平面 | 10
Juniper BNG CUPS 将 Junos OS 中运行的宽带网络网关 (BNG) 功能分解为单独的控制平面和用户平面组件。控制平面是在 Kubernetes 环境中运行的云原生应用程序。用户平面组件继续在专用硬件平台上的 Junos OS 上运行。
本指南中的安装说明适用于 Juniper BNG CUPS 解决方案的分解控制平面组件。在 Juniper BNG CUPS 解决方案中，控制平面称为 Juniper BNG CUPS 控制器（BNG CUPS 控制器）。BNG CUPS 控制器组件需要多节点 Kubernetes 集群。
开始之前
在开始安装和运行 BNG CUPS 控制器之前，请确保您具有以下条件：
- 具有下载 Juniper BNG CUPS 软件包权限的 juniper.net 用户帐户。
- 运行 junos-bng-cups-controller 安装需要运行 Ubuntu 22.04 LTS（或更高版本）的 Linux 主机（跳转主机）。跳转主机必须分配以下资源：
- CPU 核心-2
- 内存：8 GB
- 磁盘空间 — 128 GB 可用磁盘存储空间
- 集群必须至少有三个工作节点（虚拟机或物理机）。节点是运行 Ubuntu 22.04 LTS（或更高版本）的 Linux 系统，具有管理地址和域名。
节点必须满足以下系统要求：
- CPU 核心-8（最好使用超线程）
- 内存：64 GB
- 磁盘空间-根分区中有 512 GB 的可用磁盘存储空间
我们建议您对磁盘存储进行相应的分区：
- 128 GB 用于操作系统的根 (/) 分区
- 128 GB 到 /var/lib/docker 作为 Docker 缓存
- 256 GB 到 /mnt/longhorn 用于存储应用程序数据。这是默认位置，您可以在配置期间指定其他位置。
- 所有集群节点都必须具有具有 sudo 访问权限的用户帐户。
- 您必须具有从跳转主机到所有节点的根级 SSH 访问权限，使用基于密钥的身份验证。
- 要使用 Juniper BNG CUPS，您必须购买 Juniper BNG CUPS 控制器（控制平面）和与 Juniper BNG CUPS 控制器关联的 Juniper BNG 用户平面（用户平面）的许可证。
- 有关如何购买软件许可证的信息，请联系瞻博网络销售代表 https://www.juniper.net/in/en/contact-us/.
- 您在 Juniper BNG CUPS 环境中使用的 MX 系列设备也需要单独的许可证。有关如何购买硬件的信息，请联系您的 Juniper Networks 销售代表 https://www.juniper.net/in/en/contact-us/.
安装 Juniper BNG CUPS 控制器
概括
使用此过程安装 Juniper BNG CUPS 控制器。
开始之前，请确认您已满足 BNG CUPS 控制器安装的要求。
笔记： 有关安装 BBE Cloudsetup 设施和构建 Kubernetes 集群的说明，请参阅 BBE Cloudsetup 安装指南。使用 dong setup [–bbecloudsetup] 安装和构建集群。如果您使用 bbecloudsetup 选项，则所有默认值均与 BBE Cloudsetup 一致。如果您不使用带有设置的 bbecloudsetup 选项，则在启动 BNG CUPS 控制器安装时需要以下信息：
- Kubernetes 注册表位置
- 注册表名称
- 注册端口
- Syslog 服务器/BBE 事件收集和可视化地址以及 syslog 服务器端口
安装 BNG CUPS 控制器应用程序
- 从瞻博网络软件下载页面下载Juniper BNG CUPS软件包，并保存到跳转主机。
- BNG CUPS 控制器以压缩 tarball 映像 (.tgz) 形式提供。 file名称中包含发行号作为名称的一部分。
发行号的格式为：.nzb.s 例如ample，软件版本号 23.41.5 映射到以下格式：
- Ms 是产品的主要发布版本号（例如amp乐，23）。
- 是产品的次要版本号（例如amp乐，4）。
- Zis 软件版本的类型（例如ample，R 代表 FRS 或维护版本）。|
- 产品的版本号（例如ample, 1，表示 FRS 版本，而不是维护版本）。
- Sis 产品的旋转数（例如amp乐，5）。
解压 BNG CUPS 控制器 tarball (.tgz) file 在跳转主机上输入：
- $ tar zxvf junos-bng-cups-controller- 图像-stamp-m.nZb.s.tgz dong/load.json
- dbng/dong/settings.py
- dbng/charts/bng_controller/模板/_installation.tpl
- dong/图片/junos-cong-docker-amd64.tgz
- 东/东/东
- dbng/图像/junos-cscache-docker-amd64.tgz
- dbng/dbng_loader
- dbng/dbng/DbngValidator.py
- dbng/charts/bng_controller/模板/_metadata.tpl
- dong/charts/bng_controller/.helmignore
- dbng/charts/bng_controller/模板/_svcs.tpl
- dbng/charts/bng_controller/模板/cfgmap.yaml
- dong/charts/bng_controller/values.yaml
- dbng/charts/cpi/模板/服务调试.yaml
- dbng/charts/cpi/模板/_label.tpl
- dbng/charts/cpi/模板/_affinity.tpl
- dbng/charts/cpi/.helmignore
- dbng/charts/cpi/containers.yaml
- dong/charts/cpi/questions.yaml
- dong/charts/cpi/模板/hooks/validator.yaml
- dbng/charts/cpi/模板/cfgmap.yaml
- dbng/charts/cpi/模板/pvc.yaml
- dbng/charts/cpi/模板/pod.yaml
- dbng/charts/cpi/模板/service.yaml
- dbng/charts/cpi/values.yaml
- dbng/charts/scache/模板/service-debug.yaml
- dong/charts/scache/模板/hooks/validator.yaml
- dbng/charts/scache/模板/_affinity.tpl
- dbng/图表/scache/.helmignore
- dong/charts/scache/containers.yaml
- dbng/charts/scache/questions.yaml
- dbng/charts/scache/模板/pvc.yaml
- dbng/charts/scache/模板/pod.yaml
- dbng/charts/scache/模板/服务内部.yaml
- dong/charts/scache/values.yaml
- dbng/dong/Dockerfile.validator
- dbng/dbng/JnprBbeUtilityBase.tgz
- dong/charts/bng_controller/Chart.yaml
- dong/charts/cpi/Chart.yaml
- dbng/charts/scache/Chart.yaml
解压 tarball 后运行加载器脚本。
- $ sudo dbng/dbng_loader
- 创建 dbng 组…完成。
- 加载中 file完成了。
- 正在设置实用程序脚本…完成。
- 已成功加载：
使用 sudo -E dbng link –context context-name –version software-release 命令链接到集群。
链接命令将已加载的 BNG CUPS 控制器软件包关联到集群，以准备进行设置。
- $ sudo -E dong link –context 上下文名称 –version 软件发布
- 将 swwf-il-k46-s 链接到单人cp…完成。
- 链接完成，请运行 dbng 安装程序。
- 上下文 context-name - Kubernetes 上下文名称。
- 版本软件发布 - BNG CUPS 控制器软件版本，如 BNG 加载器输出所示。
如果您使用的是安全注册表（如在 BBE Cloudsetup 创建的集群上创建的），请通过以系统用户（BBE Cloudsetup 配置中提供的系统用户）的身份发出 docker login 来向注册表进行身份验证 file）到集群的注册传输地址（BBE Cloudsetup 配置中作为系统地址提供的 FQDN file).docker login -u ‹ 系统/用户> ：5000
密码
警告！ 您的密码将以未加密的形式存储在 /home/user/.docker/config.json 中。配置凭证助手以删除此警告。请参阅 https://docs.docker.com/engine/reference/commandline/login/#credentials-store
登录成功
运行 dong setup 来配置您的安装。
- $ sudo -E dong setup –context context-name –update [–bbecloudsetup] –ssh 主机：端口 [– secrets]
- context context-name-Kubernetes 上下文名称。
- 更新 - 仅在设置期间才会提示您输入缺失的值。
- bbecloudsetup-使用 BBE Cloudsetup 创建 Kubernetes 集群时使用的默认值。
- Ssh host:port-集群（集群的任何节点）的主机名或 IP 地址以及用于 SSH 访问 CLI 的开放端口。
安装命令执行以下操作。
- 收集有关集群环境的信息，例如；存储类或持久卷的名称、容器注册表的位置、注册表的容器/pod 名称、任何 TLS 密钥信息等等。
- 初始化 BNG CUPS 控制器配置。
- 如果您没有在安装命令中使用 bbecloudsetup 选项，则需要在安装过程中完成以下提示：
- Docker 注册地址和端口号
- CPi 配置存储类名称和大小
- CPi Core 存储类名称和大小
- Scache 核心存储大小
- $ sudo -E dong setup –context context-name –update –ssh host:port [–secrets]
- 验证注册表…完成。
通过运行 dbng version 命令来验证 BNG CUPS 控制器安装。
- $ dong 版本 –context 上下文名称 –detail
- BNG 控制器（单 cp）版本：
- 微服务发布
- dbng：
- 缓存：
- BNG 控制器 (单 cp) 可用版本：
- 上下文：swpf-il-k46-s
- 成分：dong
- 缓存 cpi
- 上下文：组件：dbng 缓存 cpi
- context context-name-Kubernetes 上下文名称。
- 详细信息 — 显示所有可用的软件版本。
- $ dong 版本 –context 上下文名称 –detail
- BNG 控制器（单 cp）版本：
- 微服务发布
- dbng：
- 缓存：
- BNG 控制器 (单 cp) 可用版本：
- 上下文：swpf-il-k46-s
- 成分：dong
- 缓存 cpi
- 上下文：组件：dbng scache cpi
- context context-name-Kubernetes 上下文名称。
- 详细信息 — 显示所有可用的软件版本。
概括
使用此过程配置并启动 BNG CUPS 控制器。
- 输入 rollout 开始 BNG CUPS 控制器安装。BNG CUPS 控制器实用程序允许您为 BNG CUPS 控制器的所有微服务推出不同的软件版本。您需要以 root 身份使用带有 sudo 的 rollout 命令。
- rollout 命令还会验证新版本所需的所有值是否存在，并将新版本的容器镜像加载到注册表中。使用 sudo -E dong rollout –context context-name –version software-release – service service- name 启动 BNG CUPS 控制器服务。
例如ample
- $ sudo -E dong rollout –context 上下文名称
- 将容器镜像加载到注册表…
- 加载中将图像缓存到本地缓存...完成。
- 推动将图像缓存到注册表…完成。
- 将容器镜像加载到注册表。
- 推出 BNG 控制器（单 cp）…完成。• 上下文名称 - Kubernetes 上下文。
- 服务 service-name-要推出的微服务名称（例如ample、scache 和 cpi-)。
- 版本软件发布 - 要推出的软件版本（默认为链接到集群的版本）。
笔记： 首次推出时不需要 –service。–service 与 –version 一起使用以推出（升级特定服务的特定版本）。
笔记： 默认情况下，BNG CUPS 控制器从出厂默认设置启动。配置将重置为其初始状态。所有持久状态和任何持久日志都将被清除。输入 dong status –detail –context context-name 以验证 BNG CUPS 控制器服务是否已启动并正在运行。
例如ample
$ dong 状态-详细信息-上下文上下文名称
微服务 POD 节点
- scache-pod-77d749dc6f -5h5f t
- k46-s.juniper.net
州政府重启正常运行
- 跑步0
- 0：03：41.887146 swwf-il-
- 保存方式：健康
笔记： 收集服务日志并联系瞻博网络技术支持
当发生下列任一情况时，中心（JTAC）：
- 该服务未运行。
- 与其他服务相比，该服务的正常运行时间表明它已重新启动。
您必须将控制平面实例 (CPi) 添加到 BNG CUPS 控制器。运行 CPi add 命令。
- $ sudo -E dong cpi add –context 上下文名称 –版本 发布号 cpi 标签
- 添加 CPI“cpi-example-1” 到图表…完成。
- 正在将容器镜像推送至注册表…
- 加载中消费物价指数ampl-1 图像到本地缓存...完成。
- 推动消费物价指数amp1-1 图像已注册…完成。完成。
- 推出新的 CPi…完成。
- 上下文 context-name-Kubernetes 上下文名称。输入上下文的名称。
- 版本软件发布-新 CPi pod 的软件发布。输入发布版本。
- Cpi-label—指定用于 CPi 命令的标签。
使用 dong status 命令验证 CPi 微服务是否正在运行。
- $ dbng ststus –detail –context 上下文名称
微服务 POD 状态节点
- 消费物价指数amp1-1 消费物价指数amp1-1-pod-84cd94f6c5-wkp85 Running o
- k46-s.juniper.net
重新启动正常运行时间
- 0:00:19.887097 swwf-il-k46-s.juniper.netscache
- k46-s.juniper.net
- scache-pod-77d749dc6f – 5h5f t
- 跑步0
- 0:03:41. 887146 swwf-il-
- 保存方式：健康
- context context-name-Kubernetes 上下文名称。
- detail—显示详细信息。
安装 BNG 用户平面
作为 Juniper BNG CUPS 的一部分使用的 BNG 用户平面是您在网络中安装的 MX 系列路由器。BNG 用户平面（MX 系列路由器）运行 Junos OS。如果您需要安装 BNG 用户平面，请参阅以下内容：Junos® OS 软件安装和升级指南。如何使用 Juniper BNG CUPS 控制器实用程序命令
如何使用 Juniper BNG CUPS 控制器
实用命令
概括
安装 Juniper BNG CUPS 控制器（BNG CUPS 控制器）后，您可以执行许多管理功能。
在这个部分
- 访问 Juniper BNG CUPS 控制器实用程序
命令 11 - 启动或停止 BNG CUPS 控制器
服务 | 18 - 检查 BNG CUPS 控制器的状态
服务 | 18 - Juniper BNG CUPS 日志记录 | 19
卸载并删除 BNG CUPS - 控制器 | 20
如何访问 BNG CUPS 控制器
配置和操作
命令 | 20
访问 Juniper BNG CUPS 控制器实用程序命令
您可以使用 BNG CUPS 控制器实用程序脚本 (dong) 来管理应用程序并访问用于配置操作的 CLI。BNG CUPS 控制器安装将实用程序脚本放在 /usr/local/bin 中。
dong 实用程序脚本执行管理 BNG CUPS 所需的任务，但掩盖了 kubectl 命令的复杂性。这种对 kubectl 命令的掩盖简化了您的管理职责。
dong 实用程序脚本使用 Kubernetes kubectl 实用程序命令执行以下操作：
- 创建和删除对象。
- 与 Pod 容器进行交互式会话。
- 显示 BNG CUPS 控制器对象的状态。
第 1 页的表 11 列出了可以使用 dong 实用程序脚本调用的命令，并描述了每个命令启动的操作。
表 1： BNG CUPS 控制器实用程序脚本命令
要显示可用命令的列表及其简要说明，请使用 h 或 help 选项：
- $ dong-h
- $ dbng –help
显示特定命令的选项：
- $ dong 命令名称 -h
启动或停止 BNG CUPS 控制器服务
使用 dong 实用程序脚本启动或停止所有 BNG CUPS 控制器服务。
- 要启动所有 BNG CUPS 控制器服务：
- $ sudo -E dong rollout –context 上下文名称
- 要停止所有 BNG CUPS 控制器服务：
- $ sudo -E dbng stop –context 上下文名称
检查 BNG CUPS 控制器服务的状态
使用 dbng status 实用程序脚本检查第 2 页表 19 中列出的每个 BNG CUPS 控制器服务（功能组件）的状态。状态显示服务是否正在运行、已退出或尚未启动。它还会在 Kubernetes pod 上显示服务名称。您可以比较服务的正常运行时间，以快速查看是否有任何服务已重新启动。
表 2： 使用 Status 命令显示的服务
要检查控制器服务的状态，请显示服务状态：
- $ dbng 状态
例如amp乐：
用户@主机$ dbng 状态 –detail –context 上下文名称
微服务 POD 状态节点
- 缓存
- scache-pod-7f646d56dc-w88sg Running 0
- example-1.juniper.net
重新启动正常运行时间
- 0:00:38.959603
- example-1.juniper.net
- Juniper BNG CUPS 日志记录
- Juniper BNG CUPS 使用宽带边缘 (BBE) 事件收集和可视化应用程序进行日志记录。
BBE 事件收集和可视化收集系统日志事件并将其记录在时间序列数据库中。你可以 view 通过 BBE 事件集合和可视化仪表板记录的事件。 BBE 事件收集和可视化仪表板是一个基于 GUI 的可视化工具，使您能够 view 根据定义的过滤器记录事件，这些过滤器可以在特定时间范围内。仪表板还提供强大的搜索和可视化工具，您可以通过这些工具关联来自多个来源的记录事件。要安装 BBE 事件收集和可视化，请参阅 Broadband Edge 事件收集和可视化安装指南。
卸载并删除 BNG CUPS 控制器
使用 dong 实用程序脚本卸载 BNG CUPS 控制器配置。unlink 命令将恢复您在设置 BNG CUPS 控制器时执行的操作。此脚本将 BNG CUPS 控制器恢复到您安装应用程序后但在进行任何设置配置之前的状态。
卸载 BNG CUPS 控制器
- 1. 在安装 BNG CUPS 控制器的跳转主机上，运行停止命令。
$ sudo -E dong stop –context 上下文名称
2. 运行取消链接命令。
$ sudo -E dong unlink –context 上下文名称
3. 运行清理命令。
$ sudo -E dong clean –卸载
如何访问 BNG CUPS 控制器配置和操作
- 命令
在这个部分
- 访问 BNG CUPS 控制器 CLI | 20
- 访问和使用 CLI 配置语句 | 21
- 访问和使用 CLI 操作命令 | 22
- 访问 BNG CUPS 控制器 CLI
您可以使用 BNG CUPS 控制器命令行界面 (CLI) 配置 BNG CUPS 控制器并监控其操作。本节介绍如何访问 CLI。
要访问 BNG CUPS 控制器 CLI 提示符
- 输入以下 dong 实用程序脚本命令。$ dong cli root@host>
- 输入问号可查看可用的顶级 CLI 命令。此命令会生成 Junos OS 顶级命令的子集。
适用于 BNG CUPS 控制器的 CLI 是 Junos OS CLI 的一个子集。对于view 有关 Junos OS CLI 基础知识，请参阅第一天：探索 Junos CLI。有关更多详细信息，请参阅 CLI 用户指南。
访问和使用 CLI 配置语句
您可以使用配置语句来配置、设置、管理和监控 BNG CUPS 控制器属性。
要配置 BNG CUPS 控制器组件：
- 使用 BNG CUPS 控制器实用程序命令 dong cli 访问顶级 CLI 提示符。
- 进入配置模式以配置 BNG CUPS 控制器以及 BNG CUPS 控制器用于配置托管路由器的信息。
- root@用户> 配置
- root@用户#
- 输入 CLI 语句来配置 Juniper BNG CUPS 组件（BNG CUPS 控制器和 BNG 用户平面）。
- 保存并激活配置。仅当不存在配置语法错误时，此命令才会成功。
- root@用户#提交
- 提交完成
- （可选）退出配置模式并返回顶级 CLI 提示符。root@user# exit root@user>
- 有关受支持的配置语句的列表，请参阅 Juniper BNG CUPS CLI 配置语句。
访问和使用 CLI 操作命令
您可以使用操作命令来显示 Juniper BNG CUPS 的当前状态。您可以输入操作命令来监控和排除 BNG CUPS 控制器和 BNG 用户平面的故障。
要监控 BNG CUPS 控制器， view BNG CUPS 控制器配置和统计，或者手动运行某些操作：
- 使用 BNG CUPS 控制器实用程序命令 dong cli 访问顶级 CLI 提示符。$ dong cli root@host
- 输入具体命令。
- 使用show命令显示统计信息。
- 使用请求命令手动启动某些 BNG CUPS 控制器操作。
有关支持的操作命令的列表，请参阅 Juniper BNG CUPS 操作命令。
文件/资源
 |
Juniper NETWORKS Bng Cups 智能会话负载平衡 [pdf] 安装指南 Bng Cups 智能会话负载平衡，智能会话负载平衡，会话负载平衡，负载平衡，平衡 |