Jump to: navigation, search

Additional Configurations

The following configurations are recommended for the successful completion of the SpeechMiner configuration process:

Configuring the Browser

End users of SpeechMiner access its browser-based interface from Internet Explorer or Google Chrome, which connects to the SpeechMiner Web server through the local network. In order for the SpeechMiner interface to work properly, you must configure each user's browser as explained below. The configuration changes that must be implemented are to allow pop-ups from the SpeechMiner domain, to treat the SpeechMiner domain as part of the local intranet (or as a trusted site), and to enable automatic updating of cached web pages.

In addition, if Internet Explorer is running on a Windows Server 2008 machine or Windows Server 2012 machine, the Enhanced Security Configuration feature should be turned off.
Refer to the Turning Off the Enhanced Security Configuration Feature on Windows Server 2008 / Windows Server 2012 section below.

Tip
To run SpeechMiner 8.5.5 you must use a minimum resolution of 1366X768. We recommend that you work with a 1680x1050 resolution.

Configuring Internet Explorer

  1. In the Internet Options dialog box, in the Security tab, select Local Intranet.

    Ie security.png


  2. Add the SpeechMiner domain to the list of web sites in the Local Intranet zone.
  3. Click Sites > Advanced and add *.genesyscloud.com to the list of safe websites.
  4. Click Custom Level to customize the local intranet zone security.
  5. Under Miscellaneous > Access data sources across domains, select Enable.
  6. Selecting Enable makes Screen Recording playback possible because it allows access from the browser to HTCC.

    Miscellaneous.png

  7. In the Privacy tab, add the SpeechMiner domain to the list of web sites that are permitted to open pop-ups.
  8. In the General tab, under Browsing history, select Settings.
  9. Under Check for newer versions of stored pages, select Automatically.

    Ie history.png


  10. Click OK to save the changes.
Important
If the SpeechMiner domain is treated as part of the local intranet, Local intranet should appear in the Status Bar at the bottom of the Internet Explorer window whenever the browser is displaying a SpeechMiner page. Sm localinternet.png

Turning Off the Enhanced Security Configuration Feature on Windows Server 2008 / Windows Server 2012

  1. In the Server Manager, in the home page (the top level), expand the Security Information section. The current settings for the Enhanced Security Configuration feature appear under IE Enhanced Security Configuration (ESC).

    Ie securityinfo.png


  2. If the current settings are not Off for Administrators and Off for Users, click Configure IE ESC. The Internet Explorer Advanced Security Configuration dialog box opens.

    Ie enhancedsecurity.png


  3. For both Administrators and Users, select Off.
  4. Click OK to save the changes.

Configuring Chrome

  1. In the Chrome browser, click the Chrome menu Chrome settings.png, and select Settings.
  2. Under Privacy, click Content Settings....
  3. Under Pop-ups, verify that Allow all sites to show pop-ups is selected. If it is not selected perform the following:
    1. Click Manage exceptions....
    2. In the field provided, type *.genesyscloud.com and select the Allow behavior.
    3. Press Enter and click Done.


Verify that Java Script is Enabled

  1. In the Chrome Browser, navigate to Chrome Settings > Show Advanced Settings > Privacy > Content Settings.
  2. Under Java Script, select Allow all sites to run Java Script (recommended).

For more information about enabling Java Script, see the following example https://support.google.com/adsense/answer/12654.


Setting the Date and Time

The webServiceParam table has two fields for configuring the date and time display:

  • globalDateFormat which configures the date format, for example: MM/dd/yy
  • globalDateTimeFormat which configures the time format, for example: hh:mm tt


For additional information about the options available, see http://www.w3.org/TR/NOTE-datetime.

When SpeechMiner's Spanish interface is used for the Web interface, the only formats supported for globalDateTimeFormat are the following 24-hour formats: H:mm:ss or H:mm.

Set the Forget Password Login Option

When configuring SpeechMiner you can give users the option of recovering forgotten passwords.
If you choose to enable users to recover their forgotten passwords, the SpeechMiner log in screen will contain a Forget Password? link.
When the user clicks the Forget Password? link, the user will be required to enter his email address.
The user will then receive an email with a Reset Password link.
By default the Reset Password link is only available for 4 hours. This default number can be changed.


To enable a user to recover his password perform the following:

  1. Access the webServiceParam table.
  2. Change the PasswordRecovery field from false to true.


To change the Reset Password link default:

  1. Access the webServiceParam table.
  2. Change the resetPasswordTokenExpirationTime field from 4 hours to the amount you prefer.
Important
If more than one user has the same email address, the Forget Password option will not be available.


To change the email message the user receives:

  1. Access the webServiceParam table.
  2. Change the resetPasswordMailBody field to the content you prefer the user to receive.
    The email message content should contain <resetLink>.
    <resetLink> represents the Reset Password link.
  3. Change the resetPasswordMailSubject field to the subject you prefer the user to receive.


Setting the Resource Type

The resourceTypeId table contains a list of all the possible resource types.

To enable/disable a resource type in SpeechMiner, update the isEnabled field in the resourceTypeId table with the relevant status.

Configuring a VMWare Server

If you are installing SpeechMiner on virtual machines and using VMWare Server VSphere4, it is recommended to use the Scheduling Affinity feature, which dedicates specific logical CPUs for the virtual CPUs of particular VMs. Doing this can improve Recognition performance.

To use the VMWare Scheduling Affinity feature:

  1. For each active Virtual Machine, check the VM Settings to see how many CPUs are configured for the machine.
  2. In Setting\Resources tab\Advanced CPU\Scheduling Affinity, enter the serial numbers of the VMWare server's logical CPUs.

Enable HTTPS for SpeechMiner

Important
The following procedure is intended for a WIndows 2008 Server
  1. Create a self signed server certificate to enable the https protocol:
    1. Open the Microsoft Management Console (MMC).
    2. Select File > Add / Remove Snap-in.
    3. Select Certificate and click Add.
    4. Click OK.
    5. Select Computer account and click Next.
    6. Selelct Local computer and click Finish and OK.
    7. Under Certificates (Local Computer), right-click Personal, All Tasks, Request New Certificates
    8. The following Certificate Enrollment window appears:

    9. Click Next
    10. Under Active Directory Enrollment Policy, Select Computer.
    11. Click Enroll and Finish.
  2. Configure the Report Server:
    1. Open the Reporting Services Configuration Manager.
    2. Select Web Service URL.
    3. Select Advanced.
    4. Under Multiple SLL Identities, click Add and select the certificate you created.
    5. Click OK and select the https URL.
    6. Under Multiple SSL Identities, click Add and select the certificate you created.
    7. Click OK and select the Report Manager URL.
  3. Create an SSL Binding:
    1. Open IIS Manager.
    2. Select Default Web Site and in the right Action pane click Bindings.
    3. Click Add.
    4. In the Type list select https.
    5. In the IP address list select All Unassigned.
    6. In the Port field enter the relevant port number.
    7. In the SSL Certificate list select the relevant SSL Certificate.
  4. Configure SSL settings:
    1. In the IIS Manager, click Default Web Site.
    2. Under IIS, select SSL Settings.
    3. Select Require SSL and click Apply.
  5. Restart the IIS Server.
  6. Important
    If the following error occurs after you restart the IIS Server, it maybe due to the fact that your Skype process is using the same ports and should be stopped:

    IIS Manager Error: The process cannot access the file because it is being used by another process. (Exception from HRESULT: 0x80070020)

Additional information abouat SSL on IIS 7 can be found here: http://learn.iis.net/page.aspx/144/how-to-set-up-ssl-on-iis-7/

Additional Configuration for Recording Modes

  • Create a new application for SpeechMiner with a Genesys Generic Server template in the Genesys Administration Extension:
    • Follow the Creating Applications Objects procedure in the Procedures tab of the Applications page in the Genesys Administration Extension document.
    • Verify that the name of the application that you create is the same as the ApplicationName field in the configServer table of the SpeechMiner database.
    • Creating a SpeechMiner application does not require configuring connections or options and is not integrated with LCA.


Configuring a SpeechMiner Web Application

Configure a new SpeechMiner Web application when your default web site is not sufficient for your systems demands.

  1. Open the IIS Manager.
  2. Under Connections, select Sites > Default Web Sites and right-click SpeechMiner.
  3. Click Remove to remove the existing SpeechMiner Web Application.
  4. Under Connections right-click the web site to which you want to add the SpeechMiner Web Application.
  5. Select Add Application.
  6. In the Application Name field enter SpeechMiner for the new web application.
  7. Click Select.
  8. Open the Application Pool list and select SpeechMiner.
  9. Click OK.
  10. In the Physical Path click the Browse button and select the Installation > Web folder. The default folder is c:\Program Files (x86)\Genesys\Software\utopy\product\web.
  11. Click OK.
  12. The SpeechMiner Web Application appears under the web site to which you selected to add the SpeechMiner Web Application.

Configuring Command Line availability for SMART

To update the database configuration perform one of the procedures:

SMConfig

  1. Log into SMConfig.
  2. Select Services.
  3. In the Services window, select Update config files.
  4. Click Save.

SMART

  1. Manually log into SMART.
  2. Go to C:\Program Files (x86)\Genesys\Software\utopy\product\bin\release.
  3. Make a copy of smart.exe.config and name the copy smartc.exe.config.
  4. When asked to replace a file with the same name click Yes.

Defining Caching Reports

All Caching tasks are listed in the Report Caching Params table.

In the default database there is one Caching task that caches all the reports in the expanded widgets for all the active partition sets during the last 30 days.

You can select different reports to cache then those defined by default. You can also delete the existing cache and create a new cache.


To define a new cache report:

  1. Access the Report Cache Params table in the database and insert a new row.
  2. Define the following parameters:
    Parameter Description
    Enable True
    Report Query The query that retrieves the report id’s and the partition strings associated with the report you want to cache.

    Within the Report Query you can use the following parameters:

    Parameter Description
    @templatesToExclude The templates to exclude from caching.
    @usersToExclude The users to exclude from caching.
    @daysUserIsActive The users that should be cached. For example, if this is 7, then only users that are active in the last 7 days should be cached.
    numberOfProcesses The number of parallel threads that should be cached (at the same time).
    keepLogMessages The number of days log messages associated with caching tasks be should be kept.
    NotificationMail The email address belonging to the users to whom the caching task report should be sent when the caching is complete.
    webComputerName The name of the web server to which the reports are cached.
    RunAtTime Defines when the caching task will run within 24hrs. The maximum is 1440 minutes for 24hrs. For example, if you want the cache task to run at 12 midnight and your UTC difference is +2, enter -120. It is the difference between UTC and the local time you want it to run in. The difference is in minutes.
    nextTimeToRun The next time the Caching task is set to run. Set this parameter to a low value. During the initial run the task automatically sets the correct value.
  3. Log into SMConfig.
  4. Under Machines & Tasks, select one or more machines on which the Caching task will run.
  5. If you select more than one machine the Caching task will be divided equally between the machines that run simultaneously. The more machines the faster the Caching task will be completed.

  6. Click Edit.
  7. The following Properties window appears:
    300px

  8. Select Report Caching.
  9. Click Ok.
  10. Click Save.
  11. Select the Report tab.
  12. The following Report Deployment page is opened:
    700px

  13. In the Set reports caching time (minutes) field enter 1440 (this number represents 24 hours).
  14. Select all the report templates and click Save.
  15. Verify that the Caching task is running:
    1. Access the reportCachingLog table.
    2. Select the table records and verify that the Caching task ran.
    3. Access the ulogger and verify that it is caching the selected reports.
Important
If the Report Caching task fails, the Partition Failure error will appear in the reportCachingLog table. To resolve this error copy the Microsoft.ReportViewer*.* dlls from the web\bin folder to the platform bin folder utopy\product\bin\release or Install MS Report Viewer 2005.


Report Server Email Configuration

Configure the Report Server email as follows so that the report schedule and report deliverable functions operate as expected.

  1. Access the Report Server machine.
  2. Open Reporting Services Configuration Manager.
  3. Click Connect to connect to the Report Server.
  4. Select Service Account and define a user account with access to the SMTP server.
  5. Click Apply.
  6. Select E-mail Setting and define the SMTP Server and default Sender Address.
  7. Click Apply.

Integrated Windows Authentication

Integrated Windows Authentication enables you to ensure that your SpeechMiner users are not required to log into SpeechMiner every time they want to access the application.

Tip
To configure your application to use Integrated Windows Authentication, you must use IIS Manager to configure your application's virtual directory security settings and you must configure the <authentication> element in the Web.config file.
  1. Open IIS Manager and navigate to the level you want to manage. For information about opening IIS Manager, see Open IIS Manager (IIS 7).
  2. For information about navigating to locations in the UI, see Navigation in IIS Manager (IIS 7).

  3. In Features View, double-click Authentication.
  4. On the Authentication page, select Windows Authentication.
  5. In the Actions pane, click Enable to use Windows authentication and Disable to use Anonymous authentication.
  6. In your application's Web.config file or in the machine-level Web.config file, ensure that the authentication mode is set to Windows as shown here.
  7. ...
    <system.web>
     ...
     <authentication mode="Windows"/>
     ...
    </system.web>
    ...
    


This page was last edited on December 9, 2014, at 09:13.
blog comments powered by Disqus