如何使用瞻博网络 BNG CUPS 控制器实用程序和 CLI 命令|BNG CUPS 22.1 |瞻博网络

访问瞻博网络 BNG CUPS 控制器实用程序命令

总结安装瞻博网络 BNG CUPS 控制器（BNG CUPS 控制器）后，可执行多种管理功能。

使用 BNG CUPS 控制器实用程序脚本（dbng）来管理应用程序并访问用于配置操作的 CLI。BNG CUPS 控制器安装将实用程序脚本放在 /usr/local/bin 中。

实用程序 dbng 脚本执行管理 BNG CUPS 所需的任务，但掩盖了命令的复杂性 kubectl 。这种对命令的 kubectl 掩饰简化了您的管理职责。

实用程序 dbng 脚本使用 Kubernetes kubectl 实用程序命令请执行以下操作：

创建和删除对象。
提供日志访问。
使用 Pod 容器进行交互式会话。
显示 BNG CUPS 控制器对象的状态。

表 1 列出了可使用实用程序脚本调用的 dbng 命令，并介绍了每个命令启动的操作。

表 1：BNG CUPS 控制器实用脚本命令
命令名称	行动
`cli`	允许您访问可用于配置 BNG CUPS 控制器功能的 CLI。
`ip`	显示访问 BNG CUPS 控制器所需的 IP 地址。
`logs`	显示 BNG CUPS 控制器日志。
`restart`	重新启动特定的 BNG CUPS 控制器服务。此命令提供以下选项： cp — BNG CUPS 控制器实例服务 scache — 状态缓存服务
`setup`	在安装过程中设置 BNG CUPS 控制器应用程序。要运行此命令，您需要 sudo root 权限。
`shell`	连接到 BNG CUPS 控制器 shell 提示符。
`start`	启动特定 BNG CUPS 控制器服务或所有 BNG CUPS 控制器服务。
`status`	显示 BNG CUPS 控制器服务的当前状态。
`stop`	停止所有 BNG CUPS 控制器服务。
`uninstall`	从本地系统中移除 BNG CUPS 控制器应用程序。要运行此命令，您需要 `sudo` root 权限。
`version`	显示已安装的 BNG CUPS 控制器应用程序的版本号。

使用以下常规语法发出命令：

您可以选择一个简短的选项：
长项选择：

要显示可用命令列表并简要说明，请使用 h 或 help 选项：

要显示特定命令的选项：

启动或停止 BNG CUPS 控制器服务

使用 dbng 实用程序脚本启动或停止所有 BNG CUPS 控制器服务。服务按依赖性顺序启动。基本服务（db 和 cmgd）先启动，然后是其他服务。服务会以相反的依赖顺序停止。

执行此命令以启动所有 BNG CUPS 控制器服务：
注意：
我们建议您使用 ––services 选项启动单个服务或一组服务，仅在瞻博网络支持代表的指导下进行故障排除。
执行此命令以停止所有 BNG CUPS 控制器服务：

检查 BNG CUPS 控制器服务的状态

dbng status使用实用程序脚本检查表 2 列出的每个 BNG CUPS 控制器服务（功能组件）的状态。状态显示服务是否正在运行、已退出或尚未启动。

表 2：使用 Status 命令显示的服务
服务	描述
Cp	BNG CUPS 控制器实例服务 — 实施订阅者管理控制平面，其中包括控制平面协议;认证、授权和计费（AAA）;以及支持基础架构
scache	状态缓存服务 — 为服务生成的订阅者服务状态提供群集上 `cp` 支持存储。如果服务重新启动 `cp` ，请使用此服务进行状态恢复。

要检查控制器服务的状态，请显示服务状态：

例如：

显示 BNG CUPS 控制器日志记录

使用 dbng logs 实用程序脚本显示 BNG CUPS 控制器运行时发生的不同事件的日志。

要显示 BNG CUPS 控制器日志，请执行此命令以报告所有服务的日志：

您可以使用标准 Ubuntu 约定将日志重定向到文件或终端和文件。有关更多信息，请参阅 Ubuntu 文档，但您可以使用以下示例作为起点：

仅将所有日志重定向到一个文件。
将所有日志重定向到屏幕和文件。

最佳实践：

选项 ––services 仅在瞻博网络支持代表的指导下进行故障排除。

您可以为日志指定以下任一严重级别，下面按严重程度增加顺序列出：

表 3：严重性级别
严重性级别	说明
`debug`	仅当您尝试诊断问题时，才会显示通常感兴趣的详细信息。这些日志通常非常频繁。
`info`	记录事件或感兴趣的非错误状况。此级别的日志可以确认一切按预期运行。这些日志通常不频繁。
`warning`	表示近期发生了意外情况或可能出现一些问题。后者的一个简单示例是磁盘空间不足警告，表示您可能很快就会用完磁盘空间。无论哪种情况，软件仍在按预期运行，但您可能需要进行更密切的监控。这些日志通常不频繁。
`error`	表示存在更严重的问题，导致软件无法执行某些功能。软件已尽可能平稳地处理了问题，以继续运行。
`critical`	有严重错误可能会阻止程序继续运行，会提醒您。

卸载和移除 BNG CUPS 控制器

使用 dbng 实用程序脚本卸载 BNG CUPS 控制器配置。命令 uninstall 将恢复在设置 BNG CUPS 控制器时执行的操作。此脚本将 BNG CUPS 控制器返回到安装应用程序后，但在执行任何设置配置之前处于的状态。

要卸载 BNG CUPS 控制器：

在 Kubernetes 群集的主节点上，运行uninstall命令。
卸载 BNG CUPS 控制器后，我们建议使用 Debian 卸载过程删除整个软件包，如下所示：
:

访问 BNG CUPS 控制器 CLI

您可以使用 BNG CUPS 控制器命令行界面（CLI）来配置 BNG CUPS 控制器并监控其操作。本节介绍如何访问 CLI。

要访问 BNG CUPS 控制器 CLI 提示符：

输入以下dbng实用程序脚本命令。

输入问号，查看可用的顶级 CLI 命令。此命令会生成 Junos OS 顶级命令的子集。

可用于 BNG CUPS 控制器的 CLI 是 Junos OS CLI 的子集。有关 Junos OS CLI 基础知识的概述，请参阅 Day One：探索 Junos CLI。有关详细信息，请参阅 CLI 用户指南。

访问和使用 CLI 配置语句

您可以使用配置语句来配置、设置、管理和监控 BNG CUPS 控制器属性。

要配置 BNG CUPS 控制器组件：

使用 BNG CUPS 控制器实用程序命令dbng cli访问顶级 CLI 提示符。
访问配置模式以配置 BNG CUPS 控制器以及 BNG CUPS 控制器用于配置托管路由器的信息。
输入 CLI 语句以配置瞻博网络 BNG CUPS 组件（BNG CUPS 控制器和 BNG 用户平面）。
保存并激活配置。只有在不存在配置语法错误时，此命令才会成功。
（可选）退出配置模式并返回顶级 CLI 提示符。
有关受支持的配置语句列表，请参阅瞻博网络 BNG CUPS CLI 配置语句。

访问和使用 CLI 操作命令

您可以使用操作命令显示瞻博网络 BNG CUPS 的当前状态。输入操作命令以监控 BNG CUPS 控制器和 BNG 用户平面并排除故障。

要监控 BNG CUPS 控制器、查看 BNG CUPS 控制器的配置和统计信息，或手动运行某些操作：

使用 BNG CUPS 控制器实用程序命令dbng cli访问顶级 CLI 提示符。
输入特定命令。
- 使用 show 命令显示统计信息。
- 使用 request 命令手动启动某些 BNG CUPS 控制器操作。
有关支持的操作命令列表，请参阅瞻博网络 BNG CUPS 操作命令。

本页内容

如何使用瞻博网络 BNG CUPS 控制器实用程序和 CLI 命令