第1章 サービス・エンクレーブでの作業
アプライアンス管理者の作業環境はサービス・エンクレーブです。 アプライアンスのインフラストラクチャが制御されるシステムの一部です。 ハードウェアと容量の管理、テナンシの制御、およびすべてのシステム・レイヤーでのコンポーネントの集中モニタリング用のツールを提供します。
サービス・エンクレーブの詳細は、「Oracle Private Cloud Appliance概要ガイド」を参照してください。 「アーキテクチャと設計」の章の「エンクレーブとインタフェース」の項を参照してください。
この章では、グラフィカル・ユーザー・インタフェースとサービス・エンクレーブへのコマンドライン・インタフェースの一般的な使用原則について説明します。
1.1 サービスWeb UIの使用
サービスWeb UIは、サービス・エンクレーブへのグラフィカル・インタフェースです。 サービスWeb UIは、単独で使用することも、サービスCLIとともに使用することもできます。 サービスWeb UIには、サービスCLIと同じコア機能がありますが、サービスCLIには、同等のUIを持たない追加操作があります。
この項では、サービスWeb UIを使用するための一般的なガイドラインについて説明します。 実際のコマンドとその機能については、Oracle Private Cloud Appliance管理者ガイドの指示に従って説明します。
1.1.1 ログイン
サービスWeb UIにログインするには、次のステップを実行します:
-
サポートされているブラウザで、Oracle Private Cloud ApplianceのURLを入力します。
たとえば、
https://adminconsole.pcasys1.example.comです。pcasys1はOracle Private Cloud Applianceの名前、example.comはドメインです。サイン・イン・ページが表示されます。
-
ユーザー名とパスワードを入力し、Sign Inをクリックします。
Oracle Private Cloud Applianceダッシュボードにクイック・アクション・タイルが表示されます。
これがOracle Private Cloud Applianceインストール後の最初のログインである場合、ダッシュボードに「ASRフォン・ホーム」ページが表示され、システムをOracle Supportに登録できます。
詳細は、第5.5.3項、「ASRへのOracle Private Cloud Applianceの登録」を参照してください。
1.1.2 ダッシュボードのナビゲート
サービス・エンクレーブにログインすると、ラック・ユニット、テナンシ、アプライアンスの詳細の表示、ユーザーやネットワーク環境の管理など、一般的なタスクのクリック可能なタイルを含むクイック・アクション・エリアがダッシュボードに表示されます。
ダッシュボードの可観測性&管理部分には、モニタリング用のクイック・アクション・タイルがあります。 モニタリングをクリックすると、Grafanaコンソールが開きます。 詳細は、第5.1項、「Grafanaの使用」を参照してください。
ダッシュボードの上部バーで、Oracle Private Cloud Applianceのレルム、システム名およびドメイン名を検索できます。 上部のバーにユーザー名が表示され、プロファイル情報へのリンク、ハードウェア・データの同期、Oracle.com、サインアウト機能が表示されます。
ダッシュボードは静的であり、構成できません。
Oracle Private Cloud ApplianceのService Enclaveで管理できる、またはタブをクリックできるナビゲーション・メニューには、アプライアンスのコンポーネントとリソースが表示されます。 ナビゲーション・メニューのアイテムをクリックすると、コンポーネントまたはリソースに関する情報を含むページが表示されます。 次の表に、これらのコンポーネントおよびリソース・ページで検索可能な内容の詳細を示します。
|
コンポーネントまたはリソース |
情報提供済 |
|---|---|
|
アプライアンス詳細 |
読み取り専用アプライアンス構成の詳細と、ラック名と説明を編集するオプション。 詳細は、第2.1項、「ラック・コンポーネントの詳細の表示」を参照してください。 |
|
ネットワーク環境 |
読み取り専用ネットワーク構成情報と、ネットワーク・パラメータの構成ウィザードを開く編集ボタンで、次を変更できます:
詳細は、第2.4項、「ネットワーク環境の再構成」を参照してください。 |
|
ラック・ユニット |
ラックに取り付けられ、アプライアンス・ソフトウェアによって検出されたすべてのハードウェア・コンポーネントの読み取り専用リストと、それぞれに関する次の情報:
各コンポーネントには、コンポーネント詳細ページへの詳細の表示リンクを含むアクション・メニュー(3つのドット)もあります。 管理ノード、スイッチ、およびストレージ・コントローラの場合、詳細ページは読み取り専用ラック・ユニットおよびシステム情報を提供します。 詳細は、第2.1項、「ラック・コンポーネントの詳細の表示」を参照してください。 リスト内の各コンピュート・ノードについて、追加情報を表示できます:
コンピュート・ノードの詳細ページには、読取り専用コンピュート・ノード、ラック・ユニットおよびシステム情報が表示されます。 さらに、詳細ページまたはアクション・メニューから、メンテナンスのためのロック、すべての仮想マシンの移行、停止、プロビジョニング解除など、コンピュート・ノードで複数のアクションを実行できます。 詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。 |
|
テナンシ |
システム内のすべてのテナンシの読取り専用リストおよび各テナンシに関する次の情報:
テナンシの作成ボタン。 詳細は、第4章、「テナンシ管理」を参照してください。 |
|
アイデンティティ・プロバイダ |
アイデンティティ・プロバイダの読取り専用リストと、それぞれに関する次の情報:
アイデンティティ・プロバイダの作成ボタン。 詳細は、第3.4項、「Microsoft Active Directoryのフェデレート」を参照してください。 |
|
IDPグループ・マッピング |
システム内のIDPグループ・マッピングの読み取り専用リスト、および各マッピングに関する次の情報:
グループ・マッピングの作成ボタン。 詳細は、第3.4項、「Microsoft Active Directoryのフェデレート」を参照してください。 |
|
ユーザー |
システムのユーザーのリストと各ユーザーの次の情報のみを読み取ります:
ユーザーの作成ボタン。 詳細は、「第3章 管理者アカウント管理」を参照してください。 |
|
ジョブ |
実行したジョブの読み取り専用リスト、および各ジョブに関する次の情報:
|
|
&パッチ適用のアップグレード |
実行したアップグレード・ジョブとパッチ適用ジョブの読取り専用リストと、各ジョブに関する次の情報:
アップグレードまたはパッチの作成ボタンで、次を選択できます:
詳細は、第7章、「システムのアップグレード」を参照してください。 |
|
ASRフォン・ホーム |
Oracle Private Cloud Applianceを登録できる読取り専用自動サービス・リクエスト情報および登録ボタン。 詳細は、第5.5項、「自動サービス・リクエストの使用」を参照してください。 |
1.2 サービスCLIの使用
サービス・エンクレーブへのコマンドライン・インタフェースは、ドキュメントでは「サービスCLI」と呼ばれ、管理ノードのOracle Linuxシェルを介して使用できます。 追加のインストールまたは構成は必要ありません。 CLIでは、サービスWeb UIのすべての機能、およびUIに同等でないいくつかの追加操作にアクセスできます。
このセクションでは、サービスCLIを使用するための一般的なガイドラインについて説明します。 実際のコマンドとその機能については、以降の章のステップ・バイ・ステップの手順の一部として、Oracle Private Cloud Appliance管理者ガイドで説明されています。
CLIへのアクセス
サービスCLIにアクセスするには、管理ノードの1つでTCPポート30006へのSSH接続を確立します。 承認された管理者アカウントでログインします。 認証に成功すると、PCA-ADMIN>プロンプトが表示されます。
$ ssh admin@pcamn02 -p 30006 Password authentication Password: PCA-ADMIN>
これで、このプロンプトでコマンドを入力して管理操作を実行するための対話型の閉じたシェル環境になりました。 次に、コマンド構文および完了関数について説明します。 CLIセッションを終了するには、exitコマンドを入力します。
コマンド構文
通常、Service CLIに入力されたコマンドの構文は次のとおりです:
PCA-ADMIN> command objectType <attributes> [options]
説明:
-
commandは、開始されるコマンド・タイプです。例: :listまたはcreate。 -
objectTypeは、コマンドによって影響を受けるターゲット・コンポーネントまたはプロセスです。次に例を示します:list ComputeNodeまたはcreate Tenant。 -
attributesは、コマンドを適用する必要がある、選択したタイプの特定のオブジェクトの識別に使用されるプロパティです。たとえば、:show ManagementNode。name=pcamn02 -
optionsは、コマンドの動作に影響を与える可能性がある追加パラメータです。たとえば、ソートおよびフィルタ・オプションを
listコマンドに追加し、表示するデータ列(フィールド)を選択できます:list RackUnit。fieldsipAddress,name,rackElevation,serialNumber,firmwareVersionwherestateeqrunning
コマンドの主な要素はスペースで区切られます。 属性は" type=value "として指定されます。 リストは、カンマ区切りの値(fields ipAddress,name,rackElevation,serialNumber,firmwareVersionなど)として入力されます。
ヘルプとコマンドの完了
サービスCLIには、helpコマンドが含まれています。 最も一般的なタイプのコマンドがどのように使用されるかを示しています。これは、CLIの基本を理解するのに役立ちます。
PCA-ADMIN> help
For Most Object Types:
create <objectType> [(attribute1)="value1"] ... [on <objectType> <instance>]
delete <objectType> <instance>
edit <objectType> <instance> (attribute1)="value1" ...
list <objectType> [fields (attribute1,attribute2)]where [(filterableAttribute1) \
<filterComparator> "value1" [AND|OR] [(filterableAttribute2) <filterComparator> "value2"
show <objectType> <instance>
For Most Object Types with Children:
add <objectType> <instance> to <objectType> <instance>
remove <objectType> <instance> from <objectType> <instance>
Other Commands:
exit
showallcustomcmds
showcustomcmds <objectType>
showobjtypes
使用可能なコマンドとオブジェクト・タイプを学習する最も簡単な方法は、疑問符("?")を使用することです。 ログイン後、CLIプロンプトで"?"と入力して、ベース・コマンドのセットを表示します。
PCA-ADMIN> ?
add
clear
count
create
delete
edit
[...]
コマンド、オブジェクト・タイプおよびその他の要素にドリルダウンするには、"?"を追加して、そのカーソル位置で使用可能なパラメータを確認します。
疑問符の位置: コマンドからスペースで区切られます。 スペースを省略した場合、CLIは、コマンドのあとに続くパラメータではなく、そのコマンドのレベルで許可されるパラメータを表示します。
たとえば、リストできるオブジェクト・タイプを確認する場合は、list ?と入力してEnterを押します。 次に、まだプロビジョニングされていないコンピュート・ノードを検索するとします。 これを実現するために、プロビジョニング状態でフィルタされたコンピュート・ノードのリストを表示できます。 "?"を使用すると、次のようにコマンド・パラメータ間を移動できます。 "?"と入力するたびに、CLIにはカーソル位置で使用できるパラメータが表示されます。 上矢印キーを押して、プロンプトですでに入力したコマンドの一部に戻り、コマンドの次の部分を追加し、もう一度"?"と入力して次のパラメータ・セットを表示します。 コマンドが完了したら、Enterキーを押します。
PCA-ADMIN> list ?
AuthorizationGroup
ComputeNode
Event
Fault
[...]
PCA-ADMIN> list ComputeNode ?
fields
limit
orderby
where
PCA-ADMIN> list ComputeNode where ?
id
provisioningState
provisioningStateLastChangedTime
provisioningType
faultDomain
[...]
PCA-ADMIN> list ComputeNode where provisioningState ?
EQ
NE
LIKE
[...]
PCA-ADMIN> list ComputeNode where provisioningState EQ ?
READYTOPROVISION
PROVISIONED
PCA-ADMIN> list ComputeNode where provisioningState EQ READYTOPROVISION
Command: list ComputeNode where provisioningState EQ READYTOPROVISION
Status: Success
Time: 2021-06-25 14:04:16,837 UTC
Data:
id name provisioningState
-- ---- -----------------
bb940637-9825-4f7c-a5f4-1b49bcf6a5c9 pcacn005 Ready To Provision
76df44a9-6980-4242-a3a2-e1614b3d44d1 pcacn008 Ready To Provision
8fc0d06f-c64a-40ea-8a20-89680f03eb5e pcacn011 Ready To Provision
サービスCLIには、タブ補完の形も用意されています。 コマンドを入力してTabキーを押すと、CLIは予測できる部品を自動補完します。 複数の可能な値が残っている場合は、少なくとも1文字を追加し、Tabキーを再度押す必要があります。 次の例は、CLIがタブ補完を実行する方法を示しています。
-
1つの一致が可能なタブ完了
PCA-ADMIN> list Com
<Tab>PCA-ADMIN> list ComputeNode -
複数の一致が可能なタブ補完
PCA-ADMIN> list Ra
<Tab>PCA-ADMIN> list Rack PCA-ADMIN> list RackU<Tab>PCA-ADMIN> list RackUnit
基本コマンドとカスタム・コマンド
helpコマンドを入力するか、PCA-ADMIN>プロンプトで疑問符("?")を入力すると、CLIはその基本コマンド(create, edit, add, remove, delete, list, showなど)に関する情報を返します。 ただし、一般的に使用される「カスタム・コマンド」のもう1つのセットがあります。 すべてを単一のリストとして表示することも、特定のオブジェクト・タイプで使用可能なもののみ表示することもできます。 "?"を使用してコマンド間を移動できます。
PCA-ADMIN> showallcustomcmds
Operation Name: <Related Object(s)>
-----------------------------------
abort: Job
asrClientDisable: ASRPhonehome
asrClientEnable: ASRPhonehome
asrClientRegister: ASRPhonehome
asrClientUnregister: ASRPhonehome
changePassword: User
createAdminAccount:
createUserInGroup: User
[...]
upgradePlatform: UpgradeRequest
upgradeSwitch: UpgradeRequest
upgradeVault: UpgradeRequest
upgradeZfssa: UpgradeRequest
PCA-ADMIN> showcustomcmds ?
ASRPhonehome
ComputeNode
DrConfig
Event
ExadataNetwork
FaultManager
Job
NetworkConfig
PcaSystem
PurgeManager
UpgradeJob
UpgradeJobList
UpgradeRequest
User
PCA-ADMIN> showcustomcmds ComputeNode
provisioningLock
provisioningUnlock
maintenanceLock
maintenanceUnlock
provision
deprovision
migrateVm
reset
start
stop