Install Blue Prism Interact

The steps below detail the process for installing the Blue Prism Interact software. This assumes that Blue Prism Hub has been installed which includes the Authentication Server, Hub, and other associated services.

Download and run the Blue Prism Interact installer, available from the Blue Prism Portal, and progress through the installer as shown below. The installer must be run with administrator rights.

To watch the Interact installation and configuration process, see our Blue Prism Interact installation video.

Step

Installer page

Details

1

Welcome

If required, select another language for the installer from the drop-down list. The default language is English (United States).

Click Next.

2

License agreement

Read the End-User License Agreement and if you agree to the terms, select the check box.

3

Product prerequisites

The installer checks that the prerequisites have been installed. If the installer finds any prerequisites missing these will be notified to you. Otherwise, continue with the installation.

You cannot proceed unless all prerequisites have been installed.

4

Destination folder

Specify the required installation folder. The default location is C:\Program Files (x86)\Blue Prism, but you can choose your own using the Change button.

5

Configure Interact SQL configuration

Configure the settings for the Interact Database by providing the SQL Server host name or IP address, and the credentials for the account to create the database:

  • If Windows Authentication is selected, the account must have the appropriate permissions. See Installing Interact using Windows Authentication for further information.
  • If SQL Authentication is selected, enter the username and password.

    You must ensure that your database password does not contain an equals sign (=), semi‑colon (;), or speech marks ("). These characters are not supported, and will lead to issues when trying to connect to the database.

Click Test connection to proceed to test the SQL credentials and verify connectivity.
A notification will display the result of the test. You will only be able to move on to the next step if the test is successful
. If the test failed, see Troubleshoot an Interact installation for further details.

6

Interact IIS setup

Configure the Interact website.

You need to:
  • Enter a site name.
  • Enter a host name – This will be used as the URL for the site. Ensure that you consider your DNS and Domain structure when choosing a host name.

  • Enter the port number.
  • Select the appropriate SSL certificate.
  • Leave Start Website selected, unless you do not want the website to automatically start at the end of the installation.

The Next button is only activated if the URL you have entered matches the one configured in the certificate.

7

Interact Remote API setup

You need to:
  • Enter a site name.
  • Enter a host name – This will be used as the URL for the site. Ensure that you consider your DNS and Domain structure when choosing a host name.

  • Enter the port number.
  • Select the appropriate SSL certificate.
  • Leave Start Website selected, unless you do not want the website to automatically start at the end of the installation.

The Next button is only activated if the URL you have entered matches the one configured in the certificate.

8

IADA IIS setup

You need to:
  • Enter a site name.
  • Enter a host name – This will be used as the URL for the site. Ensure that you consider your DNS and Domain structure when choosing a host name.

  • Enter the port number.
  • Select the appropriate SSL certificate.
  • Leave Start Website selected, unless you do not want the website to automatically start at the end of the installation.

The Next button is only activated if the URL you have entered matches the one configured in the certificate.

9

Configure IADA SQL configuration

Configure the settings for IADA by providing the SQL Server host name or IP address, and the credentials for the account to create the database:

  • If Windows Authentication is selected, the account must have the appropriate permissions. See Installing Interact using Windows Authentication for further information.
  • If SQL Authentication is selected, enter the username and password.

    You must ensure that your database password does not contain an equals sign (=), semi‑colon (;), or speech marks ("). These characters are not supported, and will lead to issues when trying to connect to the database.

The database name can be left as the default value or changed as required.

Click Test connection to proceed to test the SQL credentials and verify connectivity.
A notification will display the result of the test. You will only be able to move on to the next step if the test is successful
. If the test failed, see Troubleshoot an Interact installation for further details.

10

Ready for Installation

Click Next to install Interact.

11

Installation complete

If the installation fails, the View Log option gives details of the error that was encountered.

For more information, see Troubleshooting an installation.

Click Finish.

Configure application pool recycling

The application pools for Authentication Server and Interact should be set to recycle one after the other, with Authentication Server recycling first. You should configure the application pools to recycle at a specific time during non-working hours, or periods of low usage. The application pool for Authentication Server should be set to recycle at least 10 minutes before the Interact application pool.

There are several different methods you can use to set the recycling information. The steps below use the Internet Information Services (IIS) Manager:

  1. In the Internet Information Services (IIS) Manager, right-click the appropriate application pool and select Recycling….
  2. Clear the Regular time intervals (in minutes) option.
  3. Select the Specific time(s) option and enter a time into the field:

    • For the Blue Prism - Interact application pool, set it to use a specific time during non-working hours, or periods of low usage.
    • For the Blue Prism - Authentication Server application pool, set it to use a specific time at least 10 minutes before the Interact application pool time.
  4. Click Next, and then click Finish.