機械翻訳について

第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にログインするには、次のステップを実行します:

  1. サポートされているブラウザで、Oracle Private Cloud ApplianceのURLを入力します。

    たとえば、https://adminconsole. pcasys1.example.comです。pcasys1はOracle Private Cloud Applianceの名前、example.comはドメインです。

    サイン・イン・ページが表示されます。

  2. ユーザー名とパスワードを入力し、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項、「ラック・コンポーネントの詳細の表示」を参照してください。

ネットワーク環境

読み取り専用ネットワーク構成情報と、ネットワーク・パラメータの構成ウィザードを開く編集ボタンで、次を変更できます:

  • ルーティング・アップリンク・ゲートウェイ、VLAN、HSRPグループ、およびスパイン仮想IP

  • 管理ノードのIPとホスト名

  • ポートのアップリンク速度、カウント、ポートFEC、VLAN MTU、ネットマスクとスパインIP

  • NTPサーバーのIPアドレス

  • 管理ネットワーク・ステータス

  • DNSサーバーのIPアドレス

  • パブリックIP範囲とオブジェクト・ストレージIP

詳細は、第2.4項、「ネットワーク環境の再構成」を参照してください。

ラック・ユニット

ラックに取り付けられ、アプライアンス・ソフトウェアによって検出されたすべてのハードウェア・コンポーネントの読み取り専用リストと、それぞれに関する次の情報:

  • 名前

  • ラック・ユニット・タイプ

  • 状態

  • ラック高さ

各コンポーネントには、コンポーネント詳細ページへの詳細の表示リンクを含むアクション・メニュー(3つのドット)もあります。 管理ノード、スイッチ、およびストレージ・コントローラの場合、詳細ページは読み取り専用ラック・ユニットおよびシステム情報を提供します。

詳細は、第2.1項、「ラック・コンポーネントの詳細の表示」を参照してください。

リスト内の各コンピュート・ノードについて、追加情報を表示できます:

  • プロビジョニング状態

  • メンテナンス・ロック

  • プロビジョニングされたロック

コンピュート・ノードの詳細ページには、読取り専用コンピュート・ノード、ラック・ユニットおよびシステム情報が表示されます。 さらに、詳細ページまたはアクション・メニューから、メンテナンスのためのロック、すべての仮想マシンの移行、停止、プロビジョニング解除など、コンピュート・ノードで複数のアクションを実行できます。 詳細は、第2.2項、「コンピュート・ノード操作の実行」を参照してください。

テナンシ

システム内のすべてのテナンシの読取り専用リストおよび各テナンシに関する次の情報:

  • 名前

  • 説明

  • 「アクション」メニュー

    テナンシ詳細ページの表示、テナンシの説明の編集またはテナンシの削除を行うオプションが含まれています。

    詳細ページからテナンシを編集または削除することもできます。

テナンシの作成ボタン。

詳細は、第4章、「テナンシ管理」を参照してください。

アイデンティティ・プロバイダ

アイデンティティ・プロバイダの読取り専用リストと、それぞれに関する次の情報:

  • 名前

  • 強制認証

  • アサーションの暗号化

  • 「アクション」メニュー

    アイデンティティ・プロバイダの詳細ページを表示し、アイデンティティ・プロバイダを編集または削除するためのオプションが含まれています。

    詳細ページからアイデンティティ・プロバイダを編集または削除することもできます。

アイデンティティ・プロバイダの作成ボタン。

詳細は、第3.4項、「Microsoft Active Directoryのフェデレート」を参照してください。

IDPグループ・マッピング

システム内のIDPグループ・マッピングの読み取り専用リスト、および各マッピングに関する次の情報:

  • 名前

  • IDPグループ名

  • 管理グループ名

  • 説明

  • 「アクション」メニュー

    IDPグループ・マッピング詳細ページで読取り専用情報を表示するオプションが含まれています。 MORE...

グループ・マッピングの作成ボタン。

詳細は、第3.4項、「Microsoft Active Directoryのフェデレート」を参照してください。

ユーザー

システムのユーザーのリストと各ユーザーの次の情報のみを読み取ります:

  • 名前

  • 認可グループ

  • デフォルト・ユーザー

  • 「アクション」メニュー

    ユーザーの詳細ページで読取り専用情報を表示したり、ユーザー・パスワードを変更したり、ユーザーを削除するためのオプションが含まれています。

    ユーザー・パスワードを変更したり、詳細ページからユーザーを削除することもできます。

ユーザーの作成ボタン。

詳細は、「第3章 管理者アカウント管理を参照してください。

ジョブ

実行したジョブの読み取り専用リスト、および各ジョブに関する次の情報:

  • オブジェクト型

  • 開始時間および終了時間

  • 実行ステータス - アクティブ、成功、失敗または中断

  • 「アクション」メニュー

    ジョブの詳細ページで読取り専用情報を表示するオプションが含まれています。これには、ジョブの実行元のユーザー・アカウントが含まれます。

&パッチ適用のアップグレード

実行したアップグレード・ジョブとパッチ適用ジョブの読取り専用リストと、各ジョブに関する次の情報:

  • ジョブ名

  • リクエストおよびジョブID

  • 開始時間および終了時間

  • コマンド名

  • 結果 - 合格、失敗、実行なし、取消済またはなし

アップグレードまたはパッチの作成ボタンで、次を選択できます:

  • アップグレード・リクエスト - コンピュート・ノード、ホスト、Ilom、Kubernetes、プラットフォームなど、いくつかのタイプのアップグレードが含まれます。

  • パッチ・リクエスト - コンピュート・ノード、ホスト、Ilom、Kubernetes、OCIイメージ、プラットフォームなど、いくつかのタイプのパッチが含まれます。

詳細は、第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 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)>
    -----------------------------------
    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