background image

Getting Started – Ubuntu

6 Troubleshooting

3. Keep the Control button pressed for about 15 seconds until the Status indicator flashes amber.

4. 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 restart button

1. Press and hold the Control button and the Restart button at the same time.

2. Release the Restart button but continue to hold down the 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. Release the Control button but continue to hold down the Power button for about 1 minute until the Status indicator

turns green.

3. Release the Power button and re-assemble the product.

4. The process is now complete and the product has been reset to the factory default settings.

24

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: