background image

Getting Started – Ubuntu

3 Set up the AVHS portal

Server Watchdog

bin/server_watchdog.php

Checks that the servers (web server, ST server and media server)
are up and running.
To determine if a server is available or not, an HTTP request
is sent to the server. The database is updated according to
whether the server responds to the request or not. The database
is updated during each test to set the time when the server
was last tested.
Run the script on every server in the system. One instance of
the script will never test the same server at the same time on
a multi portal system.

Alarm Closer

bin/alarm_closer.php

Checks for recently stopped JPEG and edge storage alarms,
updates the corresponding events and sends WebSocket
notifications. This service is needed for JPEG alarms because
devices such as cameras do not explicitly report when alarms
end. For the edge storage alarms, this service is needed because
cameras do not report when edge storage alarms end. Make
sure that at least one instance of this script runs at any given
time otherwise JPEG alarms and edge storage alarms will not
be handled properly.

Copy the startup script to

/etc/init.d/

and link it to your system’s default run level:

# cd /etc/init.d/
# cp /home/sts/current/setup/sthelpers .
# update-rc.d sthelpers defaults 90

To start the ST helpers:

# service sthelpers start

3.3.3 Start the Websocket server

Copy the websocket server startup script to

/etc/init.d/

and link it to the system’s default run level:

# cd /etc/init.d/
# cp /home/sts/current/setup/wssd_websocketserver1 .
# update-rc.d wssd_websocketserver1 defaults 90

To start the websocket server:

# service wssd_websocketserver1 start

Note

The Web GUI will show an error message and auto-logout if the communication with the WebSocket server fails.
This may be due to certificate or connection errors. Verify connectivity through the web browser by going to
https://<websocketserver_address>:<websocketserver_ssl_port>/socket.io/

3.3.4 Start the ST server

The ST server will usually be started at boot time. The ST server setup script automatically creates a script that can be used to do
this. Copy the scripts to

/etc/init.d/

if you are using an SysV style init system and link it to the correct run level. The scripts

should be started after all network services are configured.

# cd /etc/init.d/
# cp /home/sts/current/setup/stsd_stserver1 .
# update-rc.d stsd_stserver1 defaults 90

To start the ST servers:

# service stsd_stserver1 start

15

Summary of Contents for Ubuntu

Page 1: ...Getting Started Ubuntu AXIS Video Hosting System ...

Page 2: ...held responsible for any technical or typographical errors and reserves the right to make changes to the product and manuals without prior notice Axis Communications AB makes no warranty of any kind with regard to the material contained within this document including but not limited to the implied warranties of merchantability and fitness for a particular purpose Axis Communications AB shall not b...

Page 3: ...1 2 7 Configure Apache 11 3 Set up the AVHS portal 13 3 1 Edit the AVHS configuration file 13 3 2 Run the setup scripts 13 3 3 System startup 14 4 Adding devices to the system 17 4 1 Connect and register products with firmware 5 xx 17 4 2 Upgrade a firmware 4 xx product 18 4 3 Connect and register upgraded products 18 4 4 No DHCP server 19 5 Configure the system 20 5 1 Dispatcher configuration 20 ...

Page 4: ... media generated in the system WebSocket server One or more servers enabling AVHS to push information to a webpage For guaranteed compliance with proxy and firewalls websocket servers should listen to standard web ports 80 443 in that case they need to run on a separate IP or behind a load balancer that is capable of redirecting websocket traffic HAProxy Balancer A reverse proxy listening on the i...

Page 5: ... greater numbers of users sign up for the service The configuration of each server can be e g 2 x Intel Xeon 3 0 GHz processors or better 50 GB local hard drive or better Minimum 3 5 GB memory 2 x redundant Host Bus Adapters for a connection to the SAN Storage Area Network 2 Gigabit Ethernet connection for a connection to the NFS Network File System Note For larger installations NAS Network Attach...

Page 6: ... with firmware 5 40 xx Source port Source application Destination port Destination application Protocol Any Camera 80 443 80801 Dispatcher TCP Any Web server 443 Dispatcher TCP Any End user 80 443 Web server TCP Any Camera 80 Web server TCP Any ST server 80 Web server TCP Any Web server 80 Internet WSDL s TCP Any Web server 3306 SQL server TCP Any Camera 8080 ST server TCP Any Web server 8080 ST s...

Page 7: ...e router and the haproxy balancer example conf contains rules for the balancer Important A production system requires both the balancer and service router to be fully functional If the service router is missing the following features will not work for all clients The device proxy API proxy_url will work url will not The Access device link in the classic GUI If the service router is missing the fol...

Page 8: ...s Most of the commands in this document should be run as root although there are a few exceptions The following conventions apply run this as user root run this as user sts or equivalent shows output or comments 2 1 3 Create user sts or equivalent and the home directory Create a user for the AVHS system useradd sts d home sts m passwd sts Enter new UNIX password Retype new UNIX password passwd pas...

Page 9: ...ions The instructions provided here rely on the installation of specific versions of various applications and systems MySQL Apache2 PHP5 etc Following these instructions will ensure the correct versions are installed The instructions provided below apply to Ubuntu 2 5 1 Install MySQL Install the required MySQL components and set the password apt get install mysql client mysql server mysql common 2...

Page 10: ... OpenSSL has already been installed when you installed PHP5 as described in 2 5 3 Install PHP on page 9 a2enmod ssl Edit the ports conf file to include the ports below Note Make sure to verify that Listen 80 and Listen 443 are not used anywhere else in the ports conf file before adding it through this step vi etc apache2 ports conf Listen 80 Listen 443 Comment the line NameVirtualHost 80 to NameVi...

Page 11: ...peg8 dev liboil0 3 dev libffi dev libpng12 dev libsqlite3 dev apt get install libpng12 0 yasm bzip2 zlibc libglib2 0 0 libglib2 0 dev su sts mkdir home sts gst cd home sts gst cp av home sts current examples gst install sh gst install sh exit 2 7 Configure Apache Edit the default environment variables for Apache vi etc apache2 envvars Change users to sts export APACHE_RUN_USER sts export APACHE_RU...

Page 12: ...tion server status SetHandler server status Order deny allow Deny from all Allow from 127 0 0 1 Location IfModule Important It is recommended to consider the directives ServerTokens and ServerSignature and set values suitable for your setup 12 ...

Page 13: ...ile and then running the relevant setup script 3 1 Edit the AVHS configuration file The configuration file avhs_config ini should be edited before running the setup scripts su sts vi home sts current setup avhs_config ini Note The AVHS system can also be set up behind a NAT RTMPT forwarding service must be configured for the websocket server to start How to configure RTMPT forwarding is beyond the...

Page 14: ...up_sthelpers php exit 3 3 System startup 3 3 1 Start the web server Copy the file webserver1 virtualhost to your Apache virtualhost folder cd home sts current setup cp webserver1 virtualhost conf etc apache2 sites available Note If the Web App and the API are hosted on a different domains Cross site HTTP requests CORS must be enabled by the server hosting the API in the configuration file webserve...

Page 15: ...Copy the startup script to etc init d and link it to your system s default run level cd etc init d cp home sts current setup sthelpers update rc d sthelpers defaults 90 To start the ST helpers service sthelpers start 3 3 3 Start the Websocket server Copy the websocket server startup script to etc init d and link it to the system s default run level cd etc init d cp home sts current setup wssd_webs...

Page 16: ...dia server service mediaserver_mediaproxy1 start service mediaserver_evostream1 start 3 3 6 Verify installation The AVHS installation is now complete Devices and users should be able to connect Open the test page to view basic information about the installation https your host name admin test php Note The media server uses a lot of open file descriptors Check your user s limit on file descriptors ...

Page 17: ...ackage you can obtain an OAK from the AVHS Helpdesk 4 1 Connect and register products with firmware 5 xx Several of Axis network cameras and video encoders with firmware 5 xx have built in AVHS support with One Click Camera Connection Check the technical specifications found in the product s datasheet or User s Manual to see if the product includes AVHS support To connect and register an Axis prod...

Page 18: ...ce settings The product has a random root password and is only accessible through an AVHS portal See 4 3 Connect and register upgraded products for instructions how to connect the product to the portal 4 2 1 Example firmware Also available from the AVHS web page are special firmware files known as example firmware These files are intended for limited testing only and should only be used in cases w...

Page 19: ...evice s default index page Depending on the firmware version the default index page can be accessed a few minutes from when the device was started To discover the device on your local network use e g broadcast ping and arp or download AXIS IP Utility from www axis com The default index page also allows viewing of the device s Server report which can be useful for troubleshooting 19 ...

Page 20: ...e To get a fault tolerant system if the DNS servers are down add the following lines to etc hosts 87 237 210 63 dispatcher sts axis com 206 71 169 185 dispatchus1 sts axis com 195 60 68 116 dispatchse1 avhs axis com 195 60 68 117 dispatchse2 avhs axis com 5 2 Periodic routines 5 2 1 Quota cleanup The current bin cleanup php script deletes media events alarms and recordings for users that have exce...

Page 21: ...shes Camera connected but the system could not register the camera 5 amber off flashes Other error Depending on the error the camera will retry after a few seconds 6 2 Troubleshooting FAQ Symptom Solution Camera problems Devices do not connect shown as Not connected in the admin GUI Check the server report parameters etc URL port and brandspec in etc axisstc conf in the camera Check the IP address...

Page 22: ...y available via HTTPS Database problems Database is not working Run current db update_db php to see if you have access If you have database replicas ensure that the master configuration is correct on all nodes i e that the host is not 127 0 0 1 or localhost Try e g current db update_db php dostuff sql SELECT from stservers Web portal problems Changes in System configuration have no effect Verify t...

Page 23: ...vent path set in the configuration This should be _ST_config PATH_EVENTS Does the path have a trailing Does the directory exist Does the web server user have write permission Is the disk full Manual scheduled recording does not work while most other functionality seems to work Check _ST_config PATH_PHP in the configuration file This should point to the PHP binary not to a directory Run which php i...

Page 24: ...Control button for about 15 seconds until the Status indicator flashes amber 3 Release the Control button The process is complete after about 1 minute when the Status indicator turns green The product has been reset to the factory default settings Products with a power button 1 Press and hold the Control button and the Power button for about 15 seconds until the Status indicator flashes amber 2 Re...

Page 25: ...owever that your old devices can still be configured to go directly to your system A fully operational AVHS portal has the following benefits The device and the AVHS portal can identify and authorize each other The user cannot move the device to a provider other than the one subscribed to i e yours 7 2 Optional extra components The AVHS portal can be configured to send various types of notificatio...

Page 26: ...AXIS Video Hosting System Ver M7 3 Getting Started Ubuntu Date June 2015 Axis Communications AB 2008 2015 Part No 1479547 ...

Reviews: