Hubのインストールのトラブルシューティング

次のセクションでは、インストール中かインストールが成功したかどうか検証しているときに特定の問題が生じる場合のガイダンスを紹介します。

メッセージブローカーのコネクティビティ

Webサーバーとメッセージブローカー間のコネクティビティを確認するには、RabbitMQ管理コンソールがWebブラウザーからアクセス可能であることを確認します。

接続に失敗する理由はいくつかあります。

  • ネットワークコネクティビティを検証する - すべての関連デバイスが同一ネットワークに接続され、通信できることを確認します。
  • ファイアウォール - サーバー自体またはネットワーク内のファイアウォールが通信を阻止していないことを確認します。

デフォルトでは、RabbitMQ管理コンソールはポート15672で通信します。メッセージブローカーキューでは、デフォルトで異なるポート、5672が使用されます。すべてのポートでファイアウォールのTCPアクセスを確認する必要があります。これは、特に、IT組織が非デフォルトポートを指定している場合に当てはまります。

データベースコネクティビティ

インストーラー内の［接続をテストして続行］ボタンで、以下を確認します。

  • データベースが存在する場合：
    • 接続できること。
    • アカウントにデータベースの読み取り、書き込み、編集の権限があること。
  • データベースが存在しない場合：
    • アカウントにデータベースを作成する権限があること。

これらの要件を満たすことができない場合、インストールは停止します。

LANでSQL Serverに接続できない場合、実行できるチェックが多数あります。

  • ネットワークコネクティビティを検証する - すべての関連デバイスが同一ネットワークに接続され、通信できることを確認します。
  • SQL認証情報 - SQL認証情報と、ユーザーがSQL Server上で適切な許可を持っていることを検証します。
  • ファイアウォール - サーバー自体またはネットワーク内のファイアウォールが通信を阻止していないことを確認します。
  • SQL Server Browserサービス - SQLインスタンスを検索できるようにSQL Server上のSQL Server Browserサービスが有効になっていることを確認します。SQL Server Expressの場合、このサービスは通常、デフォルトで無効です。
  • TCP/IPコネクティビティを許可 - リモートコネクティビティがSQLに必要な場合、SQLインスタンスに対してTCP/IPコネクティビティが有効になっていることを確認します。Microsoftは、SQLの各バージョンに特化した、SQL Serverに対してTCP/IPネットワークプロトコルを有効にするための手順を提示する記事を用意しています。

インストーラーの実行時に、データベースエラーでインストールプロセスが失敗した場合、以下を参照してください。その後、WebサーバーがデータベースとSQL接続できることを確認します。これは、上記の理由のいずれかが原因である可能性があります。

失敗の原因のもう1つの可能性は、インストーラー内のデータベースの作成に使用するアカウントが、データベースの作成に必要な権限を持っていないことです。

最後に、ソフトウェアの削除後にインストールが再インストールされた場合です。その後、同じデータベース名が使用されている場合は、元のデータベースをバックアップしてドロップしてから、再インストールする必要があります。

Webサーバー

インストールプロセス中、インストーラーはすべての前提条件が満たされていることを確認します。前提条件がインストールされていない場合は、インストーラーをキャンセルし、前提条件がインストールされてから、インストーラープロセスを再開することをお勧めします。

詳細については、「前提条件」を参照してください。

SqlServerモジュールを手動でインストールする

以下の手順を実行するには、Webサーバーの管理者許可が必要です。

  1. インターネットにアクセスできるマシンでインターネットブラウザーを起動し、Powershell GalleryサイトのSqlServerのページを開きます。
  2. ［インストールオプション］見出しで、［手動ダウンロード］を選択し、［未加工nupkgファイルをダウンロードする］をクリックします。
  3. sqlserver.*.nupkgファイルの名前をsqlserver.*.zipに変更し、Webサーバーに移動します。
  4. アーカイブを展開し、展開したフォルダーの名前をSqlServerに変更します。
  5. SqlServerフォルダーをProgramFiles/WindowsPowerShell/Modulesに移動します。

  6. Powershellを開き、次のコマンドを実行してモジュールが認識されたことを確認します。

    コピー 
    ((Get-Module -ListAvailable) | Where-Object { $_.Name -match 'SqlServer' })

    コマンドからの出力にSqlServerモジュールに関する情報が含まれている場合は、SqlServerモジュールがインストールされ、サーバーに認識されています。

IMS Webサイトを起動する

インストールの完了後、IMS Webサイトの起動時に「0x8007000dのHTTPエラー500.19」が表示された場合は、.NET Coreコンポーネントの.NET Core 3.1.3 Windows Server Hostingを修復または再インストールする必要があります。このコンポーネントのファイルはdotnet-hosting-3.1.3-win.exeです。

File Service

File ServiceがIMS およびHubのイメージを検索できない場合、これはBlue Prism製品のアンインストールと再インストールが原因です。この問題は、初回インストールでは発生しません。

削除処理中は、データベースは削除されないため、再インストールで同じデータベース名が使用されている場合は、File ServiceとURLへの元のパスが使用されます。

これを回避するには、削除プロセスの実行後にデータベースを削除またはクリーンアップして以前のパスを削除するか、再インストール時に代替のデータベース名を使用します。

Windows認証

インストールを実行するアカウントには、インストールを実行するために関連SQL Serverの許可が必要です。つまり、sysadminまたはdbcreatorの固定サーバー役割のメンバーシップです。

インストールプロセス中にWindows認証の使用を選択した場合は、Windowsサービスアカウントと必要な許可を設定して、タスクを実行し、通常の操作中に操作することをお勧めします。

このサービスアカウントには、SQLデータベース作成プロセスを実行する機能が必要です。「最小限必要なSQLの権限」「」を参照してください。また、IISアプリケーションプールに対する所有権も必要です。

デフォルトでは、アプリケーションプールは「ApplicationPoolIdentity」というIDで作成されます。インストーラーの完了後、確立されたサービスアカウントに、アプリケーションプールを管理する許可を割り当てる必要があります。

Audit Serviceに問題がある場合は、Windowsサービスアカウントに監査サービスリスナーと監査データベースへのアクセス権があることを確認します。

HubでSMTP設定が構成できない

HubでSMTP設定を構成できない場合、これは通常、サービスの起動順序に関連しています。

RabbitMQサービスがすべて起動した後、Webサーバーを起動する必要があります。RabbitMQサービスの準備が整う前にWebサーバーサービスが開始した場合、HubのSMTP設定に進むと「問題が発生しました」というメッセージが表示されます。

インストール後に顧客IDを更新する

インストール後に顧客IDを入力または更新する必要がある場合は、License Managerのappsettings.json構成ファイルを更新する必要があります。構成ファイルが更新されたら、License ManagerをInternet Information Services（IIS）マネージャーで再起動する必要があります。

appsetting.jsonファイルで顧客IDを更新するには：

  1. Windows Explorerを開き、C:\Programs (x86)\Blue Prism\LicenseManager\appsettings.jsonに移動します。

    これはデフォルトのインストール場所です。カスタムの場所を使用した場合はその場所に移動します。

  2. appsettings.jsonファイルをテキストエディターで開きます。

  3. ファイルのLicense:CustomerIdセクションを見つけて、新しい顧客IDを入力します。例:

    コピー 
    "License": {
        "CustomerId": "your-Customer-ID-here"
    }
  4. ファイルを保存します。

License Managerを再起動するには：

  1. Internet Information Services（IIS）マネージャーを開きます。

  2. 接続のリストで、Blue Prism - License Managerを選択します。

    これはデフォルトのサイト名です。カスタムサイト名を使用している場合は、適切な接続を選択します。

  3. ［Webサイトの管理］コントロールで［再起動］をクリックします。

    License Managerが再起動します。