SmartPTT Web Client Installation Guide 9.0

Embed Size (px)

Citation preview

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    1/21

    SmartPTT EnterpriseWeb Client Installation & Configuration

    Version 9.0

    May 2016

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    2/21

    Table of Contents

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    Table of Contents3Introduction

    3System requirements

    5Supported web browsers

    5Before configuring Web Client

    13Web Client configuration

    17SmartPTT Audio Proxy configuration

    19Q&A

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    3/21

    Introduction 3

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    IntroductionThis guide describes how to install SmartPTT Web Client. It also contains a list of issues that the user mayexperience while configuring it. This guide does not cover the installation or configuration of the desktop versionfrom scratch – the system must be installed and operating normally.

    System requirementsMake sure your computer meets the minimum system requirements given below:

    · Windows Server 2008 x86/x64, Windows Server 2008 R2, Windows 7 and later

    · Microsoft SQL Server 2008 (Express or Enterprise) connected

    · Microsoft .NET Framework 4 and later

    · ASP.NET MVC 3

    You can download it using the links:

    ASP.NET MVC 3 RTM

    http://www.microsoft.com/en-us/download/details.aspx?id=4211

    ASP.NET MVC 3 Tools Update

    http://www.microsoft.com/en-us/download/details.aspx?id=1491

    · IIS 7.5

    If you install SmartPTT Web Client on an absolutely clean PC, take the following steps:

    1. Install NET 4.0

    2. Install NET 4.0 SP1

    3. Install ASP Net MVC 3

    4. Install SQL

    5. Install IIS

    6. Run the command aspnet_regiis.ex e -i as administrator from .NET Framework 4 folder (C:\WINDOWS

    \Microsoft.NET\Framework\v4.0.30319). Make sure it is not Framework x64. This is required for registration of

    ASP.NET applications in IIS.

    http://www.microsoft.com/en-us/download/details.aspx?id=1491http://www.microsoft.com/en-us/download/details.aspx?id=4211

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    4/21

    System requirements 4

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    To do it, click on Start and search Command Prompt , or type cmd in the search field:

    At that, at the top you will see cmd.exe . Right click on cmd.exe , and select Run as administrator . In the consolethat opened, type in the following and then press ENTER:

    7. Download and unpack the SmartPTTWE archive into the inetpub folder. If it does not exist, create it.

    8. Unpack AudioProxy , which you downloaded together with the SmartPTTWE archive, to any folder on the PC,

    where the Web Client will be launched.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    5/21

    Supported web browsers 5

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    Supported web browsersSmartPTT Web Client supports most modern web browsers. It was tested on the following browsers:

    · Internet Explorer 11 or newer

    · Google Chrome 43 or newer · Apple Safari 5 or newer

    Before configuring Web ClientBefore configuring SmartPTT Radioserver and Web Client you need to take the following steps.

    First, install and configure IIS (Internet Information Server). To install IIS, use Microsoft guide.

    After IIS has been installed, check that it was installed properly:

    1. Click the Start menu and select Control Panel.

    2. Select Programs and Features.

    3. Select Turn Windows features on or off.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    6/21

    Before configuring Web Client 6

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    4. Make sure the following items are selected under Internet Information Services.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    7/21

    Before configuring Web Client 7

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    Then, add the website. To do that:

    1. Click the Start button and select Control Panel.

    2. Click the Administrative Tools menu item.

    3. Select Internet Information Services (IIS) Manager.

    4. Unfold the settings tree as shown below:

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    8/21

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    9/21

    Before configuring Web Client 9

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    Port: port on which IIS will listen for requests sent to the web client.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    10/21

    Before configuring Web Client 10

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    7. Click Application Pools in the tree and select SmartPTT in the list.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    11/21

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    12/21

    Before configuring Web Client 12

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    8. Start the web site. To do that, right-click the name of the web site, select Manage Web Site and then click

    Start.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    13/21

    Before configuring Web Client 13

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    9. Check whether the settings were configured properly. To do that, enter the IP address and port of the web client

    (the IP address from step 6) in the address bar of the Internet browser. At that, the login window should open.

    Web Client configurationTo connect SmartPTT Web Client to SmartPTT Radioserver, configure the following settings:

    1. In SmartPTT Radioserver Configurator:

    · In the Settings tab select Radio Server. In the Interface field select the IP address of the PC with theradioserver installed. In this case it is 192.168.37.75.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    14/21

    Web Client configuration 14

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    · In the same tab select Radio Server > Add-on Modules > Web Service and select the Active check box.

    Codec: Compression method for outgoing audio stream. In the Codec list click CCITT A-Law or CCITT u-Law.

    Note: Do not forget to set up the same codec in SmartPTT Audio Proxy tool.

    WebSocket Server: It is used by the SmartPTT Mobile and SmartPTT Web Client applications to initiate the

    voice session with MOTOTRBO radio subscribers and dispatchers. To configure WebSocket Server , set upInterface and WebSocket server port which are used for listening to incoming connections from mobilesubscribers and users of SmartPTT Web Client application.

    · Configure the audio setting of the control station. In Settings tab select Radio Server > Control Station > > Audio , select Active check box, in Codec menu select the same codecthat you did for WebSocket Server in Web Service menu ( CCITT A-Law or CCITT u-Law ) and configure other settings.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    15/21

    Web Client configuration 15

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    · Click Add-on Modules > Licenses to check that you have the necessary licenses.

    · Add a user to log into the Web Client. To do it, click the Client List tab > All (mobile and web clients) .

    Click the Add button. In the Parameters section input user name and its password by clicking the Changepassword button. Remember that the name and password are case sensitive.

    Profile: It contains a list of profiles created in SmartPTT Radioserver Configurator (see Settings > Profiles ). Assigning a profile to a user enables you to limit the user's access to objects and to provide additionalopportunities in the organization of calls between user and radio subscribers. For more information on profiles,read help Profiles in SmartPTT Radioserver Configurator.

    Allow voice calls: Select it to enable the user to make voice calls.

    To edit the parameters of the existing user, click this user in the Login list, and edit the necessary fields in theParameters area.

    To delete a user, select this user in the Login list, and click Delete .

    After you have finished, save the changes in radioserver configuration and restart the radioserver.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    16/21

    Web Client configuration 16

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    2. In the WebSocket Server tool:

    · Open SmartPTTWE folder and run WSS.exe as administrator.

    · In Address field of WSS window enter the interface and the port of the WebSocket server which youconfigured in Web Service menu. In the Local WebSocket Server area, enter 8595 which will be theconnection port between SmartPTT Audio Proxy and Web Client.

    · Click Save and close the window.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    17/21

    SmartPTT Audio Proxy configuration 17

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    SmartPTT Audio Proxy configurationTo be able to make voice calls, you need to configure the audio proxy. To do that, complete the following steps:

    1. Run AudioProxy.exe from the Audio Proxy folder. At that, a new symbol appears in the taskbar.

    2. Right-click the Audio Proxy symbol and open Audio Settings .

    3. In the fields Audio Input and Audio Output , select the sound card you are using, and click OK.

    Note: Do not forget that selected codec in Codec field is to the the same as configured in SmartPTT Server

    Configurator ( CCITT A-Law or CCITT u-Law ).

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    18/21

    SmartPTT Audio Proxy configuration 18

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    4. Right-click the Audio Proxy symbol again and select Network Settings. At that, the Network Settings

    window will appear.

    Local WebSocket Server Interface : WebSocket server address. The value is set automatically and can notbe edited.

    Local WebSocketServer Port : Port of interaction between audio proxy and Web Client. Input 8595 here likeyou did during Web Socket Server configuration.

    RTP Listen Address : IP address of the computer where SmartPTT Web Client is launched.

    After completing configuration click OK.

    5. Login the Web Client, and then click Start in the Audio Proxy settings to allow voice calls (Audio Proxy cannot

    be started before logging in the Web Client).

    Audio Proxy has four statuses with their own icon:

    · Stopped . To stop Audio Proxy, right-click Audio Proxy icon and click Stop.

    · Running . To stop Audio Proxy, right-click Audio Proxy icon and click Start.

    · Not connected

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    19/21

    SmartPTT Audio Proxy configuration 19

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    · Connected, but user did not logged in Web Client

    Note: Whenever you restart the radioserver, Audio Proxy reconnects to the radioserver automatically.

    Q&A1. No map and no radio subscribers are displayed in the Map tab.

    Solution: Check the Internet connection.

    2. Can’t log in. Error message: “ Internal error: Web-client registration failed!”

    Solution: Check the IP address and the port in the Radioserver Connection field in WebSocket Server tool.Data there are to coincide with radioserver IP address and portthat were defined in SmartPTT Radioserver Configuration tool ( Settings > Radio Server > Add-on Modules > Web Service ).

    3. Calls are carried out, but there is no sound.

    Solution 1: Make sure that Audio Proxy is running.Solution 2: Check that you have Voice Console for Web Service license installed in SmartPTT Radioserver Configurator .

    Solution 3: Check if the port in SmartPTT Audio Proxy and in the Local WebSocket Server field of WebSocket Service tool is equal to 8595.

    4. The map is positioned incorrectly after Web-client is opened.

    Solution : Enable cross-origin resource sharing (CORS) requests in the browser. Each browser has its ownprocedure how to enable CORS requests.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    20/21

    Q&A 20

    SmartPTT Enterprise 9.0 Web Client Installation & Configuration

    Internet Explorer browser prohibits CORS requests by default. In order to enable it, open browser, click Toolson the main menu, select Internet options . In the opened Internet Options window select the Security taband click the Custom le vel... button. In the opened Security Settings - Internet Zone window select inMiscellaneous group the Access data sources across domains parameter and click Enable option.

  • 8/15/2019 SmartPTT Web Client Installation Guide 9.0

    21/21

    Q&A 21

    Google Chrome and Safari browsers should be launched with the argument --disable-web-security . For thatopen the Properties window of the browser, type the text --disable-web security in the Target text box (for Google Chrome browser) or in the Start in text box (for the Safari browser) at the end of the text there throughthe gap, click OK and restart the browser.

    5. The address of the subscriber is defined incorrectly on the map.

    Solution : see Solution for question # 4.