HubとInteractをアップグレードする

HubとInteractのアップグレードは、専用ツールを使用するシンプルなプロセスです。現在使用しているバージョンから、次の順序でアップグレードツールを実行する必要があります。

• 4.0から4.1にアップグレードします。
• 4.1から4.2にアップグレードします。
• 4.2から4.3にアップグレードします。
• 4.3から4.4にアップグレードします。
• 4.4から4.5にアップグレードします。
• 4.5から4.6にアップグレードします。
• 4.6から4.7にアップグレードします。

アップグレードが完了したらHubにログインし、CTRL + F5を押してキャッシュをクリアするようユーザーに指示します。これにより、すべてのWebページが更新され、ユーザーインターフェイスの変更が確実に更新されます。

HubとInteract 4.0をバージョン4.1にアップグレードする

営業時間外にアップグレードを実行するようスケジュールを立てることをお勧めします。

前提条件

• HubとInteractのバージョン4.0がインストールされている。

• 全員がIMSサーバーからログアウトしている。

• すべての関連データベースをバックアップ済み。データベースはアップグレードの影響を受けませんが、アップグレードを実行する前にデータベースをバックアップすることをお勧めします。

アップグレーダーは、アップグレードプロセスの一環として実行中のWebサイトを自動的に停止します。手動で停止する必要はありません。

アップグレード手順

1. バージョン4.0から4.1用のBlue Prism InteractおよびHubアップグレーダーをBlue Prismポータルからダウンロードします。
2. アップグレーダーを実行し、指示に従います。

3. アップグレーダーが完了したら、Hubにログインし、プラグインリポジトリを開きます。

   リポジトリには、現在インストールされているバージョンと使用可能なバージョンの詳細が表示され、更新できるプラグインがあることが示されます。

4. ［すべて］チェックボックスをオンにして、［更新を完了］をクリックします。

   選択したプラグインの新しいバージョンがインストールされ、バージョン4.1へのアップグレードが完了します。
   

5. Hubがインストールされているすべてのマシンで、このプロセスを繰り返します。

HubとInteract 4.3をバージョン4.4にアップグレードする

HubとInteract 4.4をバージョン4.5にアップグレードする

HubとInteract 4.5をバージョン4.6にアップグレードする

このアップグレードの一環として：

• Windows認証機能がIISにインストールされ、Authentication ServerのWebサイトに適用されます。
• RabbitMQで新しいキューが作成されます。古いキューを手動で削除する必要があります。

• Blue Prism API URLがWebサーバー構成ファイルから削除されます。これにより、Control RoomがBlue Prismと通信できなくなります。Control Roomを引き続き使用するには、Hubに管理者としてログインし、［環境管理］ページの［API構成］セクションにこのURLを再度入力する必要があります。

  http://やhttps://など、プロトコルを含むURLの全体を入力する必要があります。例：https://bpapi.yourdomain.com

営業時間外にアップグレードを実行するようスケジュールを立てることをお勧めします。

前提条件

• HubとInteractのバージョン4.5がインストールされている。
• 全員がAuthentication Serverからログアウトしている。
• すべての関連データベースをバックアップ済み。データベースはアップグレードの影響を受けませんが、アップグレードを実行する前にデータベースをバックアップすることをお勧めします。
• 2.5 GBの空きディスク領域 - インストールプロセスが完了するまで作成されるバックアップに必要です。以前のアップグレードからバックアップを削除します。

アップグレーダーは、アップグレードプロセスの一環として実行中のWebサイトを自動的に停止します。手動で停止する必要はありません。

アップグレード手順

1. HubとInteractサイトのすべてのアプリケーションプールを停止します。

2. RabbitMQを開き、以下から始まるすべてのキューを削除します。

   • BPC.*
   • Connect.*
   • ImsServer.*
   • Interact.*
3. バージョン4.5から4.6用のBlue Prism InteractおよびHubアップグレーダーをBlue Prismポータルからダウンロードします。

4. HubとInteract 4.5がインストールされているマシンのインストーラーを解凍します。これには、次の2つのファイルが含まれています。

   • Blue Prism Interact and Hub Upgrader.exe – アップグレーダー実行可能ファイル。
   • BluePrismHubAndInteractUpdate4.6.bin – 4.6へのアップグレードに必要なバイナリファイル。

   これらのファイルは同じディレクトリに保存する必要があります。

5. 実行可能なアップグレーダーをダブルクリックしてアップグレーダーウィザードを起動し、［HubとInteractのアップグレーダーへようこそ］画面で［次へ］をクリックします。
6. ［使用許諾契約書（EULA）］画面で使用許諾契約書（EULA）を読み、条件に同意する場合は、チェックボックスを選択して［次へ］をクリックします。
7. ［4.6へのアップグレード準備完了］画面で、［次へ］をクリックしてHubとInteractを4.6にアップグレードします。

8. ［Blue Prism HubとBlue Prism Interactのアップグレードを完了］画面で、以下を行います。

   • アップグレードが正常に完了したら、［終了］をクリックします。

   • インストールが失敗した場合は、［ログを表示］オプションに、発生したエラーの詳細が表示されます。詳細は、「アップグレードのトラブルシューティング」を参照してください。

9. HubとInteractがインストールされているすべてのマシンで、このプロセスを繰り返します。
10. Blue Prism APIを使用している場合は、管理者としてHubにログインし、［環境管理］ページでAPI URLを入力します。

プラグインは、アップグレードプロセスの一環として、自動的に最新バージョンに更新されます。

HubとInteract 4.6をバージョン4.7にアップグレードする

このアップグレードではBlue Prism Hub、Blue Prism Interact、および次の.NETコンポーネントを使用するサポートサイトが更新されます。

• .NET Desktop Runtime 6.0.9または6.0.10

• ASP.NET Core Runtime 6.0.9または6.0.10（Windowsホスティングバンドル）

• .NET Framework 4.8 – Windows Server 2022にデフォルトでインストールされています。

このアップグレードではSSL暗号化要件も徹底されます。詳細については、「 」を参照してください。

営業時間外にアップグレードを実行するようスケジュールを立てることをお勧めします。

前提条件

• HubとInteractのバージョン4.6がインストールされている。

• 全員がAuthentication Serverからログアウトしている。

• すべての関連データベースをバックアップ済み。データベースはアップグレードの影響を受けませんが、アップグレードを実行する前にデータベースをバックアップすることをお勧めします。

• Hubおよび/またはInteractのインストール先サーバーに2.5GBの空きディスク領域 - インストールプロセスが完了するまで作成されるバックアップに必要です。以前のアップグレードからバックアップを削除します。

• SQL ServerはSSL暗号化を使用するように構成する必要があります。所属組織がSSL暗号化をまだ使用していない場合（SQL Serverの環境を証明書なしで実行しているか、自己署名証明書を使用している）、組織は信頼できる証明局から証明書を取得し、SQL Serverにインポートして有効にする必要があります。‑詳細については、「Microsoftドキュメント」を参照してください。

  SQL ServerにSSL暗号化を使用したことがない場合は、アップグレーダーを実行する前に、Blue Prismアプリケーションのアプリケーション設定ファイルの接続文字列を更新する必要があります。詳細については、「 」を参照してください。

  本番環境では、信頼できる証明局からの証明書を使用します。ただし自己署名証明書は概念実証または開発環境に使用できます。重要なのは、SQL Serverが使用するFQDNが証明書で定義されるFQDNと一致することです。これらが一致しない場合、データベースへの接続が確立されずインストールが正しく機能しません。自己署名証明書の使用と構成については、Blue Prism Hubインストールガイドの「自己署名証明書」「」を参照してください。

  証明書をSQL Serverにインポートするには：

  1. Windowsタスクバーから［SQL Server構成マネージャー］を開きます。

  2. SQL Server構成マネージャーで［SQL Serverネットワークの構成］を展開し、［<SqlServerInstanceName>のプロトコル］を右クリックして［プロパティ］をクリックします。

  3. ［<SqlServerInstanceName>のプロトコルのプロパティ］ダイアログで、［証明書］タブを選択し、必要な証明書を選択またはインポートします。

  4. ［適用］をクリックします。

アップグレーダーは、アップグレードプロセスの一環として実行中のWebサイトを自動的に停止します。手動で停止する必要はありません。

アプリケーション設定を更新する

SQL ServerにSSL暗号化を使用したことがない場合にのみ、Blue Prismアプリケーションのappsettings.jsonファイルを更新する必要があります。アプリケーション設定は、Blue Prismが作成したスクリプトを使用して、または手動で更新できます。

スクリプトを使用してアプリケーション設定を更新するには：

1. SQL Serverに証明書をインポートします。詳細については、「 」を参照してください。
2. Blue Prism Data Protectorをまだお持ちでない場合は、Blue Prismポータルからダウンロードして、HubまたはInteract Webサーバーに保存します。この手順が完了したら、削除できます。
3. アプリケーション設定スクリプト（update‑connectionStrings.ps1）をまだお持ちでない場合は、Blue Prismポータルからダウンロードして、HubまたはInteract Webサーバーに保存します。

4. 管理者としてPowerShellを開き、update‑connectionStrings.ps1スクリプトを実行します。プロンプトが表示されたら、次の情報を入力します。

   1. installationDirectory – Hubがインストールされている場所のディレクトリパスを入力し、Enterキーを押します。たとえば、デフォルトのインストール場所が使用されている場合、パスはC:\Program Files (x86)\Blue Prismです。

   2. sqlSource – SSL証明書の作成時に使用したSQL Server名を入力し、Enterキーを押します。

   3. dataProtectorPath – Blue Prism Data Protectorへのフルパスを入力し、Enterキーを押します。たとえば、C:ドライブに直接保存する場合は、C:\BluePrismDataProtector.Console.exeと入力します。

   4. interactInstallationDirectory – Interactがインストールされている場所のディレクトリパスを入力し、Enterキーを押します。たとえば、デフォルトのインストール場所が使用されている場合、パスはC:\Program Files (x86)\Blue Prismです。Interactがまだインストールされていない場合は、情報を入力せずにEnterキーを押します。

   スクリプトが実行され、アプリケーション設定の接続文字列がSQL Serverの新しい値で更新されます。

5. HubとInteractがインストールされているすべてのマシンで、このプロセスを繰り返します。

アプリケーション設定を手動で更新するには：

1. SQL Serverに証明書をインポートします。詳細については、「 」を参照してください。
2. Blue Prism Data Protectorをまだお持ちでない場合は、Blue Prismポータルからダウンロードします。
3. BluePrismDataProtector.Console.exeがあるフォルダーで、管理者としてPowerShellを開きます。このツールを使用してappsettings.jsonファイルの接続文字列を更新します。このツールの使用に関する詳細については、「Blue Prism Data Protectorツール」を参照してください。

4. HubとInteract Webサーバーで次のファイルに移動し、以下のコードスニペットで提示されるセクションを見つけます。

   以下に示すファイルパスはデフォルトのインストール場所です。アプリケーションを別のフォルダーにインストールした場合は、そのフォルダーに移動してください。

   C:\Program Files (x86)\Blue Prism\Audit Service\appsettings.json

   コピー

   "ConnectionStrings": {
           "AuditServerConnection": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Audit Service Listener\appsettings.json

   コピー

   "ConnectionStrings": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Authentication Server\appsettings.json

   コピー

   "ConnectionStrings": {
           "IdentityServerConnection": <Replace the string here>
   "Storage": {
        "Type": "Database",
         "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Email Service\appsettings.json

   コピー

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\File Service\appsettings.json

   コピー

   "Storage": {
           "Type": "Database",
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Hub\appsettings.json

   コピー

   "Data": {
         "Connect": {
           "ConnectionName": "Connect",
           "ConnectionString": <Replace the string here>
           
         "BluePrismDecision": {
           "ConnectionName": "BluePrismDecision",
           "ConnectionString": <Replace the string here>        
   
   "DistributedCache": {
     "Type": "Database",
     "DefaultExpirationMinutes": 0,
     "SqlServer": {
       "ConnectionString": <Replace the string here>
       
   "Storage": {
     "Type": "Database",
     "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\IADA\appsettings.json

   コピー

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Interact\appsettings.json

   コピー

   "InteractDatabases": {
         "InteractConnectionString": <Replace the string here>
         
   "DistributedCache": {
     "Type": "Database",
     "DefaultExpirationMinutes": 0,
     "SqlServer": {
       "ConnectionString": <Replace the string here> 

   C:\Program Files (x86)\Blue Prism\Interact Remote API\appsettings.json

   コピー

   "InteractRemoteDatabases": {
           "InteractConnectionString": <Replace the string here>
           
   "InteractRemoteStorage": {
       "Type": "Database",
       "ConnectionString":    <Replace the string here>

   C:\Program Files (x86)\Blue Prism\License Manager\appsettings.json

   コピー

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Notification Center\appsettings.json

   コピー

   "Database": {
           "ConnectionString": <Replace the string here>

   C:\Program Files (x86)\Blue Prism\Submit Form Manager\appsettings.json

   コピー

   "SubmitFormManagerDatabases": {
           "InteractConnectionString": <Replace the string here>

5. これらのファイルそれぞれについて、次の操作を行います。

   1. Blue Prism Data Protectorツールを使用して接続文字列を復号し、一時テキストファイルにコピーします。例：

      コピー

       "InteractDatabases": {
            "InteractConnectionString": "CfDJ8MILtsx8cQBOrqrAatl5A1aLmLP1GodoFWTnhvaHwh0ryabXaXW2i-KTfsq2XTYuAzct_ZXIFS3ILFv4Zu5ozmtvHv9aOLCxZjQJEUm7Ytwx8dK1Zqapywv2s5TCoi4X_9MGselkrRmbknBuQ_zWE93ozrNlBUVCQNHVedkyjTTPmPnxyeIgJJdoZRbkKOupnSrJwTt95SCmvo2SLLhZZFR5e2s24smn72PKNGrga8fksbIDpalDFwRc-i6_kkEinp5qA-FBFfIbVZzBD5ZN1dyuaC2jM7V4dxKt5tea1NP-_vauczgCLBp88WdmNEe0Ew"

      次のようになります。

      コピー

      "InteractDatabases": {
            "InteractConnectionString": "Data Source=existed-name-without-certificate; Initial Catalog=Interact; User Id=sa; Pass=Pass***; Max Pool Size=500; Encrypt=False; MultiSubnetFailover=True" 

      上記ステップ4の例は、設定の場所を説明するために、appsettings.jsonファイルから抽出したものを示しています。復号と暗号化はこれらのコード例にも示されているとおり、設定ではなく、接続文字列設定でのみ実行されます。

      接続文字列のData Sourceのみを更新する必要があります。接続文字列設定の他のパラメーターは変更しないでください。アップグレードスクリプトは、Encryptパラメーターの更新など、実行時に必要な変更を行います。

   2. コピーした接続文字列で、Data Sourceパラメーターの値を証明書の名前に置き換えます。例：

      コピー

      "InteractDatabases": {
            "InteractConnectionString": "Data Source=name-with-certificate; Initial Catalog=Interact; User Id=sa; Password=Pass***; Max Pool Size=500; Encrypt=False; MultiSubnetFailover=True" 

      証明書名はSQL Server構成マネージャーで確認できます。

      1. SQL Server構成マネージャーで［SQL Serverネットワークの構成］を展開し、［<SqlServerInstanceName>のプロトコル］を右クリックして［プロパティ］をクリックします。
      2. ［<SqlServerInstanceName>のプロトコルのプロパティ］ダイアログで、［証明書］タブを選択します。証明書名は［発行先］フィールドに表示されます。短い名前の後に共通名（通常はFQDN）が続く形式で表示されます。いずれの名前もデータソースとして使用できますが、両方の名前がある場合は、共通名（FQDN）を使用することをお勧めします。
      3. オプションとして、［表示］をクリックして［サブジェクト代替名］を選択すると、さらに詳細を確認できます。名前はフィールドの下のテキスト領域に表示されます。

   3. Blue Prism Data Protectorツールを使用して新しい接続文字列を暗号化し、この新しい値でappsettings.jsonファイルの文字列を上書きします。

   接続文字列の復号と暗号化の詳細については、「Blue Prism Data Protectorツール」を参照してください。

6. IISマネージャーを開き、適切なアプリケーションプールを再起動して、新しい接続文字列を使用していることを確認します。

7. HubとInteractがインストールされているすべてのマシンで、このプロセスを繰り返します。

アップグレード手順

1. Blue Prism HubとBlue Prism Interact 4.7には.NET Core 6.0と.NET Framework 4.8が必要です。これらのバージョンがない場合は、HubまたはInteract Webサーバーを更新する必要があります。

   ステップ	詳細	動画
   1	次のコンポーネントをダウンロードし、C:\\tempなどの一時的な場所に保管します。 ASP.NET Core Runtime 6.0.9または6.0.10（Windowsホスティングバンドル） https://dotnet.microsoft.com/download/dotnet/6.0 – 必要なバージョンを選択します。ASP.NET Core Runtimeで、ホスティングバンドルを選択します。 .NET Desktop Runtime 6.0.9または6.0.10 https://dotnet.microsoft.com/download/dotnet/6.0 – 必要なバージョンを選択します。.NET Desktop Runtimeで、適切なダウンロードを選択します。 .NET Framework 4.8 https://support.microsoft.com/en-us/topic/microsoft-net-framework-4-8-offline-installer-for-windows-9d23f658-3b97-68ab-d013-aa3c3e7495e0 これはWindows Server 2022にデフォルトでインストールされます。Windows Server 2016 DatacenterまたはWindows Server 2019を使用している場合、.NET Frameworkのみをインストールする必要があります。	上記の動画はビジュアルガイドとしての役割に限定されます。この動画に含まれる.NET のバージョンは、実際に必要なバージョンとは異なる場合があります。
   2	.NET依存関係をインストールするには、PowerShellコマンドプロンプトを使用して次の各コマンドを実行し、各コマンドが完了するまで待機してから、次のコマンドを実行します。 Windows Server 2016およびWindows Server 2019の場合： コピー start-process "C:\temp\dotnet-hosting-6.0.0-win.exe" /q -wait start-process "C:\temp\windowsdesktop-runtime-6.0.0-win-x64.exe" /q -wait start-process "C:\temp\ndp48-x86-x64-allos-enu.exe" /q -wait Windows Server 2022（デフォルトで.NET Frameworkがインストール済み）の場合： コピー start-process "C:\temp\dotnet-hosting-6.0.0-win.exe" /q -wait start-process "C:\temp\windowsdesktop-runtime-6.0.0-win-x64.exe" /q -wait ファイル名とファイルパスが、手順1で保存したファイルと一致していることを確認します。
   3	Blue Prism Hubをインストールする前にサーバーを再起動し、コンポーネントが完全にインストールされ、登録されていることを確認します。

   このインストール手順を視聴するには、.NETのインストールビデオを参照してください。

2. バージョン4.6から4.7用のBlue Prism InteractおよびHubアップグレーダーをBlue Prismポータルからダウンロードします。

3. HubとInteract 4.6がインストールされているマシンのインストーラーを解凍します。これには、次の2つのファイルが含まれています。

   • Blue Prism Interact and Hub Upgrader.exe – アップグレーダー実行可能ファイル。
   • BluePrismHubAndInteractUpdate4.7.bin – 4.7へのアップグレードに必要なバイナリファイル。

   これらのファイルは同じディレクトリに保存する必要があります。

4. 実行可能なアップグレーダーをダブルクリックしてアップグレーダーウィザードを起動し、［HubとInteractのアップグレーダーへようこそ］画面で［次へ］をクリックします。

   アップグレーダーは手順1の前提条件ソフトウェアがインストールされていることを確認します。インストールされていない場合は前提条件画面が表示され、インストーラーを閉じて手順1を実行する必要があります。

5. ［使用許諾契約書（EULA）］画面で使用許諾契約書（EULA）を読み、条件に同意する場合は、チェックボックスを選択して［次へ］をクリックします。
6. ［4.7へのアップグレード準備完了］画面で、［次へ］をクリックしてHubとInteractを4.7にアップグレードします。

7. ［Blue Prism HubとBlue Prism Interactのアップグレードを完了］画面で、以下を行います。

   • アップグレードが正常に完了したら、［終了］をクリックします。

   • インストールが失敗した場合は、［ログを表示］オプションに、発生したエラーの詳細が表示されます。詳細は、「アップグレードのトラブルシューティング」を参照してください。

8. HubとInteractがインストールされているすべてのマシンで、このプロセスを繰り返します。

プラグインは、アップグレードプロセスの一環として、自動的に最新バージョンに更新されます。

Interact API VBOをアップグレードする

Interact API VBOは、Blue Prismインタラクティブクライアント内で使用され、Interactがアップグレードされたときに利用可能なInteract APIサービス内の新しい機能を利用するために個別に更新されます。最新バージョンのVBOは、Blue PrismポータルのInteract API Serviceリリースzipファイルで入手できます。

VBOのアップグレードに必要なのは、ユーティリティ - Interact VBOのアップデートだけです。

1. Blue PrismポータルからInteract APIサービスのリリースファイルをダウンロードします。
2. Interact APIサービスのリリースファイルを解凍します。

3. Blue Prismインタラクティブクライアントで、［ファイル］ > ［インポート］ > ［リリース/スキル］の順に選択します。

   ［入力ファイルを選択］画面が表示されます。

4. ［参照］をクリックし、抽出したInteract APIリリース.bpreleaseファイルを選択してから、［次へ］をクリックします。

   ［インポートの競合を解決］画面が表示されます。

5. ［解決策］列で、次の操作を実行します。

   1. ユーティリティ - Interact APIの設定を既存のビジネスオブジェクトに上書きしたままにします。

   2. 他のすべてのコンポーネントの設定を［このビジネス オブジェクトをインポートしない］に変更します。

6. ［次へ］をクリックします。

   ［プロセスログの概要］画面が表示されます。

7. ユーティリティ - Interact APIのみがインポート用にリストされていることを確認します。もし、

   • その他のコンポーネントがリストされている場合は、［戻る］をクリックし、上記の手順5で説明したように設定を変更します。
   • これが唯一のコンポーネントなら、［次へ］をクリックしてインポートを完了します。

8. ［終了］をクリックします。

アップグレードのトラブルシューティング

アップグレード後、InteractまたはHubにログインしようとすると、IISでSignalRのWebサーバーのオーバーロードに関するエラーが表示されます。  

このエラーはごくまれにしか発生しませんが、発生した場合はサイトを再ロードし、IISでアプリケーション プールを再起動します。

アップグレードプロセス中にインストールをキャンセルしましたが、エラーが表示されます。

アップグレードプロセス中は、インストールをキャンセルしないことをお勧めします。ただし、エラーが表示されてもロールバックは正常に完了します。