You are on page 1of 21

Version 9.

SmartPTT Enterprise
Web Client Installation & Configuration
May 2016

Table of Contents

Table of Contents
Introduction

System requirements

Supported web browsers

Before configuring Web Client

Web Client configuration

13

SmartPTT Audio Proxy configuration

17

Q&A

19

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Introduction

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

System requirements
Make 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.exe -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.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

System requirements

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 console
that 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.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Supported web browsers

Supported web browsers


SmartPTT 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 Client


Before 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.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

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

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

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:

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

5. Right-click Sites and select Add Web Site...

6. In the window that opened fill in the fields as shown below and click OK.
Site name: any name of the future web site.
Physical path: path to the SmartPTTWE folder. The folder must be located in the inetpub folder.
IP address: the IP address of the web client. Select one of the available interfaces on which IIS will listen for
incoming connections.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

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

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

10

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

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

11

In the Edit Application Pool window, in the .NET Framework version, select version 4.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

12

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

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Before configuring Web Client

13

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 configuration


To 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 the
radioserver installed. In this case it is 192.168.37.75.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Web Client configuration

14

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 up
Interface and WebSocket server port which are used for listening to incoming connections from mobile
subscribers and users of SmartPTT Web Client application.
Configure the audio setting of the control station. In Settings tab select Radio Server > Control Station >
<name of the control station> > Audio, select Active check box, in Codec menu select the same codec
that you did for WebSocket Server in Web Service menu (CCITT A-Law or CCITT u-Law) and configure other
settings.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Web Client configuration

15

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 Change
password 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 additional
opportunities 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 the
Parameters 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.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Web Client configuration

16

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 you
configured in Web Service menu. In the Local WebSocket Server area, enter 8595 which will be the
connection port between SmartPTT Audio Proxy and Web Client.

Click Save and close the window.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

SmartPTT Audio Proxy configuration

17

SmartPTT Audio Proxy configuration


To 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).

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

SmartPTT Audio Proxy configuration

18

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 not
be edited.
Local WebSocketServer Port: Port of interaction between audio proxy and Web Client. Input 8595 here like
you 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

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

SmartPTT Audio Proxy configuration

19

Connected, but user did not logged in Web Client


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

Q&A
1. No map and no radio subscribers are displayed in the Map tab.
Solution: Check the Internet connection.
2. Cant 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 own
procedure how to enable CORS requests.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Q&A

20

Internet Explorer browser prohibits CORS requests by default. In order to enable it, open browser, click Tools
on the main menu, select Internet options. In the opened Internet Options window select the Security tab
and click the Custom level... button. In the opened Security Settings - Internet Zone window select in
Miscellaneous group the Access data sources across domains parameter and click Enable option.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration

Q&A

21

Google Chrome and Safari browsers should be launched with the argument --disable-web-security. For that
open 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 through
the 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.

SmartPTT Enterprise 9.0

Web Client Installation & Configuration