Install the Smart Previews Web Resources

Deploy the Package in IIS

On the server that will host the Smart Previews Web Resources site, create a new folder called "Web Resources."

This can be the same server that hosts the Smart Previews Hybrid component.

  1. Extract the contents of SmartPreviewsFrontEnd-*.zip to your "Web Resources" folder.

    Service Account

    Your Smart Previews Service account requires full control security permissions to the Web Resources folder.

  2. Navigate to IIS and create a new site that points to the folder that you created in the previous step.


  3. Right-click on Sites and select Add Website....


  4. Site name 
    1. Enter "Smart Previews Web Resources."
  5. Application pool 
    1. Choose (or create) an application pool
  6. Physical path 
    1. Enter the path to the Smart Previews "Web Resources" folder from step 1
  7. Type 
    1. Select https
    2. Only AFTER selecting https does the SSL certificate field appear
  8. Port 
    1. Enter a port for the application.
    2. The example above uses port 8443.
  9. SSL certificate 
    1. Enter a valid certificate to be used for the HTTPS protocol.

Verify Application Pool Permissions on the Installation Folder

The following instructions verify the Identity and permissions of the Application Pool configured above.

  1. In IIS, select the Application Pools as shown in the graphic below.


  2. The user shown in the Identity column must have READ/WRITE permissions to the Smart Previews Web Resources folder created in step 1.
  3. If you use the default ApplicationPoolIdentity user, you must grant READ/WRITE permissions to the auto-generated IIS user named "IIS APPPOOL\Smart Previews Web Resources"
NOTE: The auto-generated IIS user can be found in the local VM location.

Configure the Smart Previews Hybrid Component

Use the following steps to configure the Smart Previews Hybrid Component.

  1. Navigate to the Smart Previews Hybrid web site folder.
  2. Edit the web.config file.
  3. Locate the section appSettings\CloudServiceAddress.
    1. Replace the sample server address with your Smart Previews Web Resources URL, including the port number.
    2. You must include the path …./Services/PreviewProxyService.svc in your edited URL.

      1. Example:

        1. Default: https://previewapp.bainsight.com/Services/PreviewProxyService.svc 

        2. After editing: https://webresources:4321/Services/PreviewProxyService.svc

Configure the Smart Previews Web Resources Site

  1. Navigate to the folder where you extracted the contents of the SmartPreviewsFrontEnd-*.zip file.
  2. By default, Smart Previews is configured to use Redis as a caching store for increased performance.
  3. If you do not have access to a Redis cache connection, follow these steps to replace the Redis cache with an in-memory cache:
    1. Open the Web.config file.
    2. Locate the unity\containers\container\types\ section. Around line 17.
    3. The first line (line 18 by default) in the types section contains the text "mapTo="SmartPreviewAppWeb.Caching.RedisStore". Comment out this line.
    4. The following line contains the text "mapTo="SmartPreviewAppWeb.Caching.InMemoryCache". Uncomment this line.
    5. When complete, the code looks like this:



  4. You must configure the Smart Previews Web Resources site to reference the SmartHub URL that is accessible from the server where the Smart Previews Web Resources are being installed.
    SmartPreviews Web Resources relies on SmartHub for authentication.
    1. Open the Web.config file if it is not already open.
    2. Locate the appsettings\SmartHubAddress section, around line 76.
      1. Change the address to match your SmartHub URL using this format: https://<smarthubsite>.com.
      2. For example: https://MyCompany.mydomain.com
    3. Locate the appsettings\SetupModesection, around line 75. Change the value to "SmartHub."


    4. Locate the system.serviceModel\bindings\webHttpBinding section, around line 114.
    5. Change the SmartHubSecurityBinding section to match the security section in your SmartHub web.config file, which is located at the root level of your SmartHub installation directory.
      1. This requires commenting or uncommenting code in the section, as necessary.
      2. In the example below, the security binding in both files is set to "HTTPS with Windows authentication setup."

Add HTTP IIS Site Bindings

Procedure:

  1. Navigate to IIS Management.

  2. Select the IIS SMP web resources site.

  3. Select Bindings... under "Edit Site" on the right-side menu.

  4. Add an HTTP binding. Use the same Host Name as the HTTPS binding (step 8).

  5. Enter a unique port number. 
  6. Click Close.