Intelligent Video Analytics
Server Installation Guide
- Windows
- Linux
1) General Information ... 2
2) Viasys on Windows PCs ... 3
3) Viasys on Linux PCs ... 7
4) Viasys Server Support Package ... 10
Offices:
www.viasys-iv.com - [email protected]
viasys Intelligent Video GmbH Koselstr. 20
60318 Frankfurt – Germany Tel.: +49 69 71 91 388-0 Fax.: +49 69 71 91 388-66
viasys North America 410 13th St. B
Huntington Beach, CA 92648 Phone: +1 714-881-9962
1) General Information
Viasys uses the modern technology of virtual servers to run completely encapsulated on the same machine that is running the VMS or other applications. No additional hardware is needed. Viasys provides virtual machines for Oracle Virtual Box (and also VM-Ware if needed).
Using this technology viasys can be installed on any Windows or Linux
machine. Please note that the automatic install script for Linux supports in its first version only Ubuntu!
No dedicated server needed
Viasys will run side by side with other applications including web server based applications on the same machine. To avoid conflicts, viasys uses port 8081 for web-access (HTTP) instead of the default port 80. The port settings can be changed anytime – see the “advanced user” chapter for details.
30 day trial
When you are finished with the installation, you will have a viasys demo server with 2 analytical channels running for a 30 day trial with full features. After those 30 days no alarms will be triggered anymore.
Full Licence Activation
The viasys servers can be anytime activated to a full licence (or a demo period) with up to 50 camera channels on the virtual machine which is providing the 30 day trial.
2) Viasys on Windows PCs
To install viasys on a Windows PC follow these simple steps:
1) Download and install Oracle Virtual Box (http://www.virtualbox.org/wiki/Downloads) (Select Virtual Box for Windows Hosts)
Important: Install VirtualBox into default directory as given in installation otherwise you need to change path settings as described in advanced section. 2) Download the demo package (viasysServerInstall-Windows.zip)
(A first download-path is http://video-sensor.eu/vipdownload/ViasysServerInstall-Windows.zip)
3) Unpack the zip-file in a new or empty directory
4) Open the Virtual Box and select from File the entry Import Appliance
5) From the unpacked directory, import the file ending with *ovf (viasys.ovf) and click “Next”, then “Finish”.
6) When the import is finished, you will see the viasys virtual machine powered off in the virtual box (do not start it now):
7) Before starting the virtual machine double click on the File “NAT.bat” and wait until the windows that will open stops (and disappears) before moving on with (8)
8) Now select the viasys machine and start it in the virtual box by pressing start. Allow less than a minute and click away any messages such as catching the mouse until you see the machine running. When you see messages like this you can be sure the viasys virtual server is up and running:
Now you can access the web configuration at URL localhost:8081 (which is identical to 127.0.0.1:8081) and configure two analytics demo channels:
Starting and stopping an installed viasys machine
To stop the viasys machine select Machine/ ACPI Shutdown or Close. It is ok to simply send the shutdown signal, no login needed.
Don’t select “Power off the machine”, use “Send the shutdown signal”!
Uninstalling viasys
Uninstall Oracle Virtual Box and remove viasys virtual machine and drive image in File / Virtual Media Manager.
Advanced Users
If you want to run viasys web service on another port than 8081 simply click on NATwithQuestions.bat instead of NAT. You will get asked for the ports you want to use. If you also want to change the ports viasys uses for event notification (from 1080 onwards, one for each channel) the batch file can be modified.
If you want to start viasys at boot time, Oracle Virtual Machine can be installed as a service. Or you can use VM-Ware Server …
If you changed installation directory you have to match the NAT.bat to your VirtualBox installation path.
3) Viasys on Linux PCs
This procedure is for the normal case that the machine you are installing viasys onto will have a internet connection. It’s also possible to install viasys on a offline machine, but it’s not so comfortable. See the “Advanced” section at the end of this chapter for the offline procedure.
To install viasys on a online Linux PC follow these simple steps:
1) Open a console. Make sure you are root and you do have an internet connection and type in the following 3 lines:
wget video-sensor.com/svr/viasys_install.run chmod 744 viasys_install.run
./viasys_install.run
2) You will get notified that the viasys server image is not yet available in the actual directory (which is correct) and asked if it should be downloaded from the internet. Confirm with “1” to do so.
3) The installation script will automatically
The installation process including downloading of all needed images and files may take from 20 minutes on a fast machine to up to 45 minutes and more on a machine with low bandwidth internet connection.
When the message “Viasys is running now” and in the last line “listening on port 3389” appears, viasys is definitely up and running.
You can then press CTRL+C anytime to get back to console – viasys will not stop.
Now you can access the web configuration at URL localhost:8081 (which is identical to 127.0.0.1:8081) and configure two analytics demo channels:
Starting and stopping an installed viasys machine
Use the scripts “viasys_start” and “viasys_stop” in the actual directory to start and stop the viasys server:
./viasys_start Start viasys server
(its ok to press CTRL+C to get back to console without stopping viasys)
./viasys_stop Stop viasys server
If you want to start viasys automatically during booting set a symbolic link in the respective directory to the start script. See “Advanced Users” for details.
Uninstalling viasys
Run the script viasys_uninstall.run in the actual directory: ./viasys_uninstall.run
Troubleshooting:
(This version is tested on Ubuntu Linux versions.)
If the installation process fails, please send us the installation logfile that you will find in the actual folder viasys_install.log or viasys_uninstall.log
Advanced Users
If you want to run viasys web service on another port than 8081 you can change the install script. If you also want to change the ports viasys uses for event notification (from 1080 onwards, one for each channel) the install script can also be modified. If you want to start viasys at boot time, you simply need to create a symbolic link like ln –s <path_to_startscript> /etc/rc2.d/S<free_number>viasys_server.
E.g. ln –s /home/viasys/viasys_start /etc/rc2.d/S80viasys_server Note: You need to be root to add a symbolic link!
Advanced: Install viasys on off-line Linux-PCs
This instruction is only an enhancement for those who want to install the viasys server onto an off-line server. Please note that for this instruction advanced knowledge in linux environments is required.
a) Requirements from internet
1) Download the Oracle Virtual Box rpm or deb package from http://www.virtualbox.org/wiki/Linux_Downloads.
2) Download the NAT setting file from http://video-sensor.com/svr/nat.tar.gz. 3) Download the viasys image from
http://video-sensor.com/svr/viasys.tar.gz.
b) Installation
1) Install the VirtualBox package depending upon your linux distribution: 1.a) For debian package (deb) use: dpkg –i <VirtualBox-3.2...deb> 1.b) For suse package (rpm) use: rpm –i <VirtualBox-3.2...deb> Replace <virtualbox-3.2...deb> with the downloaded filename, e.g.: dpkg –i VirtualBox-3.2-3.2.8_64453_mdv2009.1-1.i586.rpm
If the installation interrupts, it will tell you what packages are also needed. Please install the needed packages and try installation again.
2) Extract the nat.tar.gz and viasys.tar.gz: tar –xzf nat.tar.gz
tar –xzf viasys.tar.gz
4) Run from the directory where the extracted files are stored: VBoxManage import viasys.ovf
5) Run the NAT setting file: ./nat.run
6.) Now you can use the viasys_start and viasys_stop to start and stop the machine: ./viasys_start
./viasys_stop
4) Viasys Server Support Package
Additional to the pure installation files viasys offers a support package to gain maximum benefit out of viasys:
- Server Installation Guide (this document) - User Manual
- viasys PC-Client
(a minimal 1-channel VMS which connects to a viasys channel and shows / displays / stores events including a red alarm box around detected objects)
- viasys Analytics Best Practice
- viasys How-To`s for VMS Integration - Marketing Material
Please download the support package at
