QAWeb Agentのインストール

インストールの概要

注釈

ワークステーションにソフトウエアをインストールする前に、システム要件を参照してください（システム要件を参照） また、QAWeb Agentをインストールするには、ワークステーションの管理者権限が必要であることに注意してください。

インストールは次の2つの方法で実行できます。

  • グラフィックインストールウィザードの使用。

  • コマンドライン引数を使用します。 これによりQAWeb Agentを、自動化されたソフトウェア展開ツールを使用して、多数のワークステーションにインストールすることが可能になります。

QAWeb Enterpriseエージェントの古いバージョンがすでにインストールされている場合、インストールプロセスによって自動的にアップグレードされます。 最初に古いバージョンをアンインストールする必要はありません。

QAWeb Enterpriseエージェントのインストールは2フェーズで実施します。この2フェーズとは、インストールとコンフィグレーションを指します。

  • ソフトウェアのインストール：エージェントがオペレーティングシステムにインストールされた状態にします。

  • エージェント設定：エージェントの設定をコンフィグレーションできます。

注釈

インストール後は、ソフトウェアを再インストールすることなく、異なるコンフィグレーションをいつでも適用できます。 例を挙げると、スタンドアロンモードでコンフィグレーションされたエージェントは、後で改めてコンフィグレーションしてオンラインモードで動作させることができます。

QAWeb Agentを*オンラインモード*で使用するためにインストールする場合は、以下に挙げる情報を手元に用意してください。

  • QAWeb Enterprise Portalを使用して、QAWeb Enterprise組織の** 組織 ID** および** 登録キー** を取得します。 これを使用して、インストールプロセスで、組織にワークステーションを登録します。

  • オンラインサービスへのアクセスにHTTPプロキシサーバーを使用する必要がある場合は、コンフィグレーションの詳細（サーバーのホスト名またはアドレス、ポート、ユーザー、パスワード）を用意してください。

注釈

QAWeb Enterprise Agentのインストールには** 管理者** 権限が必要です。 または、十分な権限を持つ承認されたユーザーであれば実行できます。 特別なトレーニングは必要ありません。

エージェントをインストールするソフトウェアのダウンロード

QAWeb Agentのソフトウェア最新バージョンは、QAWeb Enterprise Portalからダウンロードできます。

  1. ポータルにログインします（https://qaweb.healthcare.barco.com).

  2. ヘッダー メニューで [** 管理** ] をクリックします。

  3. ヘッダー メニューで [** マイ組織** ] をクリックします。

  4. [** ダウンロード** ] ボタンをクリックして QAWeb Enterprise Agent インストーラーをダウンロードします。

QAWeb Agentのソフトウェアは、Barcoのサポートページからダウンロードすることもできます（https://www.barco.com/support/qaweb-enterprise).このダウンロードではQAWeb Enterprise Portalへの登録が不要なので、エージェントを*スタンドアロンモード*のみで使用する場合に有用です）。

グラフィックインストールウィザードを使用したエージェントのインストール

qaweb-agent-installer.exe を実行してグラフィクインストールウィザードを起動します。

  1. 最初のページで、次へボタンをクリックします。

    ../../_images/agent_installer_welcome.png

  2. エンドユーザーライセンス契約（EULA）を確認します。

    ../../_images/agent_installer_EULA.png

  3. ソフトウェアのインストールが完了するまでお待ちください。

    ../../_images/agent_installer_in_progress.png

  4. [QAWeb Agent設定]のオプションが選択された状態で、[次へ]ボタンをクリックします。

第2フェーズで、コンフィグレーションウィザードを完了します。

  1. 動作モードを選択します。

    ../../_images/agent_configurator_select_mode.png

  2. HTTPプロキシサーバーの設定を構成します。 スタンドアロンモードが選択され、[更新の確認]と[匿名化された情報の共有]が両方選択されていない場合、この手順は省略されます。

    ../../_images/agent_configurator_proxy_config.png

  3. 組織キー と** 登録キー** を見つけるには、次の手順を実行します。 スタンドアロンモードが選択されている場合、この手順は省略されます。

    ../../_images/agent_configurator_registration_info.png

  4. 設定内容を確認します。

    ../../_images/agent_configurator_apply_confirm.png

  5. 最後の手順で、設定内容が適用されます。

    ../../_images/agent_configurator_finish_online.png

コマンドライン経由でのエージェントのインストール

コマンドラインインストールには、次の引数が必要です。

qaweb-agent-installer.exe /S /ORG <organization ID> /REGKEY <registrationkey>

すべてのオプションは大文字と小文字を区別します。

さらに、次のコマンドラインパラメーターを使用できます。

  • /MODE select the operating mode. Options: online/standalone/localserver (default: online).

  • /PROXY use a proxy server for the connection. Options: no/system/custom (default: no).

  • /PROXY_NAME hostname of the proxy server. (implies /PROXY custom).

  • /PROXY_PORT port number of the proxy server (implies /PROXY custom).

  • /PROXY_USR optional username for proxy authentication (implies /PROXY custom).

  • /PROXY_PWD optional password for proxy authentication (implies /PROXY custom).

  • /WORKSTATION_DETAIL_SHORTCUT to add a shortcut to the desktop to open the workstation detail window of the agent (default: no).

  • /SERVER to specify the hostname of the local server. (implies /MODE localserver).

  • /UPDATES enable periodic check for updates. Options: yes/no (default: yes). This is only applicable to standalone configurations.

  • /SHARE_DIAGNOSTICS enable periodic sharing of relevant info to improve our product. Options: yes/no (default: no). This is only applicable to standalone configurations.

  • /QAWEB1_ACTION specify the behavior when MediCal QAWeb Agent is found on the workstation. Options: abort/disable/uninstall (default: abort).

エージェントのアンインストール

エージェントのアンインストール方法には複数のオプションがあります。

  • [Windowsコントロール パネル]の[プログラムの追加と削除]で[QAWeb Enterprise Agent]のエントリーまでスクロールし、アプリケーションをアンインストールする。

  • インストールのディレクトリ（デフォルト：C:\Program Files\Barco\QAWeb）にある[アンインストール]アプリケーションを使用する。

警告

QAWeb Enterprise Agentをアンインストールすると、すべてのコンフィグレーションデータが削除されます。 削除されるデータは次のとおりです。

  • ローカルのコンフィグレーション

  • 個人設定

  • QAWeb Enterprise Portalへの登録（該当する場合）

  • ログファイル

コマンドライン経由でのエージェントのアンインストール

コマンドラインからエージェントをアンインストールするには、インストールディレクトリ内で以下のコマンドを使用します（デフォルト[C:\Program Files\Barco\QAWeb]）。

uninstall.exe /S

インストール後の手順

インストールと登録の手順が成功すると、QAWeb EnterpriseエージェントのアイコンがWindowsの通知領域に表示されます。 通知領域に常にこのアイコンが表示されるようにWindowsを構成することをお勧めします。

../../_images/agent_windows10_icons_in_taskbar.png

インストールと登録が成功した直後に、エージェントはいくつかのQAテストを開始し、ディスプレイ設定を適用する場合があります。 エージェントは、次のデフォルト値に基づいて実行するタスクを評価します。

  • ワークステーションに接続されているディスプレイは、デフォルトの使用を提供します (Barco ディスプレイモードに基づく)。

  • 35ルクスのデフォルトの周囲光値は、キャリブレーションおよびQAテスト中に反射周囲光を計算するために使用されます。

インストール後にエージェント設定を変更する

登録後でも、インストールディレクトリ（既定[C:\Program Files\Barco\QAWeb]）にある実行可能な** configurator.exe** を使用して変更できる設定がいくつかあります。 このアプリケーションを実行すると、インストーラーのコンフィグレーションフェーズが繰り返されます。 これで、以下の設定を再び適用できます。

  • 動作モードの切り替え（例：スタンドアロンからオンラインモードへの切り替え）。

  • エージェントを新しい組織に再登録します。

  • HTTPプロキシサーバーの設定変更。

    ../../_images/agent_configurator_proxy_config.png

  • ログレベルを変更して、技術的な問題を調査できます。

    ../../_images/agent_configurator_logging.png

  • デフォルトでは、エージェントがオペレーティングシステムの言語を使用する設定になっています。 一方、デフォルト以外の特定の言語を設定することもできます。

    ../../_images/agent_configurator_language.png

コンフィグレータは、次のように、コマンドラインパラメーターを通して使用することもできます。

  • --mode <mode> options: online/standalone/localserver

  • --server <hostname> The hostname of the local server (implies mode localserver)

  • --updates <yesOrNo> Periodically check for updates: yes / no (default: yes). Only applies to standalone mode.

  • --sharediagnostics <yesOrNo> Periodically check for updates: yes / no (default: no). Only applies to standalone mode.

  • --proxy <proxy> no / system / custom (default: no)

  • --proxyhost <host> Hostname of the proxy server (implies proxy custom)

  • --proxyport <port> Port number of the proxy server (implies proxy custom)

  • --proxyuser <user> the username needed for proxy authentication (if required) (implies proxy custom)

  • --proxypwd <password> the password needed for proxy authentication (if required) (implies proxy custom)

  • --regkey <key> Registration key (not applicable for mode standalone)

  • --org <organization> Organization ID (not applicable for mode standalone)

  • --sysprep Prepare the installation for ghost image creation

アップグレードとメンテナンス

QAWeb Enterprise Agentには、新しいバージョンがリリースされた場合ユーザーに通知する機能が搭載されています。 この通知をクリックすると、アプリケーションのアップデートが開始されます。

注釈

Barcoでは、エージェントの最新バージョンがリリースされたら速やかにアップデートを行うことを推奨しています。 アップデートでは、新機能のほかに、欠陥やセキュリティ上の脆弱性に対する修正が提供される場合があります。 Barcoのサポート部門より、適切なサポートを提供するために最新バージョンのインストールをお願いすることがありますのでご了承ください。

「ゴースト」について

「ゴースト」という言葉は、オペレーティングシステム全体およびインストールされているソフトウェアのイメージを作成し、エンドユーザーに信頼できる制御可能な環境を提供する雨、それらを別のワークステーションに適用 / 復元する方法を表します。

ワークステーションのゴースト画像を作成するときは、** sysprep** プロシージャを使用して最初にワークステーション固有のローカルデータを削除することが重要です。 これにより、エージェントの起動時に自動的に作成されるワークステーション固有の ID が削除されます。 sysprep プロシージャを省略すると、クローン化されたすべてのワークステーションに無効な ID が割り当てられ、オンラインサービス/サーバーに正しく接続できなくなります。

QAweb Enterprise エージェントを含むワークステーションのゴースト画像を正しく作成して配布するには、次の手順に従います。

  1. Barco の QAWeb Agent をシャットダウンします（Windows サービスを停止します）。

  2. configurator.exe--sysprep を実行します。

  3. ゴースト画像を作成します（Agent は再起動しません）。

  4. クローン化された各ワークステーションで、起動後に（グラフィカル ユーザーインターフェイスまたはコマンドライン引数を使用して） configurator.exe を実行し、エージェントをサーバーに登録します。