Mobile Viewer Installation Guide VisionHub 4.2 UP1

Transcription

1 Mobile Viewer Installation Guide VisionHub 4.2 UP1 February 2017 Rev.A0 Copyright 2016 Qognify Ltd. All rights reserved.

2 Important Notice Qognify shall bear no responsibility or liability to a client or to any person or entity with respect to liability, loss or damage caused or alleged to be caused directly or indirectly by any Qognify product. This includes, but is not limited to, any interruption of service, loss of business or anticipatory profits or consequential damage resulting from the use or operation of any Qognify products. Information in this document is subject to change without notice and does not represent a commitment on the part of Qognify. The systems described in this document are furnished under a license agreement or non-disclosure agreement. All information included in this document, such as text, graphics, photos, logos and images, is the exclusive property of Qognify and protected by United States and international copyright laws. Permission is granted to view and photocopy (or print) materials from this document for personal, non-commercial use only. Any other copying, distribution, retransmission or modification of the information in this document, whether in electronic or hard copy form, without the express prior written permission of Qognify, is strictly prohibited. In the event of any permitted copying, redistribution or publication of copyrighted material, no changes in, or deletion of, author attribution, trademark legend or copyright notice shall be made. Qognify Disclaimer: For the full list of Qognify s trademarks, visit All other marks used are the property of their respective proprietors. All contents of this document are: Copyright 2016 Qognify. All rights reserved.

3 Contents 1 About This Guide Who Should Read This Guide Terms and Abbreviations Glossary Guide Conventions Related Documentation System Requirements Technical Support Introducing VisionHub Mobile Viewer System Architecture Supported Devices and Platforms on Client Machines Software Kit Installation Before Installing VisionHub Mobile Viewer Installing VisionHub Mobile Viewer Installing Updates Synchronizing VAS and Web Server Clocks Uninstalling VisionHub Mobile Viewer VisionHub Licensing Installing User Certificates Multi-Site Architecture and Configuration Appendix - IIS Configuration Windows Sever 2012 R Windows Server

4 List of Tables Table 1-1: Acronyms and Abbreviations... 1 Table 1-2: NiceVision Specific Terms... 1 Table 1-3: Typography Conventions... 2 Table 1-4: Related Documents... 3 Table 1-5: Software Requirements... 3 Table 1-6: Hardware Minimum Requirements... 4 Table 3-1: Silent Installation Parameters List of Figures Figure 2-1: VisionHub Mobile Viewer Architecture... 7 Figure 3-1: Wowza Media Server InstallShield Wizard Figure 3-2: InstallShield Wizard - License Agreement Figure 3-3: InstallShield Wizard - Customer Information Figure 3-4: InstallShield Wizard - Destination Folder Figure 3-5: InstallShield Wizard - Ready to Install the Program Figure 3-7: Select Language Window Figure 3-8: Welcome Window Figure 3-9: Choose Components Window Figure 3-10: Installation Type Window Figure 3-11: TranscoderMgr Windows Server Figure 3-12: Installation Progress Window Figure 3-13: Completing the Mobile Viewer Setup Window Figure 3-14: First Time Login Figure 3-15: Login Page Figure 3-16: Server Settings Page Figure 3-17: Transcoder Settings Page Figure 3-18: Video System Access Service Address Page Figure 3-19: Uninstall Figure 6-1: Mobile Viewer Multi-site Architecture Figure 6-2: Transcoder Settings Page Figure 7-1: Windows 2012 Roles Figure 7-2: Windows 2012 Features Figure 7-3: Windows 2008 Roles Figure 7-4: Windows 2008 Features... 36

5 About This Guide 1 About This Guide This document describes how to install the VisionHub Mobile Viewer Software Kit. 1.1 Who Should Read This Guide The information and procedures described in this document are for use by system integrators and installers, Qognify customer support, sales engineers and end users. 1.2 Terms and Abbreviations The acronyms and abbreviations used in this document are listed below. Table 1-1: Acronyms and Abbreviations Term AMS BTU DHCP IP LAN LED PTZ RAID SDK SSO STA STM UPS URL Meaning Application Management Server British Thermal Unit Dynamic Host Configuration Protocol Internet Protocol Local Area Network Light-Emitting Diode Pan Tilt Zoom Redundant Array of Independent Disks Software Development Kit Single Sign-On Streaming and Transcoding Server Streaming Manager Server uninterruptible power supply Uniform Resource Locator 1.3 Glossary Terms specific to VisionHub are listed below. Table 1-2: NiceVision Specific Terms Term Active Output Channel Control Application Web Client Control Room VisionHub Meaning The selected output on the video layout, on which video is playing, and/or actions are performed. Cameras hooked up to VisionHub Recorder, directly or over the network. The main VisionHub daily-operation application managing video and other sensors, investigation, incident management, and so on. The Web client uses information coming from the middle tier and plays video from the VMS via the video provider infrastructure to display video and audio. The physical control room where operators work with desktop computers (each running the Control application) and external video monitors that display video. Page 1 of 36

6 About This Guide Term Monitoring Permission PTZ Preset Seek User Workstation VisionHub Meaning Viewing live video/audio streams in real-time. Determines what site components the user is authorized to access. A predefined spot to which a PTZ camera moves upon request. A search bar that allows moving to any spot of the playback. A person, defined in the VisionHub database, who has certain privileges to use VisionHub system. A personal computer that runs the VisionHub Control Application Web Client. 1.4 Guide Conventions The typography conventions used in this guide are described below. Table 1-3: Typography Conventions Style Usage Example Initial Capitals + Bold Italics Monospace (Courier New font) UPPERCASE <Ctrl-x> Menus, dialog box options, field names and commands File names, folder names, and file paths Code samples, error messages Code keywords and database elements Indicates a key that is pressed or a control character sequence To access the application, click Start > Programs > Accessories > Paint. Type the IP address in the Address field. Run the setup.exe file located at: C:\Installation\Setup. The following error message is displayed: 1. error opening database: database is currently in use. Use the INNER JOIN clause in SQL Server to join one table to another. Press <Enter> means press the Enter key. Or, press <Ctrl-x> means press the Control key and the x key simultaneously. This guide also contains text with special formatting to provide reference information, cautions, and warnings for the user. NOTE: TIP: A NOTE calls attention to additional information or references related to an operation, procedure, practice, and so on. A TIP calls attention to topics or tutorials related to an operation, procedure, practice, and so on. CAUTION: A CAUTION denotes a hazard. It calls attention to an operation, procedure, practice, and so on, which, if not correctly performed or adhered to, could result in damage to or destruction of part or all of the system components. Do not perform any procedure denoted by a CAUTION sign until the indicated conditions are fully understood and met. Page 2 of 36

7 About This Guide 1.5 Related Documentation Related documents are listed in Error! Reference source not found.. Table 1-4: Related Documents Document Name Version File Type Date VisionHub Control Online Help 4.2 UP1 CHM February 2017 VisionHub VisionHub Installation Guide 4.2 UP1 PDF February 2017 VisionHub System Requirements 4.2 UP1 PDF February 2017 VisionHub Administrator User Guide 4.2 UP1 PDF February 2017 VisionHub Video Configurator User Guide 4.2 UP1 PDF February 2017 VisionHub Monitoring User Guide 4.2 UP1 PDF February 2017 VisionHub Control Web Application User Guide 4.2 UP1 PDF February 2017 VisionHub Planner User Guide 4.2 UP1 PDF February 2017 VisionHub Player User Guide 4.2 UP1 PDF February 2017 VisionHub SVR Turnkey Installation Guide 4.2 UP1 PDF February 2017 VisionHub SVR Software Kit Installation Guide 4.2 UP1 PDF February 2017 VisionHub NVD Software Kit Installation Guide 4.2 UP1 PDF February 2017 VisionHub NVD5204 Turnkey Installation Guide 4.2 UP1 PDF February 2017 VisionHub Video Theory of Operation 4.2 UP1 PDF February 2017 VisionHub Mobile Viewer User Guide 4.2 UP1 PDF February 2017 VisionHub Mobile Viewer Installation Guide 4.2 UP1 PDF February 2017 VisionHub Licensing Quick Start User Guide 1.6 System Requirements The system requirements for the VisionHub Mobile Viewer are described in the tables below. IMPORTANT: The software listed in the below table is required to be properly installed and configured before installing VisionHub Mobile Viewer. IMPORTANT: When installing the Mobile Viewer using a new VisionHub Installation setup, but Java and/or Wowza are not pre-installed on the machine, you get an error message asking to install Java and Wowza. Browse to Media Pack > Installations > Advanced > Mobile Viewer and run Java and Wowza installations manually. Table 1-5: Software Requirements Component Media Web Application and Media Streamer Host Description IIS (ver. 6 or 7). The Installer will check if the appropriate version of IIS is installed. If IIS is not present or its version is lower than 6.0, the corresponding error message will be displayed and installation will be aborted. IIS must be preinstalled and properly configured as explained in the Appendix - IIS Configuration..NET runtime (optional). Preinstalling of.net Page 3 of 36

8 About This Guide Component Description runtime is optional, as the VisionHub Mobile Viewer setup package includes the.net runtime and will install it if required. Wowza Media Server 2.xx, 3.xx, & 4.xx. If Wowza Media Server is not installed on the Streamer Host, the corresponding error message will be displayed and installation will be aborted. Install it manually from the media pack. (If installing Transcoder separately, Wowza is not required on the Transcoder machine). Java 64-bit version 8 or later. If Java 64-bit Media Server is not installed, install it manually. Table 1-6: Hardware Minimum Requirements Component Description Streaming Manager or All-in-One Streaming and Transcoding Server CPU Operating System RAM LAN Interface Modem Free Disk Space Single Intel Xeon Processor E5620 (12M Cache, 2.40 GHz, 5.86 GT/s Intel QPI) Windows Server 2008 R2 (Standard Edition) Windows Server 2012 R2 (Standard Edition) 4 GB Gigabit Ethernet 56 K - Required as access point for maintenance 500 GB Storage Redundancy Hot swappable RAID 1 DVD Drive Power Supply Required for software installation Hot swappable redundant power supply is recommended Component Description Stream Transcoding Server CPU Dual Intel Xeon Processor E5620 (12M Cache, 2.40 GHz, 5.86 GT/s Intel QPI) Operating System RAM LAN Interface Modem Free Disk Space Windows Server 2008 R2 (Standard Edition) Windows Server 2012 R2 (Standard Edition) 8 GB Gigabit Ethernet 56 K - Required as access point for maintenance 500 GB Storage Redundancy Hot swappable RAID 1 DVD Drive Power Supply Required for software installation Hot swappable redundant power supply is recommended Page 4 of 36

9 About This Guide 1.7 Technical Support This document contains all the information necessary for correct operation of VisionHub Mobile Viewer. If the information you need is not in this document, refer to the related documents or contact your technical support representative. Qognify provides the highest level of technical support for its products. Technical support services include: Training Services: Qognify provides both in-house and on-site training courses for system operators, technical, and system administrators. Documentation Resources: Qognify is supplied with comprehensive technical documentation. In addition, Qognify provides customers with periodic release notes and technical notes. Follow-on Support: Qognify provides the customers with a valuable and comprehensive maintenance and services offering. Different available options can be seen in the Qognify Price List. For more information about Qognify documentation, training, and support services, contact your local Qognify representative. Page 5 of 36

10 Introducing VisionHub Mobile Viewer 2 Introducing VisionHub Mobile Viewer VisionHub Mobile Viewer is a part of VisionHub Control Room application suite which presents a flexible and easy to use solution for remote access (outside the company intranet) to protected video streams received from the input channels connected to Recorders in the VisionHub system. With VisionHub Mobile Viewer, users can play the available video in real-time or view the pre-recorded video tracks. For better usability, the application enables different video layouts: single, quad and fullscreen views. PTZ preset option is also supported and allows controlling PTZ cameras when viewing live video. The VisionHub Mobile Viewer application includes two parts: VisionHub Mobile Viewer Workstation Client. Allows users to access and play back video on various workstations by using standard internet browsers and players. VisionHub Mobile Viewer ipad Client. Allows users to access and play back video on ipad devices using the ipad s built-in browser. VisionHub Mobile Viewer Mobile Client. Allows users to access and play back video on various mobile devices by using mobile devices built-in browsers and players. Information that addresses functionality and explains how to work with the VisionHub Mobile Viewer Workstation Client or Mobile Client is given in the VisionHub Mobile Viewer User Guide. 2.1 System Architecture VisionHub Mobile Viewer is a client-server solution composed of three main components: Media Web Application. The core system module which identifies the clients devices and platforms, provides a secured access to the available video data based on user permissions, invokes a build-in player of the device to play back video properly in real-time. Media Streamer. Handles the user s requests for video playback and sends them to one of the available Transcoder components (see below). Media Transcoder. Handles and fetches the requests from the relevant Recorder, transcodes video according to the request and sends it back to the Media Streamer component. VisionHub Mobile Viewer is distributed as a Turnkey solution or as a Software Kit. For a Software Kit, a single installation package is delivered to install the application and all required components on all host machines. On the client side, no software installation is required. The only tool the end-users need is a built-in player or browser from the list of supported platforms (see the Supported Devices and Platforms section for more details). A graphical representation of system architecture and relationships between system components is shown in Figure 2-1. Page 6 of 36

11 Introducing VisionHub Mobile Viewer Figure 2-1: VisionHub Mobile Viewer Architecture 2.2 Supported Devices and Platforms on Client Machines The VisionHub Mobile Viewer application supports the following mobile devices and platforms: Mobile Devices ipad devices iphone devices (3G and above) Android devices (Version 2.x and above) NOTE: For the mobile devices listed above, their own built-in browsers and players will be used for video playback Platforms Microsoft Windows Windows 7 (32-bit and 64-bit) Windows 8.1 (32-bit and 64-bit) Windows 10 (32-bit and 64-bit) Players and browsers: Adobe Flash Player version 10 and above Microsoft Internet Explorer version 8-11 Google Chrome version 16 and above MAC operating system and the following players and browsers: Adobe Flash Player version 10 and above Safari version 4, 5, 6 Google Chrome version 16 and above Page 7 of 36

12 Introducing VisionHub Mobile Viewer Linux operating system and the following players and browsers: Adobe Flash Player version 10 and above Firefox version 3 and above Google Chrome version 16 and above Page 8 of 36

13 Software Kit Installation 3 Software Kit Installation The chapter includes the following topics: Before Installing VisionHub Mobile Viewer Installing VisionHub Mobile Viewer Installing VisionHub Mobile Viewer Updates Uninstalling VisionHub Mobile Viewer 3.1 Before Installing VisionHub Mobile Viewer Before you begin the installation of VisionHub Mobile Viewer, you must have completed the following set of pre-installation procedures: Install Wowza Media Server on the Media Streamer host machine. If Wowza Media Server is not installed, the installation of VisionHub Mobile Viewer will be aborted and corresponding error message will be displayed. It can be installed manually from the media pack. For information on how to install Wowza Media Server, please refer to the Wowza Media Server documentation. Install Java 64-bit on the Media Streamer host machine. While installing Wowza, you are prompted to update Java version. In this case, confirm an update and continue. If Java is not automatically installed, it can be installed manually from the media pack Installing Wowza Media Server To install Wowza Media Server on Windows, double-click the installation file WowzaMediaServer exe. During the installation process you will be asked to enter the product license key. You cannot proceed with the installation until you have entered a valid license key. Files will be installed to the following location: /Program Files (x86)/wowza Media Systems/Wowza Media Server To install the server: 1. Right-click WowzaMediaServer exe and select Run as administrator. Page 9 of 36

14 Software Kit Installation Figure 3-1: Wowza Media Server InstallShield Wizard 2. Click Next. The License Agreement window appears. Figure 3-2: InstallShield Wizard - License Agreement 3. Select I accept the terms in the license agreement and click Next. The Customer Information window appears. Page 10 of 36

15 Software Kit Installation Figure 3-3: InstallShield Wizard - Customer Information 4. Type your organization s name and the serial number you received from Qognify. Click Next. The Destination Folder window appears. Figure 3-4: InstallShield Wizard - Destination Folder 5. Click Change to select the installation location and click Next. The Ready to Install the Program window appears. Page 11 of 36

16 Software Kit Installation Figure 3-5: InstallShield Wizard - Ready to Install the Program 6. Select the application users and click Install. Installation starts and a progress bar is displayed. 7. Click Finish when InstallShield Wizard Completed window appears. You have successfully installed the Wowza Media Server. 3.2 Installing VisionHub Mobile Viewer The VisionHub Mobile Viewer installation can be launched in two modes: wizard installation and silent installation. In the wizard installation mode, an installation wizard is used to install the product. The wizard guides the user through several installation steps. To navigate between the wizard s pages, the Next and Back buttons in the lower part of the wizard window are used. The Cancel button closes the wizard window and quits the installation procedure after the user's confirmation. The silent installation mode does not require user interaction. In this mode, no dialog boxes, user prompts or text confirmations are displayed. Instead of prompting the user to select a particular installation option, the installer uses the default set of installation parameters or a set of pre-defined parameters specified via command line Wizard Installation Mode This section describes the process of installing VisionHub Mobile Viewer in the wizard installation mode. To install VisionHub Mobile Viewer in the wizard installation mode: 1. To run the VisionHub Installation Wizard, double-click VisionHub.exe. The Welcome screen opens. Page 12 of 36

17 Software Kit Installation 2. Enter user name and organization name in the respective fields. 3. In the End-User License agreement, select I Accept and click Next. The Select Installation screen opens. 4. Select Components and then select Mobile Viewer. 5. Click Next to continue. The Ready to Install screen opens. 6. Click Install to continue. The installation launches. 7. The Select Language wizard appears. Page 13 of 36

18 Software Kit Installation Figure 3-6: Select Language Window 8. Select the installation language and click OK. The Mobile Viewer Setup wizard opens and the Welcome window appears. Figure 3-7: Welcome Window 9. Click Next. The Choose Components window appears. Page 14 of 36

19 Software Kit Installation Figure 3-8: Choose Components Window 10. Select the component or components you want to install on the current machine and click Next to continue. (Only one Mobile Viewer and Streamer server is allowed in the site. However, you can have many Transcoder Servers in the site. Select both components if installing all software on one server. Select Transcoder Server and deselect Streamer if installing Transcoder Server separately. SDK users should install URI Generator. The Installation Type screen appears. Page 15 of 36

20 Software Kit Installation Figure 3-9: Installation Type Window 11. The Installation Type screen allows the user to select one of the following installation types: Process mode. Allows viewing the Transcoder Manager console and monitor its activity. If selected, VisionHub Mobile Viewer and its components are installed as regular Windows applications. Service mode. If selected, VisionHub Mobile Viewer and its components are installed as Windows Services. When the VisionHub Mobile Viewer installation is completed, the newly installed windows services will be launched and set to automatic startup, that is will be started automatically on every system startup. An example of service hosting the Transcoder Manager is shown in the following figure. Figure 3-10: TranscoderMgr Windows Server NOTE: Installation won t continue until the user selects a particular option. Page 16 of 36

21 Software Kit Installation The Installation Progress window appears. Figure 3-11: Installation Progress Window When the installation is complete the Completing the Mobile Viewer Setup appears. Figure 3-12: Completing the Mobile Viewer Setup Window 12. Click Finish to exit the installation wizard. Page 17 of 36

22 Software Kit Installation First Time Login and Configuration First login must be from the workstation client and not from the mobile! To login the first time: 1. In the address bar of the selected browser, enter the following URL: Server IP Address>/MobileViewer The Login page appears. 2. Upon first time login, a login page opens which lets the administrator define the Video System Access Service IP address and port. Video System Access Service is the VisionHub Web Server IP address Network port depends on whether the VisionHub Web Server was installed as <http> or <https> Type port 80 if VisionHub Web Server installed as < Type port 443 if VisionHub Web Server installed as < Figure 3-13: First Time Login 3. Enter the Video System Access Service IP address and port and click Submit. Page 18 of 36

23 Software Kit Installation Figure 3-14: Login Page 4. Enter your user name and password in the appropriate fields, and then click Login. Now you are prompted to save the Streamer and Transcoder Servers IP addresses. You should add all installed Transcoder Servers. Page 19 of 36

24 Software Kit Installation Figure 3-15: Server Settings Page Page 20 of 36

25 Software Kit Installation 5. In the Server Settings page, specify the following parameters: Service Consumers Endpoint Settings: Load Balancer Address: An internal service that runs typically on the web server machine. Use the default address. URI Generator Address: An internal service that runs typically on the web server machine. Use the default address. Use the default IP address unless the server is equipped with more than one NIC card and you want to dedicate a specific NIC for communicating with this service. Server Settings: Web Server Local IP Address: Used when the network has a DMZ configuration to define the address of the web server in the internal network. Web Server Local Ports Range: The web server default port range is Streaming Server Address (outer): If there are streaming servers installed over the public internet then define the outer address. Streaming Server Address (WAN): If the streaming servers are installed on an intranet define this IP. If all servers are in the same LAN then the outer address and the WAN address are the same. Streaming Server IP Address (LAN): This IP is used by the streamer server to communicate with the Transcoders. Streaming Server Ports Range (LAN): The streaming server ports range. Streaming Server RTP Port: The streamer server RTP default port range is Page 21 of 36

26 Software Kit Installation 6. In the Server Settings page, click the Transcoder Settings link. Figure 3-16: Transcoder Settings Page 7. In the Transcoder Settings page, for Video Application Server, specify the User Name and Password and then test the connection to the Video Application Server, by clicking Verify. TIP: The default user name and password is admin. If entering another user name, enter the user name who has privileges to setup Mobile Viewer. 8. To add a transcoder to a Video Application Server, specify the Transcoder IP Address (and port), and click Add. The transcoder IP address and port is added to the pane on the right. 9. Click Save. 10. Continue in the Server Settings page, and specify the following parameters: Web Application Settings: SSL Support: Enable or disable SSL support for connections between the client s workstation and Media Web Application host. See Technical Note 195 for detailed instructions and limitations. Stream Encryption Support: Enable or disable encrypting the data streams between the client s workstation and Media Web Application host. This option exists only for Flash Player on a workstation (using RTMP protocol), and for ios mobile devices (using RSTP live streaming protocol). Web Server Log Level: The log level for log files in the Media Web Application host. Possible values are: API Methods Call and Errors and Warnings. Transcoding: Whether to apply transcoding to the incoming streams. Possible values are: Page 22 of 36

27 Software Kit Installation o o o None: Transcoding will never be used. In this case, if the format of incoming stream is not supported by the client s device the video will not be played and corresponding error message will be displayed on the screen. Always: The incoming streams will always be transcoded according to the selected frame rate, resolution and type of compression. Automatically: The default and the recommended option. Transcoding will be applied only if the format of incoming streams is not supported by the client s device. SSO (Single Sign On): Enable or disable single sign-on which lets Windows users log in to Windows once without needing to log in again to Mobile Viewer (disabled by default). Health Check: Enable/disable the health check which lets you check the status of each component in the Mobile Viewer system. Health check is enabled by default. Health Check Delay (sec): How often (in seconds) to check the health of each component in the system Maximum Health Records: The maximum number of health-check records to save before overwriting. Remember User: Administrator can control whether users save their credentials upon login. Once the option is enabled, a user can save his credentials and there will be no need to enter credentials upon second login. If disabled, Remember User Name and Remember Password checkboxes do not appear on the login page, and users cannot save their credentials, but need to enter them every time they login to the system. 11. In the Server Settings page, click the Video Settings link. Figure 3-17: Video System Access Service Address Page 12. Specify the Video System Access Service Address (and port), and click Submit. Video System Access Service is the VisionHub Web Server IP address Network port depends on whether the VisionHub Web Server was installed as <http> or <https> Type port 80 if VisionHub Web Server installed as < Type port 443 if VisionHub Web Server installed as < 13. Click Save. The new Server Settings are saved. Page 23 of 36

28 Software Kit Installation Silent Installation Mode This section describes the process of installing VisionHub Mobile Viewer in silent installation mode. NOTE: Running the VisionHub Mobile Viewer installer in the silent mode is recommended for advanced users only. Users who perform a silent installation must understand all necessary setup requirements and know how to work with the Command Prompt window and its command-line interface Syntax Make sure you have one space before a slash. Make sure you use a forward slash and not a backward slash. Make sure you have one space before a parameter name. Make sure there are no spaces before or after the equal mark. Make sure to supply the correct path to the installation files destination. To run the VisionHub Mobile Viewer installation in silent mode: 1. On the target computer, open a command line and run the MobileViewerCumulative.exe utility using arguments for a silent installation. For example: MobileViewerCumulative.exe /S /[PARAMETER1]=[VALUE1] /[PARAMETER2]=[VALUE2] Where: S Indicates the installer s silent mode. It is case sensitive. parameter1, parameter2 silent installation parameters. A list of supported parameters and their values is given in the following Table. Table 3-1: Silent Installation Parameters Parameter Name Possible Values Default Value WSAANDSTREAMER Yes/No/URI Yes TRANSCODERSERVER Yes/No Yes MODE Process/Service Service NOTE: If installation parameters and their values are not specified or specified incorrectly, the default parameters and values will be used. 2. Press Enter. The installer silently installs VisionHub Mobile Viewer on your machine. Page 24 of 36

29 Software Kit Installation Verifying the Installation Following installation verify the IIS_ISURS user has full control permissions to the appropriate folders. To verify the installation: 1. Right-click the folder C:\inetpub\wwwroot\MobileViewer and select Properties. 2. In the Security tab make sure the IIS_IUSRS user has full control. 3. Right-click the folder C:\inetpub\LoadBalancer and select Properties. 4. In the Security tab make sure the IIS_IUSRS user has full control. 3.3 Installing Updates When the VisionHub Mobile Viewer application is updated, the customer will get the MobileViewerCumulative.exe file which needs to be reinstalled. To install the VisionHub Mobile Viewer update: 1. Uninstall the current version. Verify that uninstall was successful (see Verifying Uninstall). 2. Restart the machine. (Without a restart, the new version installation will not run properly.) 3. Run the newly received MobileViewerCumulative.exe file to install the update. Follow the wizard instructions to complete the installation. 4. Load the application and go to the Server Settings window. 5. Redefine all necessary IP addresses and click Save. TIP: Wait one minute to let the system load correctly and only then click Login. 3.4 Synchronizing VAS and Web Server Clocks You need to synchronize the clock on the VAS machine with the clock on the Web Server. If both the VAS and Web Server are in the same domain, and SSO is required, then you also need to synchronize both clocks with the domain server clock. 3.5 Uninstalling VisionHub Mobile Viewer There are three ways to uninstall VisionHub Mobile Viewer: Uninstall via MobileViewer Cumulative wizard Uninstall silently Uninstall via VisionHub wizard The wizard uninstall uses a wizard to remove VisionHub Mobile Viewer and all its components from your computer. The silent uninstall option lets you uninstall VisionHub Mobile Viewer via the command prompt without having to run through a graphical wizard. Page 25 of 36

30 Software Kit Installation Uninstall via a MobileViewer Cumulative Wizard This section describes the uninstall process of VisionHub Mobile Viewer. To uninstall Mobile Viewer: 1. On the machine where VisionHub Mobile Viewer is installed, click Start > Settings > Control Panel. 2. Double-click Programs. 3. Select MobileViewer Cumulative from the list and click Uninstall. 4. Select VisionHub from the list and click Uninstall. 5. Follow the wizard instruction to complete uninstall. Figure 3-18: Uninstall Silent Uninstall This section describes the silent uninstall of VisionHub Mobile Viewer. NOTE: Executing a silent uninstall of VisionHub Mobile Viewer is recommended for advanced users only. Users who perform a silent uninstall must understand how to work with the Command Prompt window and its command-line interface. To execute a silent uninstall: 1. Start a command prompt session on the machine where VisionHub Mobile Viewer is installed. 2. Go to the VisionHub Mobile Viewer installation directory. The default VisionHub Mobile Viewer installation directory is: C:\Users\User.Name\AppData\Local\MobileViewerCumulative. 3. In the command prompt, enter the following command: Uninstall.exe /S 4. Press Enter to silently uninstall VisionHub Mobile Viewer Uninstall via a VisionHub Wizard This section describes the uninstall process of VisionHub Mobile Viewer. To uninstall Mobile Viewer: 1. Run the VisionHub Installation wizard. The setup recognizes that a previous software version is already installed and launches the Program Maintenance window. Two options are available in this window: Remove and Modify. Page 26 of 36

31 Software Kit Installation 2. Click Modify. NOTE: The installed on the machine items are checked by default. Others are not checked. 3. Clear the checkboxe of the Mobile Viewer. 4. Click Next. 5. Click Remove Verifying Uninstall To verify uninstall was successful: 1. In Control Panel > Add Remove Programs in the list of Currently installed programs make sure the following have been removed: Mobile Viewer Cumulative Mobile Viewer URI Generator Load Balancer Transcoder Manager Transcoder Package 2. Navigate to the folder C:\inetpub\wwwroot. Make sure the following folders and their content have been deleted: C:\inetpub\wwwroot\ MobileViewer C:\inetpub\wwwroot\LoadBalancer C:\inetpub\wwwroot\UriGenerator C:\Program Files (x86)\qognify\transcoder Page 27 of 36

32 VisionHub Licensing 4 VisionHub Licensing The VisionHub system is license-protected. You need to purchase proper licenses for servers and for concurrent connections. See the Qognify Price List for details. Once licenses are purchased and delivered, read carefully and carry out the procedures explained in the Licensing Quick Start Guide. Licenses must be activated before you start work with Mobile Viewer, otherwise an error message is displayed. Page 28 of 36

33 Installing User Certificates 5 Installing User Certificates A certificate is a mechanism used to verify an identity on a computer and/or over a computer network. Certificates can identify different types of entities, such as, persons, hosts and services. Many restricted-access computer services are configured to identify potential users via certificates, and allow or deny access according to the certificate contents. The Video Application Server is configured for anonymous authentication with limited security. The Mobile Viewer and Web API communicate using an authenticated end-point, SSL transport security with certificate authentication. The Mobile Viewer and Web API each install a self-signed temporary certificate. For greater security you can optionally install user certificates using the Certificate Standalone Utility provided. Refer to the VisionHub Security Configuration Guide to learn how to use the utility. The guide can be downloaded from the Partner Portal. Page 29 of 36

34 Multi-Site Architecture and Configuration 6 Multi-Site Architecture and Configuration Mobile Viewer client, streamer and transcoder can be installed in both sites, central and remote. Remote transcoder(s) can be managed either by remote Application Server or by the central. Figure 6-1: Mobile Viewer Multi-site Architecture Upon first time login, a login page opens which lets the administrator define the Video System Access Service IP address and port. Video System Access Service is the VisionHub Web Server IP address (see Figure 3-13: First Time Login). If you enter the remote site web server IP, then you will see only the devices that are physically connected to the remote site and will be able to add your Streamer and Transcoder Servers to this site. If you enter the central site web server IP, then you will see all devices installed in all sites. In this case, you will be able to decide where to add your Streamer and Transcoder Servers : either to the remote or central site. Note that even if the device is physically connected to the remote site, it can still be logically added to the central site. Then in the centre you watch video from the remote site. Once logged in, you are prompted to save the Streamer and Transcoder Servers IP addresses. You should add all installed Transcoder Servers (see Figure 3-15: Server Settings Page). Configure Server Settings as follows: Web Server Local IP Address: Used when the network has a DMZ configuration to define the address of the web server in the internal network. Streaming Server Address (outer): If there are streaming servers installed over the public internet then define the outer address. Page 30 of 36

35 Multi-Site Architecture and Configuration Streaming Server Address (WAN): If the streaming servers are installed on an intranet define this IP. If all servers are in the same LAN then the outer address and the WAN address are the same. Streaming Server IP Address (LAN): This IP is used by the streamer server to communicate with the Transcoders. Configure Transcoder Settings are as follows: Figure 6-2: Transcoder Settings Page 1. In the Transcoder Settings page, for Video Application Server, specify the User Name and Password and then test the connection to the Video Application Server, by clicking Verify. TIP: The default user name and password is admin. If entering another user name, enter the user name who has privileges to setup Mobile Viewer. IMPORTANT: If there are several transcoders in the list, decide to what Video Application Server you need to add each transcoder and configure transcoder(s) per site. 2. To add a transcoder to a Video Application Server, specify the Transcoder IP Address (and port), and click Add. The transcoder IP address and port is added to the pane on the right. 3. Click Save. Page 31 of 36

36 Appendix - IIS Configuration 7 Appendix - IIS Configuration Before Mobile Viewer installation it is necessary to configure the IIS server according to the below figures. 7.1 Windows Sever 2012 R2 1. Go to Server Manager > Manage > Add Roles and Features. 2. Configure roles and features as shown in the below figures. Page 32 of 36

37 Appendix - IIS Configuration Windows Server 2012 R2 Roles Configure Windows Server 2012 R2 Roles as shown on the below figure. Figure 7-1: Windows 2012 Roles Page 33 of 36

38 Appendix - IIS Configuration Windows Server 2012 R2 Features Configure Windows Server 2012 R2 Features as shown on the below figure. Figure 7-2: Windows 2012 Features Page 34 of 36

39 Appendix - IIS Configuration 7.2 Windows Server Roles Configure Windows Server 2008 Roles as shown on the below figure. Figure 7-3: Windows 2008 Roles Page 35 of 36

40 Appendix - IIS Configuration Features Configure Windows Server 2008 Features as shown on the below figure. Figure 7-4: Windows 2008 Features Page 36 of 36