Cloud Connectorのインストール
Cloud Connectorソフトウェアは、対話形式またはコマンドラインを使用してインストールできます。
-
インストールは、インストールを開始するユーザーの権限で実行されます。Cloud Connectorがクラウドにアクセスする必要があるのは、次の目的のためです。
- インストールを実行するユーザーを認証する
- インストーラーの権限を検証する
-
Cloud Connectorサービスをダウンロードして構成する
-
インストール前に確認する情報
- システム要件：Cloud Connectorをホストするマシンを準備します。
- Endpoint Security and Antivirus Best Practices Tech Zone記事のウイルス対策の除外セクション：環境内のCloud Connectorのセキュリティとパフォーマンスの適切なバランスを決定するのに役立つガイドラインを提供します。Citrixは、これらのガイドラインを組織のウイルス対策チームおよびセキュリティチームと確認し、実稼働環境に適用する前に厳格なラボベースのテストを実行することを強くお勧めします。
- システムおよび接続要件：Cloud ConnectorをホストするすべてのマシンがCitrix Cloudと通信できることを確認します。
- Cloud Connectorのプロキシおよびファイアウォール構成：Webプロキシまたは厳格なファイアウォール規則がある環境にCloud Connectorをインストールする場合。
-
Cloud Connectorの規模とサイズに関する考慮事項：Cloud Connectorをホストするマシンの構成に関する、テスト済みの最大容量とベストプラクティスの推奨事項の詳細を提供します。
-
インストールの考慮事項とガイダンス
- Active Directoryドメインコントローラー、またはリソースロケーションインフラストラクチャにとって重要なその他のマシンにCloud Connectorをインストールしないでください。Cloud Connectorの定期メンテナンスでは、これらの追加リソースに停止を引き起こすマシン操作が実行されます。
- Cloud Connectorをホストするマシンに、他のCitrix®製品をダウンロードまたはインストールしないでください。
- Cloud Connectorの個々のコンポーネントを個別にアップグレードしないでください。
- 他のCitrix製品展開（たとえば、オンプレミスのCitrix Virtual Apps and Desktops™展開のデリバリーコントローラー）に属するマシンにCloud Connectorをダウンロードまたはインストールしないでください。
- 以前にインストールしたCloud Connectorを新しいバージョンにアップグレードしないでください。代わりに、古いCloud Connectorをアンインストールしてから、新しいCloud Connectorをインストールしてください。
- Cloud ConnectorインストーラーはCitrix Cloudからダウンロードされます。そのため、ブラウザーで実行可能ファイルのダウンロードが許可されている必要があります。
- グラフィカルインストーラーを使用する場合は、ブラウザーがインストールされており、デフォルトのシステムブラウザーが設定されている必要があります。
展開後のガイダンス
インストール後、Citrix Cloudへの常時接続を確保するために、すべてのCloud Connectorの電源を継続的にオンにしておいてください。
マシンの名前変更
インストール後、Cloud Connectorをホストしているマシンの名前を変更しないでください。後でサーバー名を変更する必要がある場合は、次のタスクを実行します。
- リソースロケーションからマシンを削除します。
- Citrix Cloudメニューから、［リソースロケーション］を選択します。
- 管理するリソースロケーションを見つけて、［Cloud Connector］タイルを選択します。
- 管理するマシンを見つけて、省略記号メニューをクリックします。［コネクタの削除］を選択します。
- Cloud Connectorソフトウェアをアンインストールします。
- マシンの名前を変更します。
- この記事で説明されているように、Cloud Connectorソフトウェアの最新バージョンをインストールします。
マシンを別のドメインに移動
インストール後、Cloud Connectorをホストしているマシンを別のドメインに移動しないでください。後でマシンを別のドメインに参加させる必要がある場合は、次のタスクを実行します。
- リソースロケーションからマシンを削除します。
- Cloud Connectorソフトウェアをアンインストールします。
- マシンを現在のドメインから切断し、新しいドメインに再参加させます。
- この記事で説明されているように、Cloud Connectorソフトウェアの最新バージョンをインストールします。
クローン作成されたマシンの考慮事項
Citrix Cloudがリソースロケーション内のマシンと確実に通信できるように、Cloud Connectorをホストする各マシンには一意のSIDとコネクタIDが必要です。リソースロケーション内の複数のマシンでCloud Connectorをホストし、クローン作成されたマシンを使用する場合は、次の手順を実行します。
- 環境の要件に従ってマシンのテンプレートを準備します。
- Cloud Connectorとして使用するマシンの数をプロビジョニングします。
- 各マシンにCloud Connectorを手動で、またはサイレントインストールモードを使用してインストールします。
マシンのテンプレートにCloud Connectorをインストールすること（クローン作成前）はサポートされていません。Cloud Connectorがインストールされているマシンをクローン作成すると、Cloud Connectorサービスが実行されず、マシンはCitrix Cloudに接続できません。
サービスに関する考慮事項
この記事のインストール手順では、使用されるサービスに関係なく、Cloud Connectorを展開するプロセスについて説明します。
Citrix DaaS用にCloud Connectorを展開する場合は、コネクタが存在するADドメインがアクティブであり、Citrix Cloudコンソールで「未使用」と表示されていないことを確認してください。Citrix DaaSでマシンカタログのセットアップ中に未使用のドメインを指定すると、エラーが発生する可能性があります。詳しくは、Citrix DaaS製品ドキュメントのCitrix Cloudでリソースの種類を追加または未使用のドメインをアクティブ化するを参照してください。
その他のサービスに関する追加の考慮事項については、サービスのドキュメントを参照してください。
デフォルトのリソースロケーション
Citrix Cloudアカウントにリソースロケーションがなく、ドメインにCloud Connectorをインストールすると、Citrix Cloudが作成するリソースロケーションがデフォルトのリソースロケーションになります。アカウントにはデフォルトのリソースロケーションを1つしか持つことができません。必要に応じて、Citrix Cloudで追加のリソースロケーションを作成し、他のドメインにCloud Connectorをインストールするときに目的のリソースロケーションを選択できます。
または、ドメインにCloud Connectorをインストールする前に、コンソールで必要なリソースロケーションを最初に作成することもできます。Cloud Connectorインストーラーは、インストール中に目的のリソースロケーションを選択するように求めます。
対話形式でのインストール
グラフィカルインストーラーインターフェイスを使用してCloud Connectorをダウンロードおよびインストールできます。これを行う前に、Cloud Connectorを展開するために、Citrix Cloud管理コンソールで1つ以上のリソースロケーションを作成する必要があります。リソースロケーションについて詳しくは、「リソースロケーション」を参照してください。
Citrix Cloud Connector™ ソフトウェアのダウンロード
- Citrix Cloud Connector をインストールするマシンに Windows 管理者としてサインインします
- https://citrix.cloud.com にアクセスし、管理者アカウントにサインインします
- Citrix Cloud コンソールで、メインメニューから [リソースの場所] に移動します
- リソースの場所がまだない場合は、プラスアイコン (+) をクリックするか、[リソースの場所を追加] を選択します。詳細については、「リソースの場所を作成する」を参照してください
-
管理するリソースの場所を見つけて、[+ Cloud Connectors] を選択します
-
開いたウィンドウで [ダウンロード] を選択します。cwcconnector.exe ファイルをコネクタマシンのローカルファイル場所に保存します
Citrix Cloud Connector ソフトウェアのインストール
-
cwcconnector.exeインストーラーファイルを右クリックし、[管理者として実行] を選択します。インストーラーは、Cloud Connector をインストールする前に Citrix Cloud に接続できることを確認するための初期接続チェックを実行します - [管理] をクリックしてプロキシサーバーを更新します
-
-
注:
-
Microsoft WinHTTP の制限により、サポートされるプロキシサーバーは 1 つのみです。詳細については、「WinHTTP の AutoProxy の問題」を参照してください。
-
[高度な接続チェック] をクリックして詳細なチェックを実行し、Connector のインストールに必要な基本的な接続要件がマシンで満たされていることを確認します
初期アップグレードとテスト
- [プロキシサーバー] を更新し、[高度な接続チェック] を確認した後、[Cloud Connector のインストール] をクリックします
-
[サインイン] ページで、[サインインしてインストール] をクリックします
-
[Citrix Cloud 接続テスト] ウィンドウが表示され、初期アップグレードとテストのステータスがイベントログとともに表示されます
-
[ログの表示] をクリックして、すべての接続チェックデバッグログを含むディレクトリ
(C:\ProgramData\Citrix\WorkspaceCloud\InstallLogs)を開きます - 初期アップグレードとテストが完了すると、次の図に示すように Citrix Cloud 接続テストが [成功] と表示されます。接続チェックの結果は、最初のアップグレード後にイベントログボックスに表示されます
未使用ドメインのアクティブ化
Citrix DaaS™ 用のリソースの場所を作成し、Cloud Connector を展開する場合は、Citrix DaaS で使用している AD ドメインがアクティブであり、未使用と見なされていないことを確認してください。Citrix DaaS でマシンカタログを設定する際に未使用のドメインを指定すると、エラーが発生する可能性があります。
詳細については、Citrix DaaS 製品ドキュメントの「Citrix Cloud でリソースタイプを追加または未使用ドメインをアクティブ化する」を参照してください。
追加のリソースロケーションを作成
- Citrix Cloud管理コンソールから、メニューボタンをクリックし、リソースロケーションを選択します
- + リソースロケーションをクリックし、意味のある名前を入力します
- 保存をクリックします。Citrix Cloudは新しいリソースロケーションのタイルを表示します
- Cloud Connectorsをクリックし、次にダウンロードをクリックしてCloud Connectorソフトウェアを取得します
- 準備された各マシンで、インストールウィザードまたはコマンドラインインストールを使用してCloud Connectorソフトウェアをインストールします。Citrix Cloudは、Cloud Connectorに関連付けるリソースロケーションを選択するよう促します
複数の顧客と既存のリソースロケーションでのインストール
複数の顧客アカウントの管理者である場合、Citrix CloudはCloud Connectorに関連付ける顧客アカウントを選択するよう促します。
顧客アカウントに複数のリソースロケーションがすでに存在する場合、Citrix CloudはCloud Connectorに関連付けるリソースロケーションを選択するよう促します。
コマンドラインインストール
サイレントインストールまたは自動インストールがサポートされています。ただし、コネクタインストーラーは定期的に更新されるため、各インストールで最新のインストーラーをダウンロードすることをお勧めします。Citrix Cloudコンソールのリソースロケーションページから新しいCloud Connectorインストーラーをダウンロードしてください。
要件
Citrix Cloudでコマンドラインインストールを使用するには、以下の情報を提供する必要があります。
- Cloud ConnectorをインストールするCitrix Cloudアカウントの顧客ID。このIDは、Identity and Access Management内のAPIアクセスタブの上部に表示されます
- Cloud Connectorのインストールに使用するセキュアプリンシパルのIDとシークレット。これらの値を取得するには、まずセキュアプリンシパルを作成する必要があります。セキュアプリンシパルは「フルアクセス」で作成する必要があります。サービスプリンシパルの作成に関する詳細については、サービスプリンシパルの作成を参照してください。セキュアプリンシパルのIDとシークレットを取得したら、Cloud Connectorのインストールを続行できます
-
Cloud Connectorに関連付けるリソースロケーションのリソースロケーションID。この値を取得するには、リソースロケーションページのリソースロケーション名の下にあるIDボタンを選択します。この値を指定しない場合、Citrix CloudはデフォルトのリソースロケーションのIDを使用します
-
サポートされているパラメーター
セキュアプリンシパルのIDとシークレットのセキュリティを確保するため、JSON構成ファイルをインストーラーに提供する必要があります。このファイルは、インストール完了後に削除する必要があります。構成ファイルでサポートされている値は次のとおりです。
- customerName 必須。Citrix Cloudコンソール（Identity and Access Management内）のAPIアクセスページに表示される顧客ID
- clientId 必須。管理者が作成できるセキュアプリンシパルIDで、APIアクセスページにあります
- clientSecret 必須。セキュアプリンシパル作成後にダウンロードできるセキュアプリンシパルシークレット。APIアクセスページにあります
- resourceLocationId 推奨。既存のリソースロケーションの一意の識別子。Citrix CloudコンソールのリソースロケーションページでIDボタンを選択して、リソースロケーションIDを取得します。値が指定されていない場合、Citrix Cloudはアカウント内の最初のリソースロケーションのIDを使用します
- acceptTermsOfService 必須。trueに設定する必要があります
構成ファイルのサンプル
{
"customerName": "CustomerID",
- "clientId": "SecurePrincipalID",
- "clientSecret": "ClientSecret",
- "resourceLocationId": "ResourceLocationId",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->
コマンドのサンプル
次のコマンドは、JSON構成ファイルを使用してCloud Connectorソフトウェアをサイレントインストールします。
CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->
サイレントインストールを指定するには、/qを使用します。
失敗した場合に潜在的なエラーコードを調べるには、Start /Wait CWCConnector.exe /ParametersFilePath:valueを使用します。インストール完了後にecho %ErrorLevel%を実行する標準的なメカニズムを使用できます。
HTTPS構成
StoreFront™およびNetScaler GatewayアプライアンスがCloud Connectorに安全に接続し、すべてのデータを暗号化できるようにするには、HTTPSを有効にすることを強くお勧めします。これにはSSL証明書が必要です。
- 証明書には、コネクタに到達するために使用されるFQDNを共通名またはサブジェクトの別名として含める必要があります。コネクタの前にロードバランサーをデプロイしている場合は、ロードバランサーのFQDNを使用します。
- 証明書は、エンタープライズCAまたはパブリックCAによって署名できます。
- Cloud Connectorに接続するすべてのStoreFrontおよびゲートウェイサーバーは、証明書を信頼する必要があります。
HTTPSを有効にするには：
- 証明書MMCスナップインを開きます
- 個人証明書ストアに適切な証明書を作成またはインポートします。証明書の管理に関する詳細については、証明書の管理を参照してください
-
証明書を開き、詳細タブに移動して、スペースを無視して拇印をメモします
-
証明書をバインドするIPアドレスを決定します。通常、
0.0.0.0のIPアドレスを使用してすべてのIPv4アドレスに適用できます。IPv6が有効になっている場合は、[::]を使用してすべてのIPv6アドレスに適用します。特定のネットワークアダプターにのみ変更を適用したい場合は、そのネットワークアダプターのIPアドレスをメモしてください -
昇格されたコマンドプロンプトで実行します。
netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID} <!--NeedCopy-->AppIdには任意の有効なGUIDを使用できます。その目的は、どのアプリケーションがバインディングを追加したかを記録することです。ただし、バインディングはそのポートを使用するすべてのアプリケーションに適用されます。
例:
C:\> netsh http add sslcert ipport=0.0.0.0:443 certhash=BC96F958848639FD101A793B87915D5F2829B0B6 appid={6DE9BEFD-F4CB-4D63-8681-E88012D6F5F1} SSL Certificate successfully added <!--NeedCopy--> - HTTPを無効にするには、レジストリで
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServerに移動し、XMLServicesEnableNonSSLという名前で値が0のDWORDを作成します。
次のステップ
- Citrix Cloud Connectorの更新スケジュールを設定します。Citrix Cloud Connectorの更新と更新スケジュールの管理については、コネクタの更新を参照してください。
- StoreFrontを使用している場合は、コネクタを使用してDaaSにアクセスし、リソースを列挙および起動できるようにStoreFrontを構成します。これが新しいDaaS展開における最初のコネクタである場合は、新しいリソースフィードを作成します。追加のコネクタである場合は、既存のDaaSリソースフィードのサーバーリストにすべてのCloud Connectorを追加して、回復性を高めることをお勧めします。詳細については、ストアで利用可能にするリソースの管理を参照してください。
- NetScaler GatewayでStoreFrontを使用している場合は、コネクタを使用してCitrix Cloud Secure Ticket Authority (STA) にアクセスできます。詳細については、Citrix Gatewayの構成を参照してください。
- 特定のActive Directoryドメインでこれが最初のコネクタである場合は、そのドメインをCitrix Cloudに接続できます。詳細については、Active DirectoryをCitrix Cloudに接続するにはを参照してください。
インストールに関する問題のトラブルシューティング
このセクションでは、インストール中に発生する可能性のある問題の診断と修正方法について詳しく説明します。インストールに関する問題のトラブルシューティングの詳細については、Citrix Cloud Connectorトラブルシューティングガイドを参照してください。
インストールログ
インストールで発生した問題は、まず利用可能なログファイルを参照することでトラブルシューティングできます。
インストール中に発生したイベントは、Windowsイベントビューアーで確認できます。また、%LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetupにあるCloud Connectorインストールログも確認できます。インストール後、ログは%ProgramData%\Citrix\WorkspaceCloud\InstallLogsにも追加されます。
終了コード
インストールプロセスの成功または失敗に応じて、次の終了コードが返される場合があります。
- 1603 - 予期しないエラーが発生しました
- 2 - 前提条件チェックが失敗しました
- 0 - インストールが正常に完了しました
インストールエラー
インストーラーをダブルクリックしてCitrix Cloud Connectorソフトウェアをインストールすると、次のエラーメッセージが表示される場合があります。
このページにアクセスできません。
このエラーは、Citrix Cloud Connectorをインストールするために管理者としてマシンにログインしている場合でも発生する可能性があります。このエラーを回避するには、インストーラーを右クリックして [管理者として実行] を選択し、Citrix Cloud Connectorソフトウェアを管理者として実行します。
接続障害
Cloud ConnectorがCitrix Cloudと通信できることを確認するには、次のCitrixサービスが開始済み状態であることを確認します。
- Citrix Cloud AD プロバイダー
- Citrix Cloud Agent ロガー
- Citrix Cloud Agent システム
- Citrix Cloud Agent ウォッチドッグ
- Citrix Cloud Credential プロバイダー
- Citrix Config シンクロナイザー サービス
- Citrix High アベイラビリティ サービス
- Citrix NetScaler® CloudGateway
- Citrix Remote ブローカー プロバイダー
- Citrix Remote HCL サーバー
- Citrix Session Manager プロキシ
これらのサービスの詳細については、インストールされているサービスを参照してください。
Cloud Connector Advanced Connectivity Check Toolは、Cloud ConnectorがCitrix Cloudおよび関連サービスに到達できることを確認するのに役立ちます。
詳細については、Cloud Connector Advanced Connectivity Check Toolを参照してください。
接続チェックの失敗を解決する方法の詳細については、CTX224133: Cloud Connectorの接続チェックが失敗しましたを参照してください。