Category: exacqVision Webservice

Categories
Knowledge Support Support exacqVision Webservice Categories Products

Setting up a secure ESM instance to see video with a configured web service

Product

  • exacqVision Enterprise System Manager 2.0.4 to 5.10

Note: As of version 5.12, ESM no longer utilizes a Web Service to directly stream live video.  The instructions below only apply to version 5.10 and lower.

Description

Setting up a secure ESM to see video with a configured exacqVision Web Service.

<br>

How to set up a certificate for Web Service

If your ESM is using https, the web service must also be using HTTPS to stream video to the ESM UI. See links to KB’s below to configure your exacqVision Web Service for SSL.

Note: For your web browser to securely reach your exacqVision Web Service located internally on your network, you must port forward your secure web service port (default 443) to the internal IP of your exacqVision Web Service.

<br>

Categories
Knowledge Support Support Categories exacqVision Webservice Products

Disable or Uninstall exacqVision Web Service

Description

If you are not using the exacqVision Web Service and for cybersecurity reasons want to disable, you can either uninstall it or disable it from starting.

<br>

How to Disable the Web Service

Windows

Start -> Programs -> exacqVision Web Service -> Set exacqVision Web Service to start manually.

Or

Open Windows Services by going to Start -> Type “services” or “services.msc” in the Start Menu search -> Choose Services

Once Services is open, Find “exacqVision Web Service” -> Double-Click exacqVision Web Service -> change Startup Type: to Manual or Disable -> apply -> OK

<br>

Linux

Open a terminal window Applications -> Accessories -> Terminal and type sudo /usr/local/exacq/webservice/service.sh manual

<br>

How to Uninstall the Web Service

Windows

Start -> Programs -> exacqVision Web Service -> Uninstall

or

Go to Control Panel -> Programs and Features -> Locate and highlight “exacqVision Web Service” -> Choose Uninstall

<br>

Linux

Open a terminal window Applications -> Accessories -> Terminal and type Sudo dpkg –remove webservice

<br>

Disable-or-Uninstall-exacqVision-Web-Service.pdf
Categories
User Guides exacqVision Webservice Categories Products

Settings for motion detection sensitity on Samsung cameras may appear different when deleting and re-adding camera

Description

exacqVision displays a value 1-100 for motion sensitivity. The camera itself only uses a 1-10 scale. When the user sets the sensitivity to 23, the actual value maps to 2, but the GUI still displays 23. If the camera is deleted and re-added, the sensitivity would display 20, rather than 23.

<br>

Settings-for-motion-detection-sensitity-on-Samsung-cameras-may-appear-different-when-deleting-and-re-adding-camera.pdf
Categories
Knowledge Support Support Categories exacqVision Webservice Products

How to update the exacqVision web server

Updating exacqVision Web Server version via Web Service Configuration

  • Open your web browser and navigate to your exacqVision web server.

<br>

NOTE: If accessing from the computer hosting the exacqVision web service, the default address is http://127.0.0.1.  If exacqVision Web Server has been configured to use a custom port that port number must appended to the address (http://127.0.0.1:8080)You should now see the exacqVision Web Server landing page.

<br>

  • You should now see the exacqVision Web Server landing page.
  • Click on the “Web Service Configuration” hyperlink in the lower right-hand corner of the exacqVision Web Server landing page

<br>

  • Enter your Web Service Configuration admin credentials when prompted.

<br>

  • Click on Configuration to expand the Section.
  • Click on Updates to bring up the Update Page.
  • Click Check for Updates.

<br>

  • If No updates are available you will see the following, click OK to return to configuration.

<br>

  • If updates are available, the most recent will be displayed. 
  • Click on Install to launch the installer or cancel to cancel the update.

<br>

  • You will be prompted to confirm the installation, click Yes to proceed.  

<br>

  • A series of screens will appear, showing the update is being downloaded and then installed. 

<br>

  • Once the install has completed you will be returned to the Web Service Configuration login screen.
  • Enter your credentials or click the “Return to Landing Page” hyperlink in the upper right-hand corner.

<br>

Checking The Current Version

  • The update can be verified in Web Service Configuration on the Service Info Page.

<br>

How-to-update-the-exacqVision-Web-Server.pdf
Categories
User Guides Categories exacqVision Webservice

How to disable TLS version 1.0 in the exacqVision web service – LEGACY

Applicable Versions

This document now applies only to exacqVision Web service 8.8 and earlier. Beginning with version 9.0, the web service no longer uses Apache. If you need to disable TLS 1.0 we recommend the use of a web service gateway. The steps in configuring a web service gateway are detailed in Configuring Nginx or Apache as a Web Service Gateway

<br>

Description

Disabling TLS 1.0 is regularly recommended by security scans. The following steps explain how to disable TLS 1.0.

Note: While TLS1.0 is insecure, it is required for IE8-10 to work by default. Users of those browsers have the ability to enable support for TLS1.1 or 1.2 in their browser settings, but it will have to be done for each user.

<br>

To disable TLS 1.0 in the web service:

  1. Using a text editor, open the file C:\Program Files (x86)\exacqVision\WebService\Apache\conf\extra\httpd-ssl.conf or /etc/evapache/extra/httpd-ssl.conf.
  2. Search for the line starting with SSLProtocol. By default, this line looks like: SSLProtocol all -SSLv2 -SSLv3
  3. Edit the line to add -TLSv1.  For example, the line would now look like SSLProtocol all -SSLv2 -SSLv3 -TLSv1
  4. Save the edited file.
  5. Restart the web service.

There are many variations of security protocol configuration that can be applied to meet a specific user’s needs, many of which fall outside the scope of a KB. Interested individuals should reference Apache’s documentation on configuring the SSL module: https://httpd.apache.org/docs/2.4/en/ssl/

<br>

Categories
Knowledge Support Categories exacqVision Webservice Products

Axis fisheye camera dewarping and the exacqVision Web Service

Only supported on Ubuntu 12.04, Ubuntu 14.04, Windows 7, 8, and Windows Server 2010.
These instructions are dependent upon your system supporting OpenGL 3.0 or higher.

WINDOWS

  1. On an exacqVision Server, change the Operating System to automatically login to “admin” following the instructions in KB 45061.
  2. Place the attached webservice_fisheye_fix.bat file into your auto-login user’s Desktop.
  3. Use the Windows Task Scheduler to create a task with the following options:

    * Under the “General” tab, check “Run with highest privileges”
    * Under “Triggers”, click “New”. Set “Begin the task” to “At log on”
    * Under “Actions”, click “New”. “Browse” to the “webservice_fisheye_fix.bat” above.
  4. Reboot.
    NOTE: At each boot, there will be a command prompt left running, this can be minimized, but not closed.


To revert:

  1. Delete the “webservice_fisheye_fix.bat” file and remove the Scheduled Task.
  2. Configure machine to login as “user”.
  3. Reboot.

<br>

UBUNTU 12.04 and 14.04

  1. On an exacqVision Server, change the Operating System to automatically login to “admin” following the instructions in KB 39795.
  2. If on 14.04, run the following single-line command in terminal:
    sudo mv /usr/local/exacq/webservice/bin/libz.so.1 /usr/local/exacq/webservice/bin/libz.so.1.disabled
  3. Place the attached webservice_fisheye_fix.sh file in “/home/”
  4. Place the attached webservice_fisheye_fix.desktop file in “/home/admin/.config/autostart/”
  5. In Terminal, run
    sudo chmod 766 /home/webservice-fisheye_fix.sh
  6. Reboot
    NOTE: If your webservice fails to start after the reboot, rename the file back because it does not exist on your system or the webservice is incompatible with the system version:
    In Terminal, type sudo mv /usr/local/exacq/webservice/bin/libz.so.1.disabled /usr/local/exacq/webservice/bin/libz.so.1

To revert:

  1. Delete the 2 files from steps 3 and 4.
  2. Configure the machine to login as “User”, then run this command:

sudo mv /usr/local/exacq/webservice/bin/libz.so.1.disabled /usr/local/exacq/webservice/bin/libz.so.1

<br>

Axis-fisheye-camera-dewarping-and-the-exacqVision-Web-Service.pdf
Categories
Knowledge Support Categories exacqVision Webservice

Dewarping of Axis hemispheric cameras does not work through web service

Affected platforms

exacqVision web service 7.4

<br>

Symptom

The Axis dewarping library uses OpenGL and therefor will not work when launched as a Windows service or without access to X Windows in Linux.

<br>

Workaround

Run the webservice as an application rather than a service.

In Windows:
1. Start => Run cmd enter
2. Run the command “c:\Program Files (x86)\exacqVision\WebService\bin\evws-frontend.exe” debug
NOTE: The quotes are required

In Linux:
1. Open the terminal
2. Run command /usr/local/exacq/webservice/webservice

<br>

Resolution

Any fix is dependent on Axis modifying how their dewarping libraries work.

<br>

Dewarping-of-Axis-hemispheric-cameras-does-not-work-through-web-service.pdf
Categories
Knowledge Support Support exacqVision Webservice Categories Products

Weblink keyword missing in email notification due to version incompatibility

Affected platforms

exacqVision Server 6.8 or earlier
exacqVision Web Service 7.2 or later

<br>

Symptom

If the web service is 7.2 or later while the exacqVision Server is 6.8 or prior and the notification profile configuration contains a {weblink} keyword, the email received will not contain a proper link to the web service.

<br>

Workaround

Update the exacqVision Server or downgrade the web service to compatible versions.

<br>

Resolution

No resolution planned.

<br>

Categories
Knowledge Support Support exacqVision Webservice Categories Products

How to disable all logging in the web service

Description

Note: This KB contains the information found in KB 24844, as well as additional information.

Based on a customer request ,the following steps document how to disable all logging in Apache:

  1. Use a text editor to open the Apache configuration file.
    – Windows: C:\Program Files (x86)\exacqVision\WebService?\Apache\conf\httpd.conf.
    – Linux: /etc/evapache/httpd.conf
  2. Find the following line in the Access log
    – CustomLog “logs/access.log” common
  3. Add a hashtag/pound sign at the start:
    – #CustomLog “logs/access.log” common
  4. Find this line in the Error log
    – ErrorLog “logs/error.log”
  5. Add a hashtag/pound sign at the start:
    – #ErrorLog “logs/error.log”
  6. Save the file and restart the exacqVision Web Service.

    Note: Depending on the user’s SSL configuration, the above steps may need repeated in the httpd-ssl.conf file.
How-to-disable-all-logging-in-the-web-service.pdf
Categories
Knowledge Support Support exacqVision Webservice Categories Products

Using the ExacqVision Web Service to Connect to a Server on a Non-default Port

  1. Open a web browser on the server and type http://127.0.0.1 as the URL to access the Web Service. Click on the Web Service Configuration link in the bottom-right corner.
    <br><br>
  2. Enter the Web Service administrator username and password to log in.<br><br>
  3. Edit the port number to match the custom port number configured for your server.
    • For Web Service version 7.8 and above: Open the Server Connections page, click Add Server to add a new server, or highlight an existing entry and click Edit.
      <br><br>
    • For Web Service version 7.6 and earlier: Open the Servers page and type the new port over the existing port. Click on Update Configuration and then confirm to restart the Web Service.

<br>