Cloud Connectorのインストール
Cloud Connectorソフトウェアは、対話形式で、またはコマンドラインを使用してインストールできます。
インストールは、インストールを開始するユーザーの権限で行われます。Cloud Connectorは、次のことを行うためにクラウドにアクセスする必要があります:
- インストールを実行するユーザーを認証する
- インストーラーの権限を確認する
- Cloud Connectorサービスをダウンロードして構成する
インストール前に確認する情報
- システム要求:Cloud Connectorをホストするマシンを準備するために確認します。
- Tech Zone記事「エンドポイントのセキュリティとウイルス対策のベストプラクティス」の「ウイルス対策の除外」セクション:環境のCloud Connectorに対してセキュリティとパフォーマンスの適切なバランスを判断するためのガイドラインを提供しています。これらのガイドラインを組織のウイルス対策チームとセキュリティチームとともに確認し、実稼働環境に適用する前に厳格なラボベースのテストを実施することを強くお勧めします。
- システムおよび接続要件: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展開のDelivery Controller)にCloud Connectorをダウンロードまたはインストールしないでください。
- 以前にインストールしたCloud Connectorを新しいバージョンにアップグレードしないでください。古いCloud Connectorをアンインストールしてから、新しいバージョンをインストールしてください。
- Cloud Connectorのインストーラーは、Citrix Cloudからダウンロードします。そのため、ブラウザーが実行可能ファイルをダウンロードできるようにする必要があります。
- グラフィカルインストーラーを使用する場合は、ブラウザーのインストールと、デフォルトのシステムブラウザーセットが必要です。
導入後のガイダンス
インストールしたら、すべてのCloud Connectorの電源をオンのままにして、Citrix Cloudへの常時接続を確保します。
マシンの名前変更
インストール後、Cloud Connectorをホストしているマシンの名前を変更しないでください。後でサーバー名を変更する必要がある場合は、次のタスクを実行します:
- リソースの場所からマシンを削除します:
- Citrix Cloudメニューから [リソースの場所] を選択します。
- 管理するリソースの場所を見つけて [Cloud Connector] タイルを選択します。
- 管理するマシンを見つけて、省略記号メニューをクリックします。[コネクタを削除] を選択します。
- Cloud Connectorソフトウェアをアンインストールします。
- マシンの名前を変更します。
- この記事の説明に従って、Cloud Connectorソフトウェアの最新バージョンをインストールします。
マシンを別のドメインに移動する
インストール後、Cloud Connectorをホストしているマシンを別のドメインに移動しないでください。後でマシンを別のドメインに参加させる必要がある場合は、次のタスクを実行します:
- リソースの場所からマシンを削除します。
- Cloud Connectorソフトウェアをアンインストールします。
- 現在のドメインからマシンの参加を解除し、マシンを新しいドメインに再度参加させます。
- この記事の説明に従って、Cloud Connectorソフトウェアの最新バージョンをインストールします。
クローンマシンに関する考慮事項
Cloud Connectorをホストする各マシンには、一意のSIDとコネクタIDが必要です。これにより、Citrix Cloudがリソースの場所内のマシンと確実に通信できるようになります。リソースの場所の複数のマシンで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をダウンロードしインストールできます。これを行う前に、Citrix Cloud管理コンソールで1つまたは複数のリソースの場所を作成して、Cloud Connectorを展開する必要があります。リソースの場所について詳しくは、「リソースの場所」を参照してください。
リソースの場所を作成するには
- Citrix Cloud Connectorをインストールする予定のマシンに、Windows管理者としてサインインします。
- https://citrix.cloud.comにアクセスして、管理者アカウントにサインインします。
-
Citrix Cloudコンソールで、メインメニューから [リソースの場所] に移動する、またはページ上部の [リソースの場所] にある [編集または新規追加] を選択します。
-
[リソースの場所]ページの上部にある [+ リソースの場所] を選択し、わかりやすい新しい名前で保存します。
Citrix Cloud Connectorソフトウェアのダウンロード
-
管理するリソースの場所を見つけて [+ Cloud Connectors] を選択します。
-
開いたウィンドウで [ダウンロード] を選択します。cwcconnector.exeファイルをコネクタマシンのローカルファイルの場所に保存します。
Citrix Cloud Connectorソフトウェアのインストール
- cwcconnector.exeインストーラーファイルを右クリックして、[管理者として実行] を選択します。インストーラーは、最初の接続性チェックを実行して、Citrix Cloudに接続できることを確認します。
- (オプション)必要に応じて、[プロキシの構成] をクリックしてプロキシサーバーを追加します。 プロキシ情報を追加するよう求められます。
- [サインインしてインストール] をクリックして、Citrix Cloudにサインインします。
- Cloud Connectorをインストールして構成するには、ウィザードの指示に従います。インストールが完了すると、インストーラーは最終的な接続性チェックを実行して、Cloud ConnectorとCitrix Cloud間の通信を検証します。
- Citrix Cloud Connectorとして使用する他のマシンで、これらの手順を繰り返します。可用性を高めるため、リソースの場所ごとにCloud Connectorを2つ以上インストールすることをお勧めします。
Citrix Cloudでは、リソースの場所の [Connectors] ページに、新しくインストールしたCloud Connectorが表示されます。
インストール後、Citrix Cloudの [IDおよびアクセス管理]>[ドメイン] にも管理者のドメインが登録されます。詳しくは、「IDおよびアクセス管理」を参照してください。
未使用ドメインのアクティブ化
リソースの場所を作成し、Citrix DaaS用のCloud Connectorを展開している場合は、Citrix DaaSで使用しているADドメインがアクティブであり、未使用と見なされていないことを確認してください。Citrix DaaSでマシンカタログのセットアップ中に未使用のドメインを指定すると、エラーが発生する場合があります。
詳しくは、Citrix DaaS製品ドキュメントの「リソースの種類を追加するか、Citrix Cloudで未使用のドメインをアクティブ化する」を参照してください。
追加のリソースの場所を作成
- Citrix Cloud管理コンソールでメニューボタンをクリックし、[リソースの場所] を選択します。
- [+リソースの場所] をクリックして、意味がわかる名前を入力します。
- [保存]をクリックします。Citrix Cloudは、新しいリソースの場所のタイルを表示します。
- [Cloud Connector]、[ダウンロード] の順にクリックして、Cloud Connectorソフトウェアを入手します。
- 準備した各マシンで、インストールウィザードまたはコマンドラインインストールを使用してCloud Connectorソフトウェアをインストールします。Citrix Connectorに関連付けるリソースの場所を選択するように求められます。
複数の顧客および既存のリソースの場所でのインストール
複数の顧客アカウントの管理者である場合、Citrix Cloudは、Cloud Connectorに関連付ける顧客アカウントを選択するよう要求します。
顧客アカウントに複数のリソースの場所が既に存在する場合、Citrix Connectorに関連付けるリソースの場所を選択するように求められます。
コマンドラインインストール
サイレントまたは自動インストールがサポートされています。ただし、同じインストーラーで繰り返しインストールしないでください。Citrix Cloudコンソールの[リソースの場所]ページから新しいCloud Connectorをダウンロードします。
要件
Citrix Cloudでコマンドラインを使用してインストールするには、次の情報を入力する必要があります:
- Citrix Cloud ConnectorをインストールするCitrix Cloudアカウントの顧客ID。このIDは、[IDおよびアクセス管理]の [APIアクセス] タブの上部に表示されます。
- Cloud Connectorのインストールに使用するセキュアAPIクライアントのクライアントIDとシークレット。これらの値を取得するには、まずセキュアクライアントを作成する必要があります。クライアントIDとシークレットにより、Citrix Cloud APIへのアクセスが適切に保護されます。セキュアクライアントを作成すると、クライアントは、作成するユーザーと同じレベルの管理者権限で動作します。Cloud Connectorをインストールするには、フルアクセス権限を持つ管理者によって作成されたセキュアクライアントを使用する必要があります。これは、そのセキュアクライアントにもフルアクセス権限があることを意味します。
- Cloud Connectorに関連付けるリソースの場所のID。この値を取得するには、[リソースの場所]ページのリソースの場所の名前の下にある [ID] ボタンを選択します。この値を指定しない場合、デフォルトのリソースの場所のIDが使用されます。
セキュアクライアントの作成
セキュアクライアントを作成する場合、Citrix Cloudにより一意のクライアントIDとシークレットが生成されます。コマンドラインからAPIを呼び出すときに、これらの値を指定する必要があります。
- Citrix Cloudメニューから、[IDおよびアクセス管理] を選択し、次に [APIアクセス] を選択します。
- [セキュアクライアント] タブから、クライアントの名前を入力し、[クライアントの作成]を選択します。セキュアクライアントのクライアントIDとシークレットが生成されて表示されます。
- [ダウンロード] を選択して、クライアントIDとシークレットをCSVファイルとしてダウンロードし、安全な場所に保存します。または、[コピー] を選択して、それぞれの値を手動で取得します。完了したら [閉じる] を選択してコンソールに戻ります。
サポートされているパラメーター
セキュアクライアントのセキュリティの詳細を確保するには、インストーラーにJSON構成ファイルを提供する必要があります。このファイルは、インストールの完了後に削除する必要があります。構成ファイルでサポートされている値は次のとおりです:
- customerName:必須。[IDおよびアクセス管理]のCitrix Cloudコンソールの[APIアクセス]ページに表示される顧客ID。
- clientId:必須。管理者が作成できるセキュアクライアントIDで、[APIアクセス]ページにあります。
- clientSecret:必須。セキュアクライアントが作成された後にダウンロードできるセキュアクライアントシークレット。[APIアクセス]ページにあります。
- resourceLocationId:推奨。既存のリソースの場所の一意の識別子。Citrix Cloudコンソールの[リソースの場所]ページで、IDボタンを選択してリソースの場所のIDを取得します。値を指定しない場合、Citrix Cloudはアカウント内の最初のリソースの場所のIDを使用します。
- acceptTermsOfService:必須。trueに設定する必要があります。
サンプル構成ファイル
{
"customerName": "\*CustomerID\*",
"clientId": "\*ClientID\*",
"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%」を使用できます。
注:
パラメーターを使用したクライアントIDとクライアントシークレットの指定はサポートされなくなりました。自動インストールには構成ファイルを使用する必要があります。
次の手順
- Citrix Cloud Connectorの更新スケジュールを設定します。Citrix Cloud Connectorの更新と更新スケジュールの管理については、「Connectorの更新」を参照してください。
- ワークスペース利用者を認証するためのIDプロバイダーを設定します。[IDおよびアクセス管理] コンソールで、デフォルトのCitrix IDプロバイダーをActive DirectoryなどのIDプロバイダーに変更できます。詳しくは、「Active DirectoryをCitrix Cloudに接続するには」を参照してください。
インストール問題のトラブルシューティング
このセクションでは、インストール中に発生する可能性がある問題を診断および修正するいくつかの方法について詳しく説明します。インストール問題のトラブルシューティングについて詳しくは、「Citrix Cloud Connectorトラブルシューティングガイド」を参照してください。
インストールログ
利用可能なログファイルを最初に調べることで、インストール時に発生した問題のトラブルシューティングを行うことができます。
インストール中に発生したイベントは、Windowsイベントビューアーで確認できます。%LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetupにあるCloud Connectorのインストールログを確認することもできます。 また、インストール後は%ProgramData%\Citrix\WorkspaceCloud\InstallLogsにもログが追加されます。
終了コード
インストールプロセスの成功または失敗に応じて、次の終了コードが返されることがあります:
- 1603 - 予期しないエラーが発生しました
- 2 - 前提条件チェックが不合格でした
- 0 - インストールが正常に完了しました
インストールエラー
インストーラーをダブルクリックしてCitrix Cloud Connectorソフトウェアをインストールすると、次のエラーメッセージが表示される場合があります:
Can't reach this page.
このエラーは、管理者としてマシンにログインしてCitrix Cloud Connectorをインストールする場合でも発生することがあります。このエラーを回避するには、インストーラーを右クリックして[管理者として実行]を選択し、Citrix Cloud Connectorソフトウェアを管理者として実行します。
接続エラー
Cloud ConnectorがCitrix Cloudと通信できていることを確認するには、以下のCitrixサービスが [開始] 状態になっていることを確認します:
- Citrix Cloud AD Provider
- Citrix Cloud Agent Logger
- Citrix Cloud Agent System
- Citrix Cloud Agent Watchdog
- Citrix Cloud Credential Provider
- Citrix Config Synchronizer Service
- Citrix High Availability Service
- Citrix NetScaler CloudGateway
- Citrix Remote Broker Provider
- Citrix Remote HCL Server
- Citrix Session Manager Proxy
これらのサービスについて詳しくは、「インストールされているサービス」を参照してください。
接続エラーが引き続き発生する場合は、Citrix Support Knowledge Centerで入手できるCloud Connector接続チェックユーティリティを使用してください。詳しくは、Knowledge Center WebサイトのCTX260337を参照してください。
このツールを使用して、次のタスクを実行できます:
- Citrix Cloudとその関連サービスにアクセスできるかどうかのテスト。
- 誤って構成されがちな設定のチェック。
- Citrix Cloud Connectorのプロキシ設定の構成。
失敗した接続性チェックを解決する方法について詳しくは、「CTX224133:Cloud Connector接続性チェックエラー」を参照してください。