Winscribe Citrix XenApp and Terminal Services Installation ... FULL C… · Winscribe Citrix XenApp and Terminal Services Installation Guide Winscribe integrates with Citrix XenApp

Copyright ©2013, Winscribe Inc. All rights reserved.

Publication Date: November 2013

Winscribe Citrix XenApp and Terminal Services Installation Guide

4.2

2

Copyright© 2013 Winscribe Inc. All Rights Reserved.

Portions of the software described in this document Copyright© Microsoft Corporation. All Rights Reserved. Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or mechanical or photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Winscribe Inc.

Winscribe® is a registered trademark of Winscribe Inc. in New Zealand and other countries. Microsoft is a registered trademark, Windows NT and Windows is a trademark of Microsoft Corporation. Dragon NaturallySpeaking® is a trademark of Nuance, Inc. and is used here under license. Other brands and their products are the trademarks or registered trademarks of their respective holder and should be noted as such.

Winscribe Inc. P.O. Box 33-178 Takapuna Auckland New Zealand Email: [email protected] Visit our web page: http://www.winscribe.com

3

Contents

Contents

Introduction ...................................................................................................................................... 4

Audio and Input Device Configuration .......................................................................................................................... 4

Supported Environments ................................................................................................................... 5

Citrix XenApp ................................................................................................................................................................ 5 Terminal Services .......................................................................................................................................................... 5 Client Operating Systems .............................................................................................................................................. 5 VEC Footpedal & DVR File Upload over Terminal Services from a 64bit Client ............................................................ 5 Supported Environments Chart .................................................................................................................................... 5 Citrix XenDesktop.......................................................................................................................................................... 6

Citrix XenApp .................................................................................................................................... 7

Application Server Configuration .................................................................................................................................. 7 Winscribe Client ...................................................................................................................................................... 7 Winscribe Author .................................................................................................................................................... 8 Install 32bit Philips Speech Drivers ......................................................................................................................... 8

Client Machine Configuration ....................................................................................................................................... 9 Virtual Channel Client Configuration & VEC Footpedals / DVR File Upload .......................................................... 10

Terminal Services............................................................................................................................. 11

Application Server Configuration ................................................................................................................................ 11 Winscribe Client .................................................................................................................................................... 11 Winscribe Author .................................................................................................................................................. 12 Install 32bit Philips Speech Drivers ....................................................................................................................... 12

Client Machine Configuration ..................................................................................................................................... 13 Virtual Channel Client Configuration & VEC Footpedals / DVR File Upload .......................................................... 14

Copying Audio from Digital Voice Recorders ..................................................................................... 15

Importing Uploaded Files ............................................................................................................................................ 16

Limitations & Technical Notes .......................................................................................................... 17

DS-4000 & Virtual Channel Import ............................................................................................................................. 17 Active / Disconnected Sessions................................................................................................................................... 17 LED Lights not functional with Philips SpeechMikes ................................................................................................... 17 If two Philips devices are connected simultaneously, only one device operates ....................................................... 17

Index ............................................................................................................................................... 18

4


Winscribe integrates with Citrix XenApp or Terminal Services servers allowing Winscribe client software to be centralized on the Citrix or Terminal Services host. Applications or Desktops can be streamed via Citrix Browser / Desktop connections or via Terminal Services remote sessions.

Audio and Input Device Configuration This configuration requires Winscribe client software to be installed on the host (which automatically installs the required Server connector components as part of the Winscribe client software install).

The remote client computer requires a Winscribe Thin Client connector to be installed. The Winscribe Thin Client allows Digital Voice Recorders to be detected when they are docked on the client machine, and transfer audio files contained on them to the Citrix or Terminal Services Server. From there, the Winscribe Importer can be used to import these files into Winscribe.

Additionally, the remote client computer requires appropriate Philips or Olympus remote session drivers to be installed. These drivers enable the centralized client applications to interact with the remote computer hardware (sound cards and connected peripherals).

Installation of the client applications, Winscribe Thin Client, and manufacturer remote session drivers require administrative privileges.

Introduction

5

Supported Environments

Citrix XenApp Winscribe v4.2 is supported on the following editions of Citrix XenApp and ICA Client / Receiver:

XenApp Server Receiver / ICA Client

XenApp 5 for Windows Server 2008 Citrix Receiver 4.0

XenApp 6 for Windows Server 2008 R2 Citrix Receiver 3.0 -> 3.4

XenApp 6.5 for Windows Server 2008 R2

Terminal Services Winscribe v4.2 is certified to host Winscribe client applications for access over Windows Terminal Services on the following Windows Server operating systems:

Windows Server 2008

Windows Server 2008 R2

Windows Server 20121 1 Only Olympus & VEC input device support is currently available for Windows Terminal Service operation on Server 2012.

Client Operating Systems Winscribe v4.2 is certified with the following client operating systems:

Windows 8.1

Windows 8

Windows 7 SP1

Windows Vista SP2

Windows XP SP32 2 Windows Terminal Services support on XP SP3 requires Remote Desktop Connection Client to be updated to version 6.1.7600.

VEC Footpedal & DVR File Upload over Terminal Services from a 64bit Client Winscribe v4.2 does not support VEC Footpedals & Digital Voice Recorder File Upload when connecting to Winscribe client applications via Terminal Services from a 64bit client.

Supported Environments Chart The following charts summarize the Citrix XenApp and Windows Terminal Services support described above.

Citrix XenApp

Supported Environments

6


Feature 32bit Client 64bit Client

Olympus Mics & Pedals

Philips Mics & Pedals

VEC Footpedals

DVR File Upload

Windows Terminal Services

Server 2008 / 2008 R2 Server 2012

Feature 32bit Client 64bit Client 32bit Client 64bit Client

Olympus Mics & Pedals

Philips Mics & Pedals

VEC Footpedals

DVR File Upload

Citrix XenDesktop Citrix XenDesktop is a different product to Citrix XenApp. The information in this guide relates to configuration for Citrix XenApp only.

XenApp delivers applications and desktops on a client computer but they are virtual representations of applications or desktops running on the host server. XenApp requires audio and hardware 'connectors' at the server and client end for input devices to interact.

XenDesktop delivers a truly visualized desktop over the network. USB input devices are connected to the virtual desktop as HID devices, offering the same behavior as you would expect when connecting devices to a locally install desktop operating system.

Citrix XenDesktop is supported by Winscribe v4.2. It does not require the configuration described in this guide.

7

Citrix XenApp

Application Server Configuration Install the latest Winscribe Author, Internet Author, and/or Winscribe Client applications on to the

application host server, as needed.

If installing Winscribe Client, run a custom install and disable the Grundig Foot Pedal feature.

Put wsAuthor.exe into the Data Execution Prevention exclusion list.

If using Philips Speechmikes or footpedals, install the 32bit Philips Speech Drivers on to the application host server.

Publish the client application(s) or desktop(s).

Winscribe Client

When installing Winscribe Client on the Citrix XenApp application host, click Options to do a custom installation and disable the Grundig hardware addin:

A silent console install of all features except the Grundig hardware addin can be achieved with the following console command1

msiexec /i "Winscribe Client.msi" SERVERURL=http://<servername>/winscribe ADDLOCAL=VirtualChannelFeature,Philips,Olympus,VEC,Product,MobileWebServiceImporter,MicrosoftWordBasic,OpenOfficeDocumentManager,FolderTemplateManager /quiet

1 Refer the Winscribe Installation Guide section "Setting Installation Parameters" for further information on command line arguments for Winscribe client applications.

Citrix XenApp

8


Winscribe Author It is recommended wsAuthor.exe be added to the Data Execution Prevention exclusion list to aid with stability when launching Winscribe Author.

Install 32bit Philips Speech Drivers If you intend to interact with Winscribe client applications using Philips Speechmikes or Footpedals on the client workstations, the 32bit Philips Speech Drivers need to be installed on the server hosting the Winscribe client applications.

Run the 32bit Philips Speech Driver installer with the filename PhilipsSpeechDriversSetup.exe.

Note: Even if the Server is 64bit, the installer that needs to be run on the Server is the 32bit installer.

9

Citrix XenApp

At the feature selection page, disable the "Server Extension for WTS":

Client Machine Configuration

Note: The installers can be found on the Winscribe Installation media:

Software\Client\Thin Client\Drivers

1. Install Citrix Receiver

2. Install the remote session driver that matches the manufacturer of the devices intended to be used to interact with the Winscribe client applications:

a. If using Olympus microphones / footpedals, install the Olympus Citrix Service ClientVD (filename: CitrixClientVD.msi)

b. If using Philips microphones / footpedals, install the Philips 32bit Speech Drivers (filename: PhilipsSpeechDriversSetup.exe)

Notes:

To install the Olympus Citrix Service ClientVD in a UAC enabled environment, it may be necessary to run setup.exe instead of CitrixClientVD.msi

VEC footpedal support is enabled by the Winscribe Virtual Client Configuration Tool, installed in step 3.

3. Install Winscribe Thin Client

These installation steps are adequate to get Philips & Olympus microphone and footpedal support in a Citrix XenApp environment.

If using a Philips or Olympus microphone or footpedal in Winscribe Author or Winscribe Internet Author, the user needs to go into Options | Hardware and configure the appropriate tab for the device. Please refer the Winscribe Author User Guide for more information.

10


Virtual Channel Client Configuration & VEC Footpedals / DVR File Upload The Virtual Channel Client Configuration tool needs to be run on any Windows user account on the client machines where the following features are needed:

VEC Footpedal operation

File upload from Digital Voice Recorder devices

On the client machine, for each user that needs either of these features, launch the Virtual Channel Client Configuration Tool as follows:

a) Click Start | Programs | Winscribe | Tools

b) Click Virtual Channel Client Configuration

VEC Footpedal support is automatically enabled when the user clicks OK.

Enable other options as desired:

Feature Description

Enable import of digital portable audio Digital Voice Recorders docked to the client machine are automatically detected and uploaded to the application host server

Delete audio from digital portables after import Audio files will be removed from the Digital Voice Recorder after they have been uploaded

Suppress multiple-session warnings This feature applies to Windows Terminal Services connections only

11

Terminal Services

Application Server Configuration Install the latest Winscribe Author, Internet Author, and/or Winscribe Client applications onto the

application host server, as needed.

If installing Winscribe Client, run a custom install and disable the Grundig Foot Pedal feature.

Put wsAuthor.exe into the Data Execution Prevention exclusion list.

If using Philips Speechmikes or footpedals, install the 32bit Philips Speech Drivers on to the application host server.

Winscribe Client When installing Winscribe Client on the Citrix XenApp application host, click Options to do a custom installation and disable the Grundig hardware addin:

A silent console install of all features except the Grundig hardware addin can be achieved with the following console command2

msiexec /i "Winscribe Client.msi" SERVERURL=http://<servername>/winscribe ADDLOCAL=VirtualChannelFeature,Philips,Olympus,VEC,Product,MobileWebServiceImporter,MicrosoftWordBasic,OpenOfficeDocumentManager,FolderTemplateManager /quiet

2 Refer the Winscribe Installation Guide section “Setting Installation Parameters” for further information on command line arguments for Winscribe client applications.

Terminal Services

12


Winscribe Author It is recommended wsAuthor.exe be added to the Data Execution Prevention exclusion list to aid with stability when launching Winscribe Author:

Install 32bit Philips Speech Drivers If you intend to interact with Winscribe client applications using Philips SpeechMikes or Footpedals on the client workstations, the 32bit Philips Speech Drivers need to be installed on the server hosting the Winscribe client applications.

Run the 32bit Philips Speech Driver installer with the filename PhilipsSpeechDriversSetup.exe.

Note: even if the Server is 64bit, the installer that needs to be run on the Server is the 32bit installer.

13

Terminal Services

At the feature selection page, disable the "Server Extension for Citrix":

Client Machine Configuration

Note: The installers can be found on the Winscribe Installation media:

Software\Client\Thin Client\Drivers

1. If the client machine is Windows XP SP3, the Remote Desktop Connection Client needs to be updated to version 6.1.7600. Information on this update can be found on the following Microsoft Support page: http://support.microsoft.com/kb/969084

2. Install the remote session driver that matches the manufacturer of the devices intended to be used to interact with the Winscribe client applications:

a. If using Olympus microphones / footpedals, install the Olympus Terminal Service ClientVD installer (filename: TerminalServicesClientVD.msi)

If the client machine is 32bit, run the MSI in the 32bit folder

If the client machine is 64bit, run the MSI in the 64bit folder

a. If using Philips microphones / footpedals, install the Philips Speech Drivers

If the client machine is 32bit, run the MSI in the 32bit folder (filename: PhilipsSpeechDriversSetup.exe)

If the client machine is 64bit, run the MSI in the 64bit folder (filename: PhilipsSpeechDrivers64Setup.exe)

Notes:

To install the Olympus Terminal Service ClientVD in a UAC enabled environment, it may be necessary to run setup.exe instead of TerminalServiceClientVD.msi

VEC footpedal support is enabled by the Winscribe Virtual Client Configuration Tool, installed in step 3.

14


3. Install Winscribe Thin Client

These installation steps are adequate to get Philips & Olympus microphone and footpedal support in a Windows Terminal Service environment.

If using a Philips or Olympus microphone or footpedal in Winscribe Author or Winscribe Internet Author, the user needs to go into Options | Hardware and configure the appropriate tab for the device. Please refer the Winscribe Author User Guide for more information.

Virtual Channel Client Configuration & VEC Footpedals / DVR File Upload The Virtual Channel Client Configuration tool needs to be run on any Windows user account on the client machines where the following features are needed:

VEC Footpedal operation

File upload from Digital Voice Recorder devices

On the client machine, for each user that needs either of these features, launch the Virtual Channel Client Configuration Tool as follows:

1. Click Start | Programs | Winscribe | Tools

2. Click Virtual Channel Client Configuration

VEC Footpedal support is automatically enabled when the user clicks OK.

Enable other options as desired.

Feature Description



Suppress multiple-session warnings This feature applies to Windows Terminal Services connections only. If an existing Terminal Service session exists and another session is started, the user will be asked whether to establish the Winscribe Virtual Channel connection on the new session or maintain the connection on the existing session.

15

Copying Audio from Digital Voice Recorders

When a Terminal Services or Citrix XenApp session to the server has been established on a client machine, audio files found on digital voice recorders connected to the client machine will be automatically transferred off the digital portable to the Terminal Services or Citrix Server if the following are true:

The Virtual Channel Client Configuration tool has been run for the user account on the client machine and "Enable import of digital portable audio" has been enabled

Winscribe Author, Winscribe Internet Author, or Winscribe Client is running in the Citrix or Terminal Services session when the Digital Voice Recorder is docked with the client machine

The files on the device that are intended to be imported do not have read-only attributes

Similar to the Winscribe Importer in operation, when a Digital Voice Recorder is docked to the client workstation you will hear the audio prompt "Copying files from dictation device". When the copy is complete, you will hear the audio prompt "Copying complete". If no files are found on the device, you will hear the audio prompt "No files found for copying".

If there are multiple drives on the device, for example an Olympus DS7000, multiple prompts will be heard — one set of prompts for each drive.

To enable or disable the import feature or to enable or disable files being deleted from the device after copying, launch the Virtual Channel Client Configurator tool.

1. Click Start | Programs | Winscribe | Tools

2. Click Virtual Channel Client Configuration

Feature Description



Suppress multiple-session warnings This feature applies to Windows Terminal Services connections only. If an existing Terminal Service session exists and another session is started, the user will be asked whether to establish the Winscribe Virtual Channel connection on the new session or maintain the connection on the existing session.

Copying Audio from Digital Voice Recorders

16


Importing Uploaded Files The files uploaded from Digital Voice Recorders are placed in an "Upload" folder. The folder location is defined by the UserWorkingDirectory path of the Winscribe client application. By default, this path is:

C:\ProgramData\Winscribe\Users\Upload

Use Winscribe Importer to point to the Upload folder as a Source to import the files into the Winscribe Digital Dictation system.

17

Limitations & Technical Notes

DS-4000 & Virtual Channel Import Olympus Digital Voice Recorders operate in two modes:

Tethered

Mass Storage

The DS-4000 can only operate in one mode at any time. When a DS-4000 is connected to a client machine that has Winscribe Author or Winscribe Client running, the DS-4000 may connect as either Tethered or Mass Storage.

If the device connects as Tethered then importing over the virtual channel will not occur.

If the device connects as Mass Storage, then controlling Winscribe Author / Internet Author by using the buttons/slider on the DS-4000 would not be possible.

If you are connecting the device to a client machine where Winscribe Client is running, it will always operate as a mass storage device and thus import over the virtual channel would be successful.

If connecting to a client machine running Winscribe Author or Internet Author, Winscribe applications may see the DS-4000 as a control device and request the DS-4000 run as Tethered mode. Virtual channel import would then not be possible.

Active / Disconnected Sessions It is not currently possible for hardware events to operate on devices when "picking up" an active session from another computer.

For example, a user cannot launch Winscribe Author and use it on Computer A, disconnect the remote session on Computer A, and then go to Computer B and reconnect the session, grabbing the active session that was opened by Computer A. If a user does this, hardware events from a device are unlikely to work. Winscribe Author would need to be closed and opened again on Computer B to establish a new connection.

LED Lights not functional with Philips SpeechMikes Philips have yet to implement LED light support for remote sessions. This feature is expected in a future Philips Speech Driver release.

If two Philips devices are connected simultaneously, only one device operates There is currently an issue that prevent two Philips devices functioning simultaneously. Only one of the two devices will respond.

Limitations & Technical Notes

18


A

Active / Disconnected Sessions • 17 Application Server Configuration • 7, 11 Audio and Input Device Configuration • 4

C

Citrix XenApp • 5, 7 Citrix XenDesktop • 6 Client Machine Configuration • 9, 13 Client Operating Systems • 5 Copying Audio from Digital Voice Recorders • 15

D

DS-4000 & Virtual Channel Import • 17

I

If two Philips devices are connected simultaneously, only one device operates • 17

Importing Uploaded Files • 16 Install 32bit Philips Speech Drivers • 8, 12 Introduction • 4

L

LED Lights not functional with Philips SpeechMikes • 17

Limitations & Technical Notes • 17

S

Supported Environments • 5 Supported Environments Chart • 5

T

Terminal Services • 5, 11

V

VEC Footpedal & DVR File Upload over Terminal Services from a 64bit Client • 5

Virtual Channel Client Configuration & VEC Footpedals / DVR File Upload • 10, 14

W

Winscribe Author • 8, 12 Winscribe Client • 7, 11

Index

Documents

Winscribe Citrix XenApp and Terminal Services Installation ... FULL C… · Winscribe Citrix XenApp and Terminal Services Installation Guide Winscribe integrates with Citrix XenApp