管理與配置

本節涵蓋管理和設定 Oracle AI Database 環境的重要任務。它包括安裝或更新 dbaastools RPM 的命令 (例如 dbaascli admin updateStack)，以及檢查特定工作狀態的 dbaascli job getStatus。

• dbaascli 管理 updateStack
• dbaascli 工作 getStatus
• dbaascli 系統頭皮
• dbaascli 診斷收集
• dbaascli healthCheck
• dbaascli 系統 getDBHomes
• dbaascli 系統 getGridHomes

dbaascli 管理 updateStack

若要安裝或更新 dbaastools RPM，請使用 dbaascli admin updateStack 命令。

先決條件：

以 root 使用者身分執行指令。

若要使用此公用程式，您必須連線至 Oracle Base Database Cloud@Customer 虛擬機器。

請參閱使用 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 虛擬機器。

問：– resume 選項有什麼作用？

答：如果 --resume 選項中斷或不完整，則會繼續上一次的 updateStack 命令執行。

問：– prechecksOnly 選項的目的為何？

A：--prechecksOnly 選項只會執行作業的前置檢查，不會實際執行安裝或更新。

問：如何使用 – nodes 參數？

A：--nodes 參數會指定應安裝 RPM 之節點的逗號分隔清單。若未提供，將會在所有叢集節點上安裝 RPM。

問：如果我遇到 dbaascli admin updateStack 命令的問題，該怎麼辦？

答：請確定您以 root 使用者身分執行命令，並且已連線到 Oracle Base Database Cloud@Customer 虛擬機器。檢查是否有任何特定錯誤訊息，並視需要參閱命令文件或 Oracle 客戶服務部。

問：如何連線至 Oracle Base Database Cloud@Customer 虛擬機器，以使用 dbaascli admin updateStack 命令？

答：您需要使用 SSH 連線到虛擬機器。如需詳細指示，請參閱文件中使用 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 虛擬機器。

請參閱使用 SSH 連線至虛擬機器。

語法：

dbaascli job getStatus --jobID

參數：

參數	描述
--jobID	指定工作 ID

常見問題：

問：dbaascli 工作 getStatus 命令的用途為何？

A：使用 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 系統頭皮

若要在「控制層伺服器」與 OCI 區域之間的網路連線中斷時，縱向擴展或縮減 VM 叢集中虛擬機器的 CPU 核心數目，請使用 dbaascli cpuscale update 命令。

語法：

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

參數：

參數	描述
--coreCount	將叢集中每個 VM 的 CPU 核心數目更新為指定的值。
--message	(選擇性) 指定目前縮放作業的文字訊息。
--status	顯示從目前 VM 要求的最新 CPU 核心數目更新詳細資訊。

常見問題：

問：dbaascli 系統 scaleCPU 命令的用途是什麼？

答：dbaascli 系統 scaleCPU 命令用於增加或減少 VM 叢集中每個 VM 的 CPU 核心數目。

問：– coreCount 選項指定什麼？

A：--coreCount 選項會指定 VM 叢集中每個 VM 的 CPU 核心目標數目。

問：我可以包含 CPU 調整作業的訊息嗎？

A：是。使用選擇性的 --message 選項，指定目前縮放作業的文字訊息。

問：如何檢查 CPU 調整作業的狀態？

A：使用 --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 診斷收集

若要收集診斷，請使用 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 收集命令的目的是什麼？

答：dbaascli diag collect 指令用於收集 Oracle AI Database 和相關元件 (如 OS、Grid Infrastructure (GI) 和 DBaaS 工具) 的診斷記錄。

問：如何指定要收集診斷的元件？

答：您可以使用 --components 選項來指定元件。有效值為：

• db (適用於資料庫日誌)
• gi (適用於 Grid Infrastructure 日誌)
• os (適用於作業系統日誌)
• dbaastools (適用於 DBaaS 工具日誌)
• all (用於收集所有元件的日誌)

問：如何收集特定時間範圍的日誌？

A：使用下列選項來指定時間範圍：

• --startTime <value>，設定日誌收集的開始時間。
• --endTime <value> 可設定日誌收集的結束時間。

時間的格式必須是：YYYY-MM-DDTHH24:MM:SS。

問：開始和結束時間的格式為何？

A：--startTime 和 --endTime 的格式應為 YYYY-MM-DDTHH24:MM:SS。例如，2024-09-01T15:30:00 。

問：如何指定要從哪個節點收集診斷？

A：您可以使用 --nodes 選項來指定以逗號分隔的節點清單。舉例而言：

--nodes node1,node2

問：如何收集特定資料庫的日誌？

A：使用 --dbNames 選項來指定要收集其日誌的資料庫名稱。一次只能指定一個資料庫名稱。

問：如何將收集的日誌儲存在 Object Storage 中？

答：使用 --objectStoreBucketUri 選項為將上傳日誌的物件儲存的儲存桶指定預先認證要求 (PAR) URL。

問：我可以收集記錄到本機目錄而不是 Object Storage 嗎？

答：是的，您可以使用 --destLocation 選項在來賓 VM 上指定要收集日誌的目錄。預設位置為 /var/opt/oracle/dbaas_acfs。

問：如果未指定日誌的目的地，會發生什麼情況？

A：如果未指定目的地，收集的日誌將會儲存在來賓 VM 上的預設位置 /var/opt/oracle/dbaas_acfs 中。

問：– waitForCompletion 選項有什麼作用？

A：--waitForCompletion 選項會指定是否要在將控制項傳回給使用者之前，先等待命令完成。預設值為 true。如果您指定 false，作業會在背景執行。

問：如何在背景執行日誌收集？

A：將 --waitForCompletion 選項設為 false，即可在背景執行日誌收集處理作業：

dbaascli diag collect --waitForCompletion false

問：我可以使用此命令恢復上一個日誌收集階段作業嗎？

答：否，dbaascli diag collect 指令不支援繼續前一個階段作業。您將需要啟動新的日誌收集處理作業。

問：如何確保日誌直接上傳到物件儲存？

答：您可以提供有效的 --objectStoreBucketUri (物件儲存預先認證要求 URL)，供收集後上傳日誌。

問：我可以一次收集多個資料庫的日誌嗎？

答：否，您一次只能使用 --dbNames 選項指定一個資料庫名稱。

問：如果我想收集所有元件的所有可用日誌，該怎麼辦？

答：使用 --components 全部收集所有元件的記錄，包括資料庫、Grid Infrastructure、作業系統和 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 命令時發生錯誤，該怎麼辦？

A：再次檢查您是否已提供有效的元件名稱、日期 / 時間格式以及目標選項。此外，請確定您是以 root 使用者身分執行命令。

dbaascli 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 執行診斷健全度檢查。

Q：使用 dbaascli diag healthCheck 命令有哪些先決條件？

答：命令必須以 root 使用者身分執行，而且您必須連線到 Oracle Base Database Cloud@Customer 虛擬機器。

問：如何指定用於收集日誌的自訂目錄？

A：使用 --destLocation 選項來指定要收集狀況檢查日誌的目錄。預設位置為 /var/opt/oracle/dbaas_acfs。

問：如果我未指定 – destLocation，日誌收集的預設位置為何？

A：日誌收集的預設目錄為 /var/opt/oracle/dbaas_acfs。

問：我可以指定執行狀況檢查的節點嗎？

答：是的，您可以使用 --nodes 選項，指定要執行狀況檢查的節點清單 (以逗號分隔)。

問：如何將狀況檢查日誌上傳到物件儲存？

A：使用 --objectStoreBucketURI 選項提供物件儲存服務的預先認證要求 (PAR) URL。這會將收集的日誌上傳至指定的儲存桶。

問：我可以從多個節點收集日誌嗎？

答：是的，您可以使用逗號分隔格式的 --nodes 選項來指定多個節點。例如：--nodes node1,node2。

問：在特定節點上執行狀況檢查的範例命令為何？

A：以下是在特定節點上執行狀況檢查的範例命令：

dbaascli diag healthCheck --nodes node1

問：如何將日誌儲存在 Object Storage 中，而不是儲存在本機機器上？

答：您可以使用 --objectStoreBucketURI 選項將日誌儲存在物件儲存中，提供預先認證的要求 (PAR) URL。

問：我可以同時指定 – destLocation 和 – objectStoreBucketURI 嗎？

答：是的，您可以同時指定本機儲存的 --destLocation 和將日誌上傳到物件儲存的 --objectStoreBucketURI。

問：如果在執行 dbaascli diag healthCheck 命令時發生錯誤，該怎麼辦？

A：請確定您以 root 使用者身分執行命令，並且提供有效的 --destLocation、--nodes 或 --objectStoreBucketURI 選項。驗證節點名稱是否有效 (若有指定)。

問：我可以在背景執行健康檢查嗎？

答：dbaascli diag healthCheck 命令沒有明確的背景模式，但您可以在命令結尾附加 (&) 來在背景中執行。

問：如果我沒有提供 – nodes 選項，會發生什麼事？

A：如果未提供 --nodes 選項，預設會在叢集中的所有節點上執行狀況檢查。

問：我可以使用此命令繼續先前的狀況檢查階段作業嗎？

答：否，dbaascli diag healthCheck 指令不支援繼續前一個階段作業。您必須每次啟動新的狀況檢查。

問：執行狀況檢查並將日誌上傳到物件儲存的範例命令為何？

A：以下是一個範例命令：

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

問：如果我未指定 -destLocation 或 -objectStoreBucketURI，預設行為為何？

A：如果未指定 --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 本位目錄的詳細資訊，以及列出所有 Grid Infrastructure 本位目錄詳細資訊的 dbaascli system getGridHomes。這些指令提供維護與疑難排解整體系統環境的重要資訊。

dbaascli 系統 getDBHomes

若要檢視所有 Oracle 本位目錄的相關資訊，請使用 dbaascli system getDBHomes 命令。

先決條件：

身分為 root 或 oracle 使用者身分執行指令。

語法：

dbaascli system getDBHomes

常見問題：

問：dbaascli 系統 getDBHomes 命令的用途是什麼？

答：dbaascli system getDBHomes 命令用於檢視系統上所有 Oracle 本位目錄的相關資訊。

問：哪些使用者應該執行 dbaascli 系統 getDBHomes 命令？

A：命令應以 root 或 oracle 使用者身分執行。

問：dbaascli 系統 getDBHomes 命令是否有任何參數？

A：否，dbaascli system getDBHomes 命令沒有任何參數。

問：dbaascli 系統 getDBHomes 命令提供什麼樣的資訊？

答：此命令提供有關系統上所有 Oracle 本位目錄的詳細資訊，包括其路徑和其他相關資訊。

問：如何從 dbaascli 系統 getDBHomes 命令解譯輸出？

答：輸出會列出所有含有資訊 (例如每個 Oracle 本位目錄的位置) 的 Oracle 本位目錄。此資訊可協助管理和設定 Oracle 環境。

問：如果 dbaascli 系統 getDBHomes 命令沒有傳回任何輸出，該怎麼辦？

A：確定您是以 root 或 oracle 使用者身分執行命令，並確認系統上已正確安裝 Oracle 本位目錄。您可能也要檢查系統權限與組態 。

問：如果在執行 dbaascli 系統 getDBHomes 命令時收到錯誤訊息，該怎麼辦？

A：檢查錯誤訊息以瞭解特定詳細資訊，確認您具有適當的權限，並確定已正確安裝並設定 dbaascli 工具。

問：我可以在非 Oracle 系統上執行 dbaascli 系統 getDBHomes 嗎？

答：否，dbaascli system getDBHomes 指令是 Oracle 系統特定的指令，因此需要安裝 Oracle 軟體。

範例：dbaascli system getDBHomes

dbaascli system getDBHomes

dbaascli 系統 getGridHomes

若要列出所有 Grid 本位目錄的詳細資訊，請使用 dbaascli system getGridHomes 命令。

先決條件：

身分為 root 或 oracle 使用者身分執行指令。

語法：

dbaascli system getGridHomes

常見問題：

問：dbaascli 系統 getGridHomes 命令的用途是什麼？

A：使用 dbaascli system getGridHomes 命令列出系統上所有 Grid 本位目錄的詳細資訊。

問：哪些使用者應該執行 dbaascli 系統 getGridHomes 命令？

A：命令應以 root 或 oracle 使用者身分執行。

問：dbaascli 系統 getGridHomes 命令是否有任何參數？

A：否，dbaascli system getGridHomes 命令沒有任何參數。

問：dbaascli 系統 getGridHomes 命令提供什麼樣的資訊？

A：此命令提供有關系統上所有 Grid 本位目錄的詳細資訊，包括它們的位置和其他相關資訊。

問：如何從 dbaascli 系統 getGridHomes 命令解譯輸出？

答：輸出會列出所有包含路徑和組態等資訊的 Grid 本位目錄。這有助於管理和設定 Oracle Grid Infrastructure。

問：如果 dbaascli 系統 getGridHomes 命令沒有傳回任何輸出，該怎麼辦？

A：確定您是以 root 或 oracle 使用者身分執行命令，並確認系統上已正確安裝 Oracle Grid 本位目錄。檢查系統權限和組態 (如有需要)。

問：如果在執行 dbaascli 系統 getGridHomes 命令時收到錯誤訊息，該怎麼辦？

答：複查錯誤訊息以瞭解特定詳細資訊，確定您具有適當的權限，並確認已正確安裝並設定 dbaascli 工具。

問：我可以在沒有 Oracle Grid Infrastructure 的系統上執行 dbaascli 系統 getGridHomes 嗎？

答：否，dbaascli system getGridHomes 指令是特定用於已安裝 Oracle Grid Infrastructure 的系統。如果沒有 Grid 本位目錄，則命令可能不會傳回任何結果。