1 「サービス・エンクレーブ」での作業
アプライアンス管理者の作業環境は「サービス・エンクレーブ」です。 アプライアンスのインフラストラクチャが制御されるシステムの一部です。 ハードウェアと容量の管理、テナンシの制御、およびすべてのシステム・レイヤーでのコンポーネントの集中モニタリング用のツールを提供します。
「サービス・エンクレーブ」の詳細は、「Oracle Private Cloud Appliance概要ガイド」を参照してください。 「アーキテクチャと設計」の章の「エンクレーブとインタフェース」の項を参照してください。
この章では、「サービス・エンクレーブ」へのグラフィカル・ユーザー・インタフェースおよびコマンド行インタフェースの一般的な使用法の原則について説明します。
ノート:
webブラウザを使用して「サービスWeb UI」にアクセスします。 サポート情報については、「Oracleソフトウェアのwebブラウザ・サポート・ポリシー」を参照してください。
「サービスWeb UI」の使用
「サービスWeb UI」は、「サービス・エンクレーブ」へのグラフィカル・インタフェースです。 「サービスWeb UI」は単独で使用することも、「サービスCLI」とともに使用してタスクを完了することもできます。 「サービスWeb UI」は「サービスCLI」と同じコア機能を提供しますが、「サービスCLI」にはUIに相当する操作がない追加操作があります。
この項では、「サービスWeb UI」を使用するための一般的なガイドラインを示します。 実際のコマンドとその関数は、ステップごとの手順の一部として、「Oracle Private Cloud Appliance管理者ガイド」全体に説明されています。
ログイン
「サービスWeb UI」にログインするには、次のステップを実行します:
-
サポートされているブラウザで、Oracle Private Cloud ApplianceのURLを入力します。
たとえば、
https://adminconsole.pcasys1.example.comです。pcasys1はPrivate Cloud Applianceの名前で、example.comはドメインです。サイン・イン・ページが表示されます。
-
ユーザー名とパスワードを入力し、Sign Inをクリックします。
Private Cloud Applianceダッシュボードにクイック・アクション・タイルが表示されます。
ノート:
Private Cloud Applianceのインストール後の最初のログインの場合、ダッシュボードには「ASRフォン・ホーム」ページが表示され、システムをMy Oracle Supportに登録できます。
詳細は、「Oracle Auto Service RequestのPrivate Cloud Applianceの登録」を参照してください。
ダッシュボードのナビゲート
「サービス・エンクレーブ」にログインすると、ダッシュボードに、ラック・ユニット、テナンシおよびアプライアンスの詳細の表示、ユーザーおよびネットワーク環境の管理など、一般的なタスクのクリック可能なタイルを含むクイック・アクション領域が表示されます。
ダッシュボードの可観測性&管理部分には、モニタリング用のクイック・アクション・タイルがあります。 モニタリングをクリックすると、Grafanaコンソールが開きます。 詳細は、「Grafanaの使用」を参照してください。
ダッシュボードの上部バーで、Private Cloud Applianceのレルムおよびシステム名とドメイン名を検索できます。 上部のバーにユーザー名が表示され、プロファイル情報へのリンク、ハードウェア・データの同期、oracle.com、サインアウト機能が表示されます。
ノート:
ダッシュボードは静的であり、構成できません。
ナビゲーション・メニューをクリックすると、またはタブをクリックすると、Private Cloud Applianceの「サービス・エンクレーブ」内で管理できるアプライアンス・コンポーネントおよびリソースがリストされます。 ナビゲーション・メニューのアイテムをクリックすると、コンポーネントまたはリソースに関する情報を含むページが表示されます。 次の表に、これらのコンポーネントおよびリソース・ページで検索可能な内容の詳細を示します。
| コンポーネントまたはリソース | 情報提供済 |
|---|---|
|
アプライアンス詳細 |
読み取り専用アプライアンス構成の詳細と、ラック名と説明を編集するオプション。 詳細は、「ラック・コンポーネントの詳細の表示」を参照してください。 |
|
ネットワーク環境 |
読み取り専用ネットワーク構成情報と、ネットワーク・パラメータの構成ウィザードを開く編集ボタンで、次を変更できます:
詳細は、「ネットワーク環境の再構成」を参照してください。 |
|
ラック・ユニット |
ラックに取り付けられ、アプライアンス・ソフトウェアによって検出されたすべてのハードウェア・コンポーネントの読み取り専用リストと、それぞれに関する次の情報:
各コンポーネントには、コンポーネント詳細ページへの詳細の表示リンクを含むアクション・メニュー(3つのドット)もあります。 管理ノード、スイッチ、およびストレージ・コントローラの場合、詳細ページは読み取り専用ラック・ユニットおよびシステム情報を提供します。 詳細は、「ラック・コンポーネントの詳細の表示」を参照してください。 リスト内の各コンピュート・ノードについて、追加情報を表示できます:
コンピュート・ノードの詳細ページには、読取り専用コンピュート・ノード、ラック・ユニットおよびシステム情報が表示されます。 さらに、詳細ページまたはアクション・メニューから、メンテナンスのためのロック、すべての仮想マシンの移行、停止、プロビジョニング解除など、コンピュート・ノードで複数のアクションを実行できます。 詳細は、「コンピュート・ノード操作の実行」を参照してください。 |
|
テナンシ |
システム内のすべてのテナンシの読取り専用リストおよび各テナンシに関する次の情報:
テナンシの作成ボタン。 詳細は、「テナンシ管理」を参照してください。 |
|
アイデンティティ・プロバイダ |
アイデンティティ・プロバイダの読取り専用リストと、それぞれに関する次の情報:
アイデンティティ・プロバイダの作成ボタン。 詳細は、「Microsoft Active Directoryとのフェデレート」を参照してください。 |
|
IDPグループ・マッピング |
システム内のIDPグループ・マッピングの読み取り専用リスト、および各マッピングに関する次の情報:
グループ・マッピングの作成ボタン。 詳細は、「Microsoft Active Directoryとのフェデレート」を参照してください。 |
|
ユーザー |
システムのユーザーのリストと各ユーザーの次の情報のみを読み取ります:
ユーザーの作成ボタン。 詳細は、「管理者アカウント管理」を参照してください。 |
|
ジョブ |
実行したジョブの読み取り専用リスト、および各ジョブに関する次の情報:
|
|
&パッチ適用のアップグレード |
実行したアップグレード・ジョブとパッチ適用ジョブの読取り専用リストと、各ジョブに関する次の情報:
アップグレードまたはパッチの作成ボタンで、次を選択できます:
詳細は、「システムのアップグレード」を参照してください。 |
|
ASRフォン・ホーム |
読取り専用自動サービス・リクエスト情報およびPrivate Cloud Applianceを登録できる登録ボタン。 詳細は、「Oracle Auto Service Requestの使用」を参照してください。 |
「サービス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コマンドを入力します。
コマンド構文
通常、「サービスCLI」に入力されたコマンドの構文は次のとおりです:
PCA-ADMIN> command objectType <attributes> [options]
説明:
-
commandは、開始されるコマンド・タイプです。例: :listまたはcreate。 -
objectTypeは、コマンドによって影響を受けるターゲット・コンポーネントまたはプロセスです。次に例を示します:list ComputeNodeまたはcreate Tenant。 -
attributesは、コマンドを適用する必要がある、選択したタイプの特定のオブジェクトの識別に使用されるプロパティです。たとえば、:show ManagementNode name=pcamn02。 -
optionsは、コマンドの動作に影響を与える可能性がある追加パラメータです。たとえば、ソートおよびフィルタ・オプションを
listコマンドに追加し、表示するデータ列(フィールド)を選択できます:list RackUnit fields ipAddress,name,rackElevation,serialNumber,firmwareVersion where state eq running。
コマンドの主な要素はスペースで区切られます。 属性は"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)>
-----------------------------------
asrClientDisable: ASRPhonehome
asrClientEnable: ASRPhonehome
asrClientRegister: ASRPhonehome
[...]
changeIlomPassword: ComputeNode, ManagementNode
changePassword: ComputeNode, LeafSwitch, ManagementNode, ManagementSwitch, SpineSwitch, User, ZFSAppliance
clearFirstBootError: NetworkConfig
configZFSAdDomain: ZfsAdDomain
configZFSAdWorkgroup: ZfsAdDomain
createAdminAccount:
createUserInGroup: User
deletePlatformImage: PlatformImage
deprovision: ComputeNode
disableVmHighAvailability: PcaSystem
drAddComputeInstance: ComputeInstance
drAddSiteMapping: DrSiteMapping
drConfigCleanupPrimary: DrConfig
[...]
maintenanceLock: ComputeNode
maintenanceUnlock: ComputeNode
migrateVm: ComputeNode
patchCN: PatchRequest
patchEtcd: PatchRequest
patchHost: PatchRequest
patchIlom: PatchRequest
patchKubernetes: PatchRequest
patchMySQL: PatchRequest
patchOCIImages: PatchRequest
patchPlatform: PatchRequest
patchSwitch: PatchRequest
patchVault: PatchRequest
patchZfssa: PatchRequest
[...]
start: CnUpdateManager, ComputeNode, Day0NetworkConfigManager, FaultManager, PurgeManager, ZfsPoolManager
stop: CnUpdateManager, ComputeNode, Day0NetworkConfigManager, FaultManager, PurgeManager, ZfsPoolManager
syncHardwareData:
syncUpstreamUlnMirror: PatchRequest
systemStateLock: PcaSystem
systemStateUnlock: PcaSystem
updateSauronCredentials:
upgradeCN: UpgradeRequest
upgradeEtcd: UpgradeRequest
upgradeFullMN: UpgradeRequest
upgradeHost: UpgradeRequest
upgradeIlom: UpgradeRequest
upgradeKubernetes: UpgradeRequest
upgradeMySQL: UpgradeRequest
upgradePlatform: UpgradeRequest
upgradePreConfig: UpgradeRequest
upgradeSwitch: UpgradeRequest
upgradeVault: UpgradeRequest
upgradeZfssa: UpgradeRequest
PCA-ADMIN> showcustomcmds ?
ASRBundle
ASRPhonehome
BackupJob
CnUpdateManager
ComputeInstance
ComputeNode
Day0NetworkConfigManager
DrConfig
DrJob
DrSiteMapping
Event
ExadataNetwork
FaultDomainInfo
FaultManager
Job
LeafSwitch
ManagementNode
ManagementSwitch
NetworkConfig
PatchRequest
PcaSystem
PlatformImage
PurgeManager
SpineSwitch
UpgradeJob
UpgradeJobList
UpgradeRequest
User
Vcn
ZfsAdDomain
ZFSAppliance
ZfsPoolManager
PCA-ADMIN> showcustomcmds ComputeNode
provisioningLock
provisioningUnlock
maintenanceLock
maintenanceUnlock
provision
deprovision
migrateVm
reset
start
stop
changePassword
changeIlomPassword
getRunningInstances
getRunningInstancesCount