管理和配置

本节介绍管理和配置 Oracle AI Database 环境的基本任务。它包括用于安装或更新 dbaastools RPM 的 dbaascli admin updateStack 等命令，以及用于检查特定作业状态的 dbaascli job getStatus。

dbaascli 管理员 updateStack
dbaascli 作业 getStatus
dbaascli 系统 scalecpu
dbaascli diag 收集
dbaascli diag healthCheck
dbaascli 系统 getDBHomes
dbaascli 系统 getGridHomes

dbaascli 管理员 updateStack

要安装或更新 dbaastools RPM，请使用 dbaascli admin updateStack 命令。

先决条件：

以 root 用户身份运行该命令。

要使用该实用程序，您必须连接到 Oracle Base Database Cloud@Customer 虚拟机。

请参见 Connecting to a Virtual Machine with SSH 。

语法：

dbaascli admin updateStack
[--resume]
[--prechecksOnly]
[--nodes]

参数：

参数	说明
`--resume`	恢复上一个执行
`--prechecksOnly`	仅运行此操作的预检查
`--nodes`	指定要安装 RPM 的节点的逗号分隔列表。如果不传递此参数，则会在所有群集节点上安装 RPM

常见问题解答：

问：dbaascli admin updateStack 命令用于什么？

答案：dbaascli admin updateStack 命令用于在 Oracle Base Database Cloud@Customer 上安装或更新 dbaastools RPM。

问：使用 dbaascli admin updateStack 命令有哪些先决条件？

答：您必须以 root 用户身份运行该命令并连接到 Oracle Base Database Cloud@Customer 虚拟机。

Q：使用– resume 选项可以做什么？

答：如果 updateStack 命令被中断或不完整，则 --resume 选项将恢复先前执行的命令。

问：– prechecksOnly 选项的用途是什么？

答：--prechecksOnly 选项仅运行操作的预检查，而不实际执行安装或更新。

Q：如何使用– nodes 参数？

答：--nodes 参数指定应在其中安装 RPM 的节点的逗号分隔列表。如果未提供，则 RPM 将安装在所有群集节点上。

问：如果 dbaascli admin updateStack 命令出现问题，我该怎么办？

答：请确保您以 root 用户身份运行该命令，并且已连接到 Oracle Base Database Cloud@Customer 虚拟机。检查是否有任何特定的错误消息，如果需要，请查阅命令文档或 Oracle 支持。

问：如何连接到 Oracle Base Database Cloud@Customer 虚拟机以使用 dbaascli admin updateStack 命令？

答：您需要使用 SSH 连接到虚拟机。有关详细说明，请参阅文档中有关 Connecting to a Virtual Machine with SSH 的部分。

示例：

示例：在所有节点上安装或更新 dbaastools RPM

dbaascli admin updateStack

在 Oracle Base Database Cloud@Customer 环境的所有节点上安装或更新 dbaastools RPM。

示例：仅在安装或更新 RPM 之前运行预检查

dbaascli admin updateStack --prechecksOnly

仅为 dbaastools RPM 更新运行预检查，而不实际执行安装。它确保在继续更新之前满足所有先决条件。

示例：恢复以前中断的 updateStack 操作

dbaascli admin updateStack --resume

恢复之前中断或未成功完成的 dbaastools RPM 更新操作。

示例：在特定节点上安装或更新 dbaastools

dbaascli admin updateStack --nodes node1,node2

仅在指定的节点 node1 和 node2 上安装或更新 dbaastools RPM，而不会影响群集中的其他节点。

示例：在特定节点上恢复 updateStack 进程

dbaascli admin updateStack --resume --nodes node3,node4

仅当上一个执行中断时，才在特定节点 node3 和 node4 上恢复 dbaastools 的更新进程。

dbaascli 作业 getStatus

要查看指定作业的状态，请使用 dbaascli job getStatus 命令。

先决条件：

以 root 用户身份运行该命令。

要使用该实用程序，您必须连接到 Oracle Base Database Cloud@Customer 虚拟机。

请参见 Connecting to a Virtual Machine with SSH 。

语法：

dbaascli job getStatus --jobID

参数：

参数	说明
`--jobID`	指定作业 ID

常见问题解答：

问：dbaascli job getStatus 命令用于什么？

答：dbaascli job getStatus 命令用于查看状态

示例：

示例：使用作业 ID 检查特定作业的状态

dbaascli job getStatus --jobID 12345

使用 ID 12345 检查作业的状态。输出将显示作业的当前状态（例如，处理中、已完成或失败）。

示例：使用作业 ID 检查打补丁作业的状态

dbaascli job getStatus --jobID 98765

检索 ID 为 98765 的打补丁作业的状态，以查看补丁程序是已成功应用还是仍在运行。

示例：检查数据库备份作业的状态

dbaascli job getStatus --jobID 45678

检查 ID 为 45678 的数据库备份作业的状态。输出将提供有关备份进度或完成的详细信息。

示例：检查长时间运行的作业进度

dbaascli job getStatus --jobID 23456

检查长时间运行的作业 (ID 23456 ) 的进度，以查看该作业是否仍在执行或已完成。

示例：查看数据库创建作业的状态

dbaascli job getStatus --jobID 67890

检查由作业 ID 67890 标识的数据库创建作业的状态。

CPU 缩放：

了解如何根据工作负载要求查看和调整 VM 集群中的 CPU 资源。

dbaascli 系统 scalecpu

当控制层服务器与 OCI 区域之间的网络连接中断时，要向上或向下扩展 VM 集群中虚拟机的 CPU 核心计数，请使用 dbaascli cpuscale update 命令。

语法：

dbaascli system scaleCPU
        {
            --coreCount <value> [--message <value>]
            | --status
        }

参数：

参数	说明
`--coreCount`	将集群中每个 VM 的 CPU 核心计数更新为指定值。
`--message`	（可选）为当前缩放操作指定文本消息。
`--status`	显示从当前 VM 请求的最新 CPU 核心计数更新的详细信息。

常见问题解答：

问：dbaascli system scaleCPU 命令用于什么？

答：dbaascli 系统 scaleCPU 命令用于增加或减少 VM 集群中每个 VM 的 CPU 核心计数。

问：– coreCount 选项指定了什么？

答：--coreCount 选项指定 VM 集群中每个 VM 的 CPU 核心的目标数量。

问：我是否可以包括 CPU 缩放操作的消息？

回答：是。使用可选的 --message 选项为当前缩放操作指定文本消息。

问：如何检查 CPU 缩放操作的状态？

答：使用 --status 选项可显示从当前 VM 请求的最新 CPU 核心计数更新的详细信息。

问：我可以一起使用 --coreCount 和 --status 吗？

A：没有。使用可选的 --message 或 --status 指定 --coreCount。

示例：

示例：扩展 CPU 核心

要将 VM 集群中每个 VM 的 CPU 核心计数增加到 20：

dbaascli system scaleCPU --coreCount 20

该命令请求将 VM 集群中每个 VM 的 CPU 核心计数更新为 20。

示例：缩减 CPU 核心

要将 VM 集群中每个 VM 的 CPU 核心计数减少到 8：

dbaascli system scaleCPU --coreCount 8

该命令请求将 VM 集群中每个 VM 的 CPU 核心计数更新为 8。

示例：使用消息缩放 CPU 核心

要将 CPU 核心计数更新为 20 并包括一条消息：

dbaascli system scaleCPU --coreCount 20 --message "Scaling up for increased demand"

该命令请求 CPU 核心计数更新，并将指定的消息与缩放操作关联。

示例：检查 CPU 缩放操作的状态

要查看最新的 CPU 核心计数更新的详细信息，请执行以下操作：

dbaascli system scaleCPU --status

该命令显示从当前 VM 请求的最新 CPU 核心计数更新的详细信息。

示例：在请求 CPU 缩放后检查状态

请求 CPU 核心计数更新后，可以通过运行以下命令检查操作的状态：

dbaascli system scaleCPU --status

这允许您验证最新的 CPU 缩放请求的详细信息。

诊断和运行状况检查：

本节介绍在 Oracle AI Database 环境中维护运行状况和诊断问题的工具。dbaascli diag collect 等命令用于收集诊断数据，而 dbaascli diag healthCheck 允许您运行健康检查来确定潜在问题。这些工具通过主动监控和解决问题来帮助确保系统的稳定性和性能。

dbaascli diag 收集

要收集诊断信息，请使用 dbaascli diag collect 命令。

先决条件：

以 root 用户身份运行该命令。

语法：

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]

参数：

参数	说明
`--components`	指定用于日志收集的组件列表。有效值：`db`、`gi`、`os`、`dbaastools`、`all`。
`--startTime`	指定日志收集的开始时间。有效日期和时间格式：`YYYY-MM-DDTHH24:MM:SS`
`--endTime`	指定日志收集的结束时间。有效日期和时间格式：`YYYY-MM-DDTHH24:MM:SS`
`--nodes`	指定要收集日志的节点的逗号分隔列表
`--dbNames`	指定要为其收集日志的数据库名称。只能指定一个数据库名称。
`--objectStoreBucketURI`	指定用于上载收集日志的对象存储服务预先验证的请求 (PAR) URL。从来宾 VM 收集日志。有关更多信息，请参阅使用预先验证的请求。
`--destLocation`	指定来宾 VM 上用于收集日志的位置。默认值：`/var/opt/oracle/dbaas_acfs`
`--waitForCompletion`	有效值：`true` 或 `false`。默认值为 `true`。指定要在后台运行的 `false`。

常见问题解答：

问：dbaascli diag collect 命令的目的是什么？

答案：dbaascli diag collect 命令用于收集 Oracle AI Database 和关联组件（例如 OS、网格基础结构 (GI) 和 DBaaS 工具）的诊断日志。

问题：如何指定要收集诊断的组件？

答：您可以使用 --components 选项指定组件。有效值如下：

db（用于数据库日志）
gi（对于网格基础结构日志）
os（适用于操作系统日志）
dbaastools（对于 DBaaS 工具日志）
all（用于收集所有组件的日志）

问：如何收集特定时间范围的日志？

答：使用以下选项指定时间范围：

--startTime <value> 用于设置日志收集的开始时间。
--endTime <value> 用于设置日志收集的结束时间。

时间必须采用以下格式：YYYY-MM-DDTHH24:MM:SS。

问：开始和结束时间应采用什么格式？

答案：--startTime 和 --endTime 的格式均应为 YYYY-MM-DDTHH24:MM:SS。例如，2024-09-01T15:30:00 。

问：如何指定要从哪些节点收集诊断信息？

答：可以使用 --nodes 选项指定以逗号分隔的节点列表。例如：

--nodes node1,node2

问：如何收集特定数据库的日志？

答：使用 --dbNames 选项指定要为其收集日志的数据库的名称。一次只能指定一个数据库名称。

Q：如何在对象存储中存储收集的日志？

答：使用 --objectStoreBucketUri 选项为要上载日志的对象存储桶指定预先验证的请求 (PAR) URL。

问：我是否可以将日志收集到本地目录而不是对象存储？

答：是的，可以使用 --destLocation 选项指定来宾 VM 上将收集日志的目录。默认位置为 /var/opt/oracle/dbaas_acfs。

问：如果不为日志指定目标，会发生什么情况？

答：如果未指定目标，则收集的日志将存储在来宾 VM 上的默认位置 /var/opt/oracle/dbaas_acfs 中。

问：– waitForCompletion 选项的作用是什么？

答：--waitForCompletion 选项指定在将控制权返回给用户之前是否等待命令完成。默认值为 true。如果指定 false，该操作将在后台运行。

Q：如何在后台运行日志收集？

答：将 --waitForCompletion 选项设置为 false 以在后台运行日志收集进程：

dbaascli diag collect --waitForCompletion false

Q：是否可以使用此命令恢复以前的日志收集会话？

答案：否，dbaascli diag collect 命令不支持恢复以前的会话。您将需要启动新的日志收集过程。

问：如何确保日志直接上载到对象存储？

答案：您可以提供有效的 --objectStoreBucketUri（对象存储预先验证的请求 URL），日志将在收集后上载。

问：我是否可以一次收集多个数据库的日志？

答：否。一次只能使用 --dbNames 选项指定一个数据库名称。

问：如果要收集所有组件的所有可用日志，我该怎么办？

答：使用 --components all 可从所有组件收集日志，包括数据库、网格基础结构、操作系统和 DBaaS 工具。

问：从特定时间范围内收集数据库组件的日志的示例命令是什么？

A：下面是一个示例命令：

dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl

问：什么是用于收集日志并将其上载到对象存储的示例命令？

A：下面是一个示例命令：

dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

问：如果未指定– components 选项，缺省行为是什么？

答：如果不指定 --components 选项，该命令可能不知道要收集哪些日志，并且可能会失败。建议始终指定要从中收集日志的组件。

问：我是否可以在同一命令中同时指定– objectStoreBucketUri 和– destLocation 选项？

答：否。您必须通过 --objectStoreBucketUri 选择一个目标对象存储，或者通过 --destLocation 选择一个本地目录。

问：如果使用 dbaascli diag collect 命令时遇到错误，我该怎么办？

答：重复检查您是否提供了有效的组件名称、日期/时间格式和目标选项。另外，请确保以 root 用户身份运行该命令。

dbaascli diag healthCheck

要运行诊断运行状况检查，请使用 dbaascli diag healthCheck 命令。

先决条件：

以 root 用户身份运行该命令。

语法：

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]

参数：

参数	说明
`--destLocation`	指定来宾 VM 上用于收集日志的位置。默认值：`/var/opt/oracle/dbaas_acfs`
`--nodes`	指定要收集日志的节点的逗号分隔列表
`--objectStoreBucketURI`	指定用于上载收集日志的对象存储服务预先验证的请求 (PAR) URL。从来宾 VM 收集日志。有关更多信息，请参阅使用预先验证的请求。

常见问题解答：

问：dbaascli diag healthCheck 命令的用途是什么？

答案：dbaascli diag healthCheck 命令用于对在 Oracle Base Database Cloud@Customer 环境中运行的 Oracle AI Database 执行诊断健康检查。

问：使用 dbaascli diag healthCheck 命令有哪些先决条件？

答：该命令必须以 root 用户身份运行，并且您必须连接到 Oracle Base Database Cloud@Customer 虚拟机。

Q：如何指定用于收集日志的定制目录？

答：使用 --destLocation 选项指定将收集运行状况检查日志的目录。默认位置为 /var/opt/oracle/dbaas_acfs。

问：如果不指定– destLocation，日志收集的默认位置是什么？

答：日志收集的缺省目录为 /var/opt/oracle/dbaas_acfs。

问：我是否可以指定运行健康检查的节点？

答：是的，可以使用 --nodes 选项指定应运行运行状况检查的节点的逗号分隔列表。

问：如何将运行状况检查日志上载到对象存储？

答：使用 --objectStoreBucketURI 选项可从对象存储服务提供预先验证的请求 (PAR) URL。这会将收集的日志上载到指定的存储桶。

问：我可以从多个节点收集日志吗？

答：是的，可以使用 --nodes 选项以逗号分隔的格式指定多个节点。例如：--nodes node1,node2。

问：在特定节点上运行运行运行状况检查的示例命令是什么？

答：下面是用于在特定节点上运行运行状况检查的示例命令：

dbaascli diag healthCheck --nodes node1

问：如何将日志存储在对象存储中，而不是存储在本地计算机上？

答：您可以使用 --objectStoreBucketURI 选项提供预先验证身份的请求 (PAR) URL，以将日志存储在对象存储中。

问：我是否可以同时指定– destLocation 和– objectStoreBucketURI？

答：是的，可以为本地存储指定 --destLocation，也可以指定 --objectStoreBucketURI 将日志上载到对象存储。

问：如果在运行 dbaascli diag healthCheck 命令时遇到错误，应怎么办？

答：确保以 root 用户身份运行该命令，并为 --destLocation、--nodes 或 --objectStoreBucketURI 提供有效的选项。验证节点名称是否有效（如果已指定）。

问：我可以在后台运行健康检查吗？

答：dbaascli diag healthCheck 命令没有显式背景模式，但可以通过在命令末尾附加 & 来在后台运行它。

问：如果不提供– nodes 选项，会发生什么情况？

答：如果未提供 --nodes 选项，则缺省情况下将在群集中的所有节点上执行运行状况检查。

Q：是否可以使用此命令恢复以前的健康检查会话？

答案：否，dbaascli diag healthCheck 命令不支持恢复以前的会话。每次都必须启动新的运行状况检查。

问题：运行运行状况检查并将日志上载到对象存储的示例命令是什么？

A：下面是一个示例命令：

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

问：如果不指定– destLocation 或– objectStoreBucketURI，则缺省行为是什么？

答：如果未指定 --destLocation 或 --objectStoreBucketURI，则将在本地计算机上的缺省目录 /var/opt/oracle/dbaas_acfs 中收集运行状况检查日志。

问：我是否可以将健康检查限制为特定组件或日志？

答案：否，dbaascli diag healthCheck 命令不允许您指定单个组件或日志。它对系统执行一般诊断运行状况检查。

问：在运行 dbaascli diag healthCheck 命令之前，我应验证什么？

答：确保已连接到 Oracle Base Database Cloud@Customer 虚拟机，并以 root 用户身份运行该命令。

系统管理：

本节重点介绍如何监视和管理系统中的 Oracle 主目录。它包括 dbaascli system getDBHomes 等命令，用于查看有关所有 Oracle AI Database 主目录的详细信息，以及列出所有网格基础结构主目录的详细信息的 dbaascli system getGridHomes。这些命令为维护和排除整个系统环境提供了基本信息。

dbaascli 系统 getDBHomes

要查看所有 Oracle 主目录的信息，请使用 dbaascli system getDBHomes 命令。

先决条件：

以 root 或 oracle 用户身份运行该命令。

语法：

dbaascli system getDBHomes

常见问题解答：

问：dbaascli system getDBHomes 命令用于什么？

答案：dbaascli system getDBHomes 命令用于查看有关系统上所有 Oracle 主目录的信息。

问：哪个用户应执行 dbaascli system getDBHomes 命令？

答：该命令应以 root 或 oracle 用户身份执行。

问：dbaascli 系统 getDBHomes 命令是否有任何参数？

答案：否，dbaascli system getDBHomes 命令没有任何参数。

问：dbaascli system getDBHomes 命令提供哪些类型的信息？

答：该命令提供有关系统上所有 Oracle 主目录的详细信息，包括其路径和其他相关信息。

问：如何解释 dbaascli 系统 getDBHomes 命令的输出？

答：输出将列出所有 Oracle 主目录，其中包含诸如每个 Oracle 主目录的位置等信息。此信息有助于管理和配置 Oracle 环境。

问：如果 dbaascli 系统 getDBHomes 命令未返回任何输出，应执行什么操作？

答：确保以 root 或 oracle 用户身份运行该命令，并验证系统上是否正确安装了 Oracle 主目录。您可能还需要检查系统权限和配置。

问：如果我在执行 dbaascli 系统 getDBHomes 命令时收到错误消息，该怎么办？

答：有关特定详细信息，请查看错误消息，确认您具有相应的权限，并确保正确安装和配置了 dbaascli 工具。

问：我是否可以在非 Oracle 系统上运行 dbaascli 系统 getDBHomes？

答案：否。dbaascli system getDBHomes 命令特定于 Oracle 系统，需要安装 Oracle 软件。

示例：dbaascli 系统 getDBHomes

dbaascli system getDBHomes

dbaascli 系统 getGridHomes

要列出所有网格主目录的详细信息，请使用 dbaascli system getGridHomes 命令。

先决条件：

以 root 或 oracle 用户身份运行该命令。

语法：

dbaascli system getGridHomes

常见问题解答：

问：dbaascli system getGridHomes 命令用于什么？

答：dbaascli system getGridHomes 命令用于列出系统上所有网格主目录的详细信息。

问：哪个用户应执行 dbaascli system getGridHomes 命令？

答：该命令应以 root 或 oracle 用户身份执行。

问：dbaascli 系统 getGridHomes 命令是否有任何参数？

答案：否，dbaascli system getGridHomes 命令没有任何参数。

问：dbaascli system getGridHomes 命令提供哪些类型的信息？

答：该命令提供有关系统上所有网格主目录的详细信息，包括其位置和其他相关信息。

问：如何解释 dbaascli 系统 getGridHomes 命令的输出？

答：输出将列出所有网格主目录及其路径和配置等信息。这有助于管理和配置 Oracle Grid 基础结构。

问：如果 dbaascli 系统 getGridHomes 命令未返回任何输出，应执行什么操作？

答：确保以 root 或 oracle 用户身份运行该命令，并验证系统上是否正确安装了 Oracle Grid 主目录。如果需要，请检查系统权限和配置。

问：如果我在执行 dbaascli 系统 getGridHomes 命令时收到错误消息，该怎么办？

答：有关特定详细信息，请查看错误消息，确保您具有相应的权限，并验证是否正确安装和配置了 dbaascli 工具。

问：是否可以在没有 Oracle Grid Infrastructure 的系统上运行 dbaascli 系统 getGridHomes？

答案：否。dbaascli system getGridHomes 命令特定于安装了 Oracle Grid Infrastructure 的系统。如果没有网格主目录，该命令可能不会返回任何结果。