Install the Smart Previews Hybrid Component

NOTE: The information you provide must be entered in the proper case or the installation will fail.

How to Install the Smart Previews Hybrid Component

Use the following instructions to install the Smart Previews Hybrid component:

  1. Open a Command Prompt as administrator.
  2. Navigate to your Smart Previews Hybrid installation directory.

    • For example: "cd C:\BA Insight\<smartpreviewshybrid_folder>"

  3. Run the following msiexec command using the full path to your installation directory:
    • For example:
      C:\Program Files\BA Insight\Smart Previews Hybrid>msiexec /i "Smart Previews Hybrid.msi"
  4. The wizard launches:


  5. During installation, the following information is required:

Field

Description

<InstallDir>

Specify the path where the Smart Previews site will be installed.

<Port>

  • This port is used to run the website for the Smart Previews Hybrid site.

  • For example, port 8090 is often available.

<Certificate FriendlyName>

  • Specify the certificate-friendly name used to set the SSL binding for this site.

  • The certificate must be installed in the Local Certificate Store, under Personal.

  • This friendly name must be associated with an certificate that is imported with a private key (.pfx) file.

<ServiceAccount>

Specify the User Name and the Password that is required to run the Smart Previews Hybrid site.

  • This user must have both READ and WRITE permissions to the Smart Previews Configuration Database.

    • User Name: The User Name must be filled in using the following format: Domain_Name\User_Name.
    • Password: Enter the password associated with the User Name.

Configure the Hybrid Component

  1. Navigate to the IIS Manager, expand the Smart Previews Hybrid site, and select the Pages folder.
  2. Click Content View.


  3. Go to Smart Previews > Pages > Configure.aspx.
  4. Open the page Configure.aspx.
    1. Note that depending on your environment, you may need to launch your browser as an Administrator to reach the Configure.aspx page.
  5. Use the information in the table below to fill in these fields.

Field

Description

<Certificate Friendly Name>

Specify the certificate friendly name to be used to secure the requests coming from the Smart Previews Web Resources website.

Note: If you already have a certificate that meets the criteria below, use it instead of generating a new self-signed certificate.

To generate a new self-signed cert:

  1. Click on the Generate button to create a self-signed certificate.
    • The certificate is used to secure the requests coming from the Smart Previews Web Resources website.
  2. The certificate will be installed on the local computer under the Trusted Root Certification Authorities folder.
  3. The certificate is imported using a private key.
  4. This is NOT an HTTPS/SSL certificate.
    • This is a separate, new certificate to ensure that requests from only the Smart Preview Web Resource component are accepted.
Note: Ensure that the value of the issued-to property of the certificate is valid for the server where you are installing the Smart Previews Hybrid component.

<Database Connection String>

  • This is the connection string for the Smart Previews Configuration database.

  • You can find this information in: Smart Previews Web Admin console→ Manage databases.

  • For example:

   Server=servername;Database=ConfigurationDatabaseName;Trusted_Connection=True;

<Preview Generation Service Address>

  • Specify the Previews Generation Service address (URL)

    • servername in the URL below, can be the address to any server where the Smart Preview Import Server is installed.

    • For example:
         http://servername:1238/PreviewGeneratorService

<Fetchers>

  • Fetchers are used by the Preview on-demand process.

  • This field can be left blank during installation and configured later.

  • For more information, see How to Add On-Demand Previews.