SpeechExec Enterprise 4.1

Transcription

SpeechExec Enterprise 4.1
SpeechExec Enterprise 4.1
Web Outsource Installation / Upgrade
from Version 4.0 to 4.1
Contents
1.
1.1.
1.2.
2.
2.1.
2.2.
2.3.
2.4.
2.4.1.
2.4.2.
2.4.3.
2.4.4.
2.5.
3.
3.1.
3.2.
4.
4.1.
4.2.
5.
6.
7.
7.1.
7.2.
7.3.
8.
8.1.
8.2.
8.3.
Important ................................................................................................................................ 5
Objective ................................................................................................................................ 5
Disclaimer and Notices .......................................................................................................... 5
System Requirements ............................................................................................................ 7
Hardware ................................................................................................................................ 7
Operating System .................................................................................................................. 7
Microsoft .NET Framework .................................................................................................... 7
Internet Information Services (IIS) ......................................................................................... 8
Windows XP ........................................................................................................................... 8
Windows Server 2003 .......................................................................................................... 10
Windows Vista / Windows 7 ................................................................................................. 13
Windows Server 2008 (R2) .................................................................................................. 14
Configuring ASP.NET with IIS.............................................................................................. 18
Installing Enterprise Web Outsource ................................................................................... 19
Uninstall a previous Version of Web Outsource .................................................................. 19
Installation Procedure .......................................................................................................... 22
Authentication Methods ........................................................................................................ 27
Windows Server 2003 / XP .................................................................................................. 27
Windows Vista / Windows 7 / Server 2008 (R2) .................................................................. 28
Changing the Application Pool’s Managed Pipeline Mode .................................................. 31
Enabling ISAPI and CGI restrictions .................................................................................... 33
Logging................................................................................................................................. 35
Windows XP ......................................................................................................................... 35
Windows Server 2003 / 2008 (R2) ....................................................................................... 35
Windows Vista / Windows 7 ................................................................................................. 35
Known Issues ....................................................................................................................... 37
ASP.NET on x64 systems .................................................................................................... 37
Unexpected error 0x8ffe2740............................................................................................... 39
Error message “-2146893039 (0x80090311)” ...................................................................... 39
Important
1.
Important
1.1.
Objective
This document describes the installation process of SpeechExec Enterprise Web Outsource 4.1
respectively the upgrade procedure from SpeechExec Enterprise Web Outsource 4.0 to 4.1.
1.2.
Disclaimer and Notices
Philips Speech Processing has carried out extensive testing with most popular configurations.
However, since computer add-ons and device drivers change very rapidly, we are unable to
guarantee conflict-free operation.
SpeechExec Enterprise 4.1 Documentation
5
Important
6
SpeechExec Enterprise 4.1 Documentation
System Requirements
2.
System Requirements
2.1.
Hardware
-
Processor minimum requirement: Pentium III with 500 MHz and 256 MB RAM.
-
Processor recommended requirement: Pentium IV or similar with 1 GHz and 1 GB RAM.
-
Microsoft .NET 4.0 Framework requires 850 MB free disk space in 32-bit Windows (2 GB in
64-bit Windows).
2.2.
Operating System
SpeechExec Enterprise supports Windows XP (32 bit), Windows Vista (32/64 bit), Windows 7 (32/64
bit), Windows Server 2003 (32/64 bit), Windows Server 2008 (32/64 bit) and Windows Server 2008
R2 (32/64 bit). It is recommended that the latest available Service Pack is installed on the operating
system.
Under Windows Server 2008 (and R2), install the Desktop experience feature to ensure troublefree usage of SpeechExec. To install Desktop experience, open “Server Manager” from
“Administrative Tools” and start the “Add Features Wizard”. In the “Add Features Wizard” select
“Desktop Experience” and install it. When the installation is complete, restart the computer.
Windows Terminal Server/Citrix session has to be run at least in Hi-Color (16-bit).
2.3.
Microsoft .NET Framework
SpeechExec Enterprise requires that you have Microsoft .NET 4.0 Framework installed. If it is not
present on your system, it will be installed automatically during the SpeechExec installation.
Note:
For Microsoft .NET 4.0 Framework to be installed automatically, you must start the SpeechExec
installation by launching the setup.exe. Depending on your PC, installing Microsoft .NET 4.0
Framework may take some time.
If you install a SpeechExec application on a computer that doesn’t have the Microsoft .NET
Framework installed, the setup may reboot the PC even if the setup started in silent mode. Microsoft
strongly recommends to restart the PC after installing .NET Framework 4.0, that’s why the
SpeechExec setup initiates a reboot. You can prevent this by installing the .NET Framework before
the SpeechExec setup is started. The necessary file is located on the installation CD in the
ISSetupPrerequisites/{32D7E3D1-C9DF-4FA6-9F9B-4D5117AB2917} folder.
Use the following command to start a silent installation of .NET Framework 4.0:
dotNetFx40_Full_x86_x64.exe /q
SpeechExec Enterprise 4.1 Documentation
7
System Requirements
2.4.
Internet Information Services (IIS)
To install SpeechExec Web Outsource you need to have Internet Information Services (IIS) installed
on your operating system.
IIS can be installed through Control Panel / Add Remove programs / Add/remove Windows
Components (in Windows Server 2008 (R2), Windows Vista and Windows 7 the path is Control
Panel / Programs and Features / Turn Windows features on or off).
2.4.1. Windows XP
1.
8
Select Internet Information Services and click Details.
SpeechExec Enterprise 4.1 Documentation
System Requirements
2.
Check the components as shown below, select World Wide Web Service and click Details.
3.
Check World Wide Web Service.
Apply the changes and restart the system.
SpeechExec Enterprise 4.1 Documentation
9
System Requirements
2.4.2. Windows Server 2003
1.
Check Application Server and click Details.
2. Check the components as shown below, select Internet Information Services (IIS) and click
Details.
10
SpeechExec Enterprise 4.1 Documentation
System Requirements
3.
Check the components as shown in the following two screenshots…
4.
…select World Wide Web Service and click Details.
SpeechExec Enterprise 4.1 Documentation
11
System Requirements
5.
Check World Wide Web Service.
Apply the changes and restart the system.
12
SpeechExec Enterprise 4.1 Documentation
System Requirements
2.4.3. Windows Vista / Windows 7
Check the features as shown below. Apply the changes and restart the system.
SpeechExec Enterprise 4.1 Documentation
13
System Requirements
2.4.4. Windows Server 2008 (R2)
1. Open Server Manager from Administrative Tools and start the Add Roles wizard.
2. If the screen below appears click Next.
14
SpeechExec Enterprise 4.1 Documentation
System Requirements
3. In the Add Roles wizard select the Web Server (IIS) role and click Next.
4. Click Next.
SpeechExec Enterprise 4.1 Documentation
15
System Requirements
5. Select the following role services:
6. Select the following role services and click Next:
16
SpeechExec Enterprise 4.1 Documentation
System Requirements
7. Click Install.
8. After installing IIS, restart your computer.
SpeechExec Enterprise 4.1 Documentation
17
System Requirements
2.5.
Configuring ASP.NET with IIS
Before configuring ASP.NET with IIS, check if you had Microsoft.NET installed. If you had
Microsoft.NET installed before IIS (for example, in Vista, .NET is deployed on the operating system,
so it is installed by default), follow the instructions below to register ASP.NET in IIS:
1.
Start command prompt (cmd.exe).
2.
Open the C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319 directory.
3.
Run the following command: aspnet_regiis.exe -i
Note that this operation can take several minutes.
In Windows Server 2003 follow the steps below:
1.
Start Internet Information Services (IIS) Manager (Control Panel / Administrative Tools).
2.
Select Web Service Extensions node.
3.
On the right panel, right-click ASP.NET v4.0.30319 and select Allow.
18
SpeechExec Enterprise 4.1 Documentation
Installing Enterprise Web Outsource
3.
Installing Enterprise Web Outsource
Before installing SpeechExec Enterprise Web Outsource, ensure that you have administration rights
for running the setup.exe file. To set administration rights in Windows Vista, Windows 7 and
Windows Server 2008 (R2), right-click on the setup.exe file and in the context menu select Run as
administrator.
Make sure, that users accessing the web-site will have proper privileges to access and write in the
Dictation root directory that you have specified during the setup.
Warning:
If you intend to upgrade an older version of Web Outsource, first you have to uninstall the existing
product, and install the new version. Make sure you create backup copies of your corresponding
configuration files before uninstalling.
3.1.
1.
Uninstall a previous Version of Web Outsource
Go to Control Panel / Uninstall a program (in Server 2003 select Add or Remove Programs)
SpeechExec Enterprise 4.1 Documentation
19
Installing Enterprise Web Outsource
2.
Right click SpeechExec Enterprise Web Outsource and select Change
3.
Click Next.
20
SpeechExec Enterprise 4.1 Documentation
Installing Enterprise Web Outsource
4. If the following screen appears, uncheck Uninstall ASP.NET AJAX Framework and click
Remove. Otherwise continue with step 5.
5.
Click Finish to exit the wizard.
SpeechExec Enterprise 4.1 Documentation
21
Installing Enterprise Web Outsource
3.2.
Installation Procedure
1.
Run Enterprise Web Outsource from the software CD.
2.
Select the language and click OK.
22
SpeechExec Enterprise 4.1 Documentation
Installing Enterprise Web Outsource
3.
Click Next.
4.
Accept the license agreement and click Next.
SpeechExec Enterprise 4.1 Documentation
23
Installing Enterprise Web Outsource
5.
Choose the destination folder, specify the virtual directory name and click next.
6. Browse for the paths of the root download directory and the dictation property configuration
file and click Next.
24
SpeechExec Enterprise 4.1 Documentation
Installing Enterprise Web Outsource
7.
Click Install to begin the installation.
8.
Click Finish to exit the wizard and restart the system.
SpeechExec Enterprise 4.1 Documentation
25
Installing Enterprise Web Outsource
26
SpeechExec Enterprise 4.1 Documentation
Authentication Methods
4.
Authentication Methods
After successful installation of the web application, you have to enable Basic authentication for the
web-site.
Important:
Basic authentication sends the username and password as plain text through the network towards
the IIS web server. If security is really important, consider using SSL and configure the website to be
accessible only via HTTPS.
Start IIS through Administration Tools / Internet Information Services (IIS) Manager.
4.1.
1.
Windows Server 2003 / XP
Go to Web Sites / WebOutsource node, right click on it, and select Properties.
2. Select the Directory Security tab and select Edit under the Authentication and access
control groupbox.
3.
Turn off Anonymous access, and check in Basic authentication.
SpeechExec Enterprise 4.1 Documentation
27
Authentication Methods
Note:
In previous versions of SpeechExec Web applications the Windows authentication was
recommended. Unfortunately this authentication method does not support security-token forwarding.
This means that if Windows authentication is enabled instead of Basic authentication and you
access the SpeechExec website entering the proper credentials, and the dictation download
directory is on a network share, you cannot access the directory even if you have proper privileges
for it directly.
4.2.
Windows Vista / Windows 7 / Server 2008 (R2)
1.
Go to Web Sites / WebOutsource node.
2.
In the middle panel under the IIS section, select Authentication.
28
SpeechExec Enterprise 4.1 Documentation
Authentication Methods
3. Disable all authentication modes. Only ASP.NET Impersonation and Basic Authentication
must be enabled.
SpeechExec Enterprise 4.1 Documentation
29
Authentication Methods
30
SpeechExec Enterprise 4.1 Documentation
Changing the Application Pool’s Managed Pipeline Mode
5.
Changing the Application Pool’s Managed Pipeline Mode
In Windows Vista, Windows 7 and Windows Server 2008 (R2), you have to manually change the
Managed Pipeline Mode of the relevant Application Pool.
1.
Go to Adminstrative Tools / Internet Information Services (IIS) Manager.
2.
Edit the advanced settings of ASP .NET v4.0 WebOutsource in Application Pools.
SpeechExec Enterprise 4.1 Documentation
31
Changing the Application Pool’s Managed Pipeline Mode
3.
32
Set the Managed Pipeline Mode setting to Classic and click OK.
SpeechExec Enterprise 4.1 Documentation
Enabling ISAPI and CGI restrictions
6.
Enabling ISAPI and CGI restrictions
In Windows Vista, Windows 7 and Windows Server 2008 (R2), you have to manually change the
Managed Pipeline Mode of the relevant Application Pool.
1. Go to Adminstrative Tools / Internet Information Services (IIS) Manager and select your
computer (machine) name.
2.
Double click ISAPI and CGI restrictions.
SpeechExec Enterprise 4.1 Documentation
33
Enabling ISAPI and CGI restrictions
3. Double click ASP.NET v4.0.30319
(C:\Windows\Microsoft.NET\Framework\ v4.0.30319\aspnet_isapi.dll).
4.
34
Check Allow extension path to execute and click OK.
SpeechExec Enterprise 4.1 Documentation
Logging
7.
Logging
The log settings can be changed in the SpeechExecLog.config file, which can be found in the
directory where the application has been installed.
To change any settings in the log configuration file (SpeechExecLog.config), you have to stop
the website (Default Web Site in the IIS) and you also have to stop the application pools (under
Windows 2003, 2008 (R2), Windows Vista and Windows 7). After changing the log settings you can
restart them.
The default log directories are the following:
7.1.
Windows XP
C:\Documents and Settings\%WORKSTATION_NAME%\ASPNET\Application
Data\Philips Speech\SpeechExec\
7.2.
Windows Server 2003 / 2008 (R2)
The default log directory is not accessible for the IIS. To allow logging, modify the File element of the
SpeechExecLog.config file to a path where the IIS account, the ASPNET account and the
NETWORKSERVICE account all have write access.
Example:
1.
Stop the Default Web Site in IIS.
2. Stop the Default Application Pool (called DefaultAppPool in Windows Server 2008 and 2008
R2) in IIS.
3.
Open the SpeechExecLog.config for editing
4. Change the value of the File element to a path, where IIS, NETWORKSERVICE and ASPNET
accounts have write access (in this example: “C:\weblog\weboutsource.log”). Note, that the
path separators in this configuration file are double backslashes.
<param name=“File” value=“C:\\weblog\\weboutsource.log” />
5.
Restart the Default Application Pool in IIS.
6.
Restart the Default Web Site in IIS.
7.3.
Windows Vista / Windows 7
C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Philips
Speech\SpeechExec\
SpeechExec Enterprise 4.1 Documentation
35
Logging
36
SpeechExec Enterprise 4.1 Documentation
Known Issues
8.
Known Issues
8.1.
ASP.NET on x64 systems
By default, when the .NET 4.0 Framework is installed on x64 systems, it only installs the x64 version
of ASP.NET, which is not compatible with the SpeechExec Enterprise Web application, which was
compiled as an x86 (32 bit) application.
Problem solution:
Windows x64 systems provide a functionality known as WOW64 (Windows on Windows) to allow
x86 IIS applications to run under x64 IIS installations.
To enable WOW64 for IIS, run the following commands from the command prompt:
cscript %SYSTEMDRIVE%\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/
Enable32bitAppOnWin64 1
%SYSTEMROOT%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i enable
iisreset
Note:
Enabling WOW64 will permanently remove the ASP.NET tab from IIS Manager. x86 and x64
applications cannot share an application pool.
Problem solution on Windows Server 2008 and 2008 R2:
1.
Open Administrative Tools / Internet Information Services (IIS) Manager.
SpeechExec Enterprise 4.1 Documentation
37
Known Issues
2.
38
Edit the advanced settings of ASP.NET v4.0 WebOutsource in Application Pools.
SpeechExec Enterprise 4.1 Documentation
Known Issues
3.
Set Enable 32-Bit Applications to True.
8.2.
Unexpected error 0x8ffe2740
Error message “unexpected error 0x8ffe2740 occurred” is displayed when starting Default Web Site
in IIS.
Microsoft.NET has been installed before installing Internet Information Services. For information on
configuring ASP.NET with IIS, see Section Configuring ASP.NET with IIS.
8.3.
Error message “-2146893039 (0x80090311)”
Error message “-2146893039 (0x80090311)” is displayed when browsing SpeechExec Web
Outsource application with an Internet browser.
The server where the web application is hosted cannot connect to a domain controller, so the
windows authentication of the user fails.
SpeechExec Enterprise 4.1 Documentation
39
Specifications are subject to change without notice.
Trademarks are the property of Royal Philips Electronics or their respective owners.
© 2011 Royal Philips Electronics. All rights reserved.
Document Version 1.1, 12/2011.