Tech Note 32: Configuring the NetVR Web Service

By configuring the NetVR Web Service, you can give users access to NetVR video from their Web browsers or
mobile devices. They will be able to view live video, search for and play back recorded video, and control the
pan/tilt/zoom functions on cameras connected to NetVR servers.

Overview
The NetVR Web Service connects to the NetVR server as a client and transcodes captured video into JPEG files.
The service then sends the JPEGs to the browser at the speed requested by the browser, or as fast as possible if
the requested rate is too high for the connection.
Video can be viewed on:
 The local area network (LAN) or over the Internet using a web browser.
 A mobile device using a mobile browser or the NetVR Client.

Browser Recommendations
The web client's Simple interface can be used on any web browser that supports a JPEG image.
The web client's Advanced interface is supported on a wide variety of browsers and devices, including:
 Chrome 43
 Firefox 38 and 39
 Internet Explorer 9 and 11
 Safari 7 and 8
For information on selecting a web client interface, see page 4.

Installing and Configuring the NetVR Web Service

If the NetVR Web Service is not installed, you will need to download and install it. Once the installation is complete,
you can configure the Web Service to enable it for use.

To download and install the NetVR Web Service:

1. Click the Install NetVR Mobile App Windows Web Service link.
This link is available from all NetVRs operating on Release 4.5 or later, and from the
Configuration : Cameras : NetVR Appliances page of the NetBox system.
2. Double-click the downloaded file and use the NetVR Web Service Setup Wizard to
install the Web Service.
3. When the installation is complete, the Web Service login page opens in your browser.
4. Log into the Web Service and follow the instructions below to configure it.

To configure the NetVR Web Service:

1. In the Servers section of the Web Service Configuration page, do the following:

LenelS2 1 #TN-32-03   March 2024

Tech Note 32 Configuring the NetVR Web Service

 Enter the Address of the NetVR Server to which you will be connecting (for example,
192.168.1.240).
 Enter the Port used by the NetVR Server. By default, the port is 22609.
2. In the Administration Configuration section, do the following:
 In the Username and Password boxes, enter the username and password for the
account the NetVR Web Service will use to connect to the NetVR Server.
 In the Verify Password box, enter the password again.
 Click Update Configuration to save your changes.
 In the confirmation dialog box, click Restart to restart the Web Service.
3. To verify the configuration, open a web browser on the NetVR Web Service computer, enter
the IP address of the NetVR server (127.0.0.1), select the web client Advanced
interface (the Thin Client), log in if necessary, and confirm that video can be viewed from a
connected camera.

To start the NetVR Web Service:

1. Click the Windows Start button.
2. Select All Programs : NetVR Web Service, then Start NetVR Web Service.

Note:
The NetVR Web Service uses a significant amount of computer resources to trans
code video. Required resources increase in proportion to the number of
simultaneous connections and the data rate of incoming video. Hardware
upgrades might be necessary to support heavy Web Service workloads.

Adding User Accounts to Your NetVR Web Server

Install the NetVR Client and use it to add a user account to your NetVR Web Server for every Web Service user.
The user accounts will be used by the NetVR Web Service to access the cameras connected to NetVR.

To add a user account:

1. Log into the NetVR Client as an administrator.
2. In the toolbar, click the Config (Setup) Page button.
3. In the Configuration tree, click the plus sign (+) next to the NetVR Server to expand its setup
menu.
4. Click Users to display the Users configuration page.
5. Under Details, do the following:
 Click the New button.
The Username field is filled in automatically with the value New User.
 Enter a Username and Password for the new user.

LenelS2 2 #TN-32-03   March 2024

Tech Note 32 Configuring the NetVR Web Service

 Enter the password again in the Password Confirm field.

 From the User Group drop-down list, select an access level type for this user.
6. In the Authorized Sources tree, designate the cameras this user will be able to access for
viewing live and recorded video.
7. Click the Apply button to add the user to the NetVR Web Server.
For more detailed instructions, see the Setting Up Users section of the NetVR Setup and
Configuration Guide.

Selecting a Web Client Interface

The web client has two interfaces: Advanced and Simple. The Advanced interface is similar to NetVR Client in its
features and functionality. The Simple interface is more limited in its features, but it works on nearly every web
browser in production, and it is designed for use on mobile phones.
Users can use any web browser to run the web client by entering the IP Address of the NetVR Server as the URL.

To run the web client and choose a web client interface:

1. Open a web browser on the NetVR Web Service computer.
2. Enter the IP address of the NetVR server: 127.0.0.1.
3. To open the Advanced interface, click the graphic for the Thin Client or Mobile Client.
4. To open the Simple Interface:
 Click the Simple link at the bottom of the page.
 Select a server from the drop-down list, and click Go.
 Enter your username and password and click Login.

About the Simple Interface

The web client's Simple interface is designed to provide static images to any web browser that does not fully
support JavaScript. This includes most mobile devices.
When you first log in to the Simple interface, a list of the available cameras on that server is displayed. Simply click
on a link to view live video from that camera.
 Refresh: This displays the most recently captured image.
 Size: Click plus [+] to increase the size of the image or minus [-] to decrease the size. The smallest size is
128x96 pixels.
 Quality: Click plus [+] to increase the image quality or minus [-] to decrease the quality. The highest quality
is 10 and the lowest is 0. The lower the number, the more pixilated the image appears.
 Rate: This is how many seconds you want to wait until receiving a new image. If your cell phone has
difficulty displaying the image before it refreshes, increase this value.
 Back: This displays the list of cameras available to you.
 Logout: This logs you out of the current account and allows you to log in as a new user.

LenelS2 3 #TN-32-03   March 2024

 Tech Note 32 Configuring the NetVR Web Service

Configuring Multiple Video Servers

To Configure Multiple Video Servers, you must modify the file:
C:\ProgramFiles\S2NetVR\Webservice.ini
A standard Webservice.ini file includes the following information:
 ServerX: This is the server number, where X ranges from 0 to 15.
 address: This is the IP address of the NetVR.
 port: This is the port used by the NetVR. By default the port is 22609.
 pasthroughenabled: This allows the user to log in without credentials. (1=enabled, 0=disabled).
 passthroughusername: This is the account used by the web server to connect the NetVR. It functions the
same way as other accounts on the system.
 passthroughpassword: This is the corresponding password of the account used as the
PassthroughUsername.
 autoPopulate: This is used to automatically pass through enabled servers (1=enabled, 0=disabled).
 timeout: This is the number of seconds that a search request will wait for results before timing out. The
Timeout line is not included by default and must be added manually, if desired.
 csrf: This enables protection against cross-site request forgery exploits. CSRF applies to all servers and
should remain under the [settings] line. (1=enabled, 0=disabled).
To add a server, copy the entire [Server0] section and paste it above the [Settings] section, then change the
information for the added server as desired. Be sure to increment the number of the server. For example, the first
line for the second server would be [Server1], and the first line for the third server would be [Server2].

Making the Web Service Accessible from Outside Your LAN

To allow clients from outside your local area network to access your NetVR Web Service, you must change the
router settings to forward port 80 to the Web Service's IP address. See your router user manual or go to
http://www.portforward.com/routers.htm for instructions.
Alternatively, you can change the LenelS2 NetVR Web Service port number. To do this, edit the LenelS2 NetVR
WebService configuration file. The location and name of the file varies depending on the operating system where
the Web Service is installed. For example, in Windows, the location is:
C:\Program Files\S2 NetVR\WebService

©2024 Carrier. All rights reserved. All trademarks are the property of their respective owners. LenelS2 is a part
of Carrier.

LenelS2 4 #TN-32-03   March 2024