Oracle C3 への接続 (プレビュー)
接続とリソースの作成および管理 の記事では、一般的な接続ワークフローについて説明しています。以下の情報では、Oracle C3 固有の詳細について説明します。
注:
Oracle C3 への接続を作成する前に、Oracle C3 環境のセットアップを完了してください。Oracle C3 仮想化環境 を参照してください。
接続を作成する
Oracle C3 への接続は、次の方法で作成できます。
-
ウェブスタジオ
-
PowerShellコマンド
Web Studio を使用して接続を作成する
-
ウィザードを続行し、接続を検証します。
注:
Web Studio で構成をインポートすると、次のキーのみがインポートされます。その他のキーはすべて無視されます。
-
user -
fingerprint -
tenancy -
region
接続設定は、次の証明書シナリオで停止する可能性があります。
-
証明書の検証またはサムプリントの確認が失敗した場合: 問題が解決されるまで接続の作成はブロックされます。
PowerShellコマンドを使用して接続を作成する
PowerShell を使用して接続を作成する場合、以下を指定します。
-
Oracle C3 エンドポイントアドレス（通常は
https://iaas.<service_name>.<domain_name>）。 -
構成ファイル (
user) からの Oracle C3 ユーザー OCID。 -
資格情報ファイル (
.pem) からの秘密鍵の内容。セキュア文字列として渡されます。 -
TenancyOcid、Fingerprint、およびRegionを含むCustomPropertiesXML。 -
必要に応じて、証明書信頼検証用の SSL サムプリント。
パターン例：
$CustomProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">' +
'<Property xsi:type="StringProperty" Name="TenancyOcid" Value="' + $TenancyOcid + '" />' +
'<Property xsi:type="StringProperty" Name="Fingerprint" Value="' + $Fingerprint + '" />' +
'<Property xsi:type="StringProperty" Name="Region" Value="' + $Region + '" />' +
'</CustomProperties>'
$PrivateKey = ConvertTo-SecureString $PrivateKeyContent -AsPlainText -Force
New-Item -ConnectionType "Custom" `
-HypervisorAddress $Endpoint `
-Path @("XDHyp:\Connections\$ConnectionName") `
-Persist `
-PluginId "OracleC3PluginFactory" `
-CustomProperties $CustomProperties `
-SecurePassword $PrivateKey `
-UserName $UserOcid `
-SslThumbprint $SslThumbprint
注:
$Region を <service_name>.<domain_name> 形式の Oracle C3 リージョン値に設定します。証明書信頼ポリシーで必要な場合は -SslThumbprint を使用します。
証明書とサムプリントの検証
Oracle C3 接続を成功させるには、証明書の検証が成功し、必要に応じてサムプリント値が正しい必要があります。
接続の管理
このセクションでは、以下について説明します。
-
Web Studio を使用して証明書の問題を修正する
-
PowerShell を使用してサムプリント値を更新する
証明書の問題を修正する
証明書の問題が発生した場合、Citrix はワークロード操作を保護するために Oracle C3 接続をブロックします。ホスト接続リストの接続の横にエラーアイコンが表示されます。
修正するには：
-
ホスト接続から接続を開きます。
-
「トラブルシューティング」の詳細を表示し、証明書の問題を特定します。
-
「接続の編集 > 設定の編集」を選択します。
-
Oracle C3 の場合、プロンプトが表示されたら、構成と秘密鍵を再インポートしてください。両方が利用可能な場合は、接続作成時と同様に、変更を保存して新たな証明書検証を開始し、提示された更新された証明書サムプリントを検証または信頼してください。
サムプリント値の更新
作成後に
Set-Item を使用してサムプリント値を更新できます。
-
接続の詳細を取得します。
Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> -
サムプリント値を更新します。
Set-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> `
-Username <UserName> `
-SslThumbprint <ThumbprintValue> -
更新された値を確認します。
Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
注:
指定されたサムプリントが正しくないか、サーバー証明書の信頼と一致しない場合、更新は失敗します。
次のステップ
-
初期展開プロセス中の場合は、「マシンカタログの作成」を参照してください。
-
Oracle C3 固有の情報については、「Oracle C3 マシンカタログの作成」を参照してください。