JVigilancia is a Java program. This means that a Java virtual
machine is required to run the program. In addition, JVigilancia uses
some Java features that are not present as default options, and they
must be downloaded and installed separately.
Download and install these products if they are not present in
your system.
After downloading JVigilancia, you must have a file named as 'jvinstall-N.M.P.jar', where N.M.P is the version number. Double-click this file, if Java 1.4.X is properly installed in your system, the installation process will begin.
Panel 1: Language selection
Not a long list...
Panel 2: Welcome.
Just click on next.
Panel 3: Prerequisites.
One more time: please, check the list and verify that you have all the required software installed before continue. If you are sure, click 'next'.
Panel 4: License.
Read the license. Your choice: continue or not.
Panel 5: Target directory.
Select the directory for the installation.
Panel 6: Components to install.
'Base' is the pack to choose to install the executable program.
'Docs' will install the documentation.
'Sources' copies the program sources if you are interested.
Panel 7: JMF location.
Warning: under certain circunstances this panel may not appear. Continue reading.
One of the Java components that must be installed prior to JVigilancia is JMF. If JMF installation configures Java properly, its location will be automatically detected and this panel will not be presented. If JMF was installed but is not detectable, this panel will appear, and you must type in the edit box the full path to the file 'jmf.jar', part of JMF. Use any search tool in your system to find this archive. It is necessary to enter the correct path to continue with the installation.
Panel 8: Java Mail location. Step 1.
Warning: under certain circunstances this panel may not appear. Continue reading.
Another Java component that can be installed before JVigilancia is Java Mail. It is necessary if you want to receive e-mail notifications from JVigilancia. It is your choice. Leave the edit box blank if Java Mail was not installed. Or fill it with the full path to 'mail.jar' if Java Mail was downloaded and installed. If 'mail.jar' is in the classpath, it will be automatically detected and this panel will not appear.
Panel 9: Java Mail location. Step 2.
Warning: under certain circunstances this panel may not appear. Continue reading.
Java Mail needs Java Activation also. If Java Mail was not selected in the previous panel, this one will not appear. If the file to find: 'activation.jar' was placed in the same directory that the file entered in the previous panel, it will be detected automatically. In any other case, enter the full path to 'activation.jar'
Panel 10: Installation
Click on next after installation.
Panel 11: Shortcut creation.
Shorcuts can be created only in "Microsoft Windows and Unix and Unix-based operating systems (like Linux), which use the X11 GUI-System and FreeDesktop.org based shortcut handling (such as KDE and Gnome).". This is an extract from IzPack documentation, the tool used to generate the installer. Sorry if your system is not supported.
Panel 12: Finish line.
Before start JVigilancia install, configure and test any
camera that you want to use. They must be plugged and operational.
Start JVigilancia. The first time the program is executed,
the system will be checked looking for operational webcams. Be
patient, the process can take a couple of minutes. At this stage,
only VfW cameras can be detected. Internet (IP) cameras can not be
detected, they will be registered with the program later.
If this is not the first time that the program is executed,
and you have add new webcams to your system, you can still force
their detection: choose Cameras->Detect Installed Devices. The
detection process will be started again.
Internet (IP) cameras are not detected automatically because
they are not registered with the operating system. Once installed
and tested using their native setup, select
File->Preferences->Internet Cameras.
For
each camera:
Click 'Add Camera'. A unique URI
will be created automatically for the device.
Enter the Internet Camera URL. It
is the URL that you enter in your browser to get a single frame
from the camera. The camera documentation must provide you with
this information.
The user and password fields are
optional. They must be provided only if you secured your camera
access. They are the same that your browser request each time you
want to see your camera view. Caution! In
their actual version, JVigilancia does not store sensitive
information in encripted format. Don't enable this feature if your
system can be used by strangers.
Image size is mandatory, but if
you have the camera connected and the previous fiels are correct,
you can press 'Get From Camera', and the are obtained for you.
It is very convenient to have
your camera connected and press on 'Test Camera' to get a sample
and verify the data provided.
If you don't click 'Save' right now, you will be prompted to
save before leaving preferences.
At this point, the hardware is configured. The program has a list
of all the available capture devices plugged in your system: webcams
and/or Internet Cameras.
Another thing to consider: every setting configured in 'Program
Preferences', as Internet Cameras, are settings that will be used in
your system with any open configuration. They don't change each time
that you close a configuration and open another one.
Let's begin the selection of your own running configuration.
The intention is to select all or part of the previously detected
cameras and configure for them both capture params (quality, frame
rate, etc) and motion detection triggers and actions.
Choose File->New Configuration. A new configuration set will
be created and presented in 'Configuration View' mode. While in this
mode, no video capture will be recorded neither any view will be
accesible from remote locations.
The
combo box named 'Capture Device' contains all the devices. Select
any of them to access their properties.
Once the device selected, you can:
Assign to the device a distintive
name. Enter your selection in the 'Camera Name' text field. For
example: 'Main Door', 'Storehouse', etc.
Encoding and bits per pixel are
usually good with their default values.
Video size and frame rate are
very important if your system is low in memory or processor. In any
case, a frame rate of just 2 frames per second is enough for a
clear image and allows several cameras running.
Enable motion detection by
checking the checkbox with this name. All the following controls
will be enabled.
For 'Scheduling' you could select
to have motion detection enabled 24 hours (click 'Run Full Time')
or program this feature only for especified intervals (click 'Run
Based on Calendar'). In the second case, clicking the calendar icon
will open a rule editor.
The 'Sensitivity' slide bar
allows you to adjust the 'level' of movement to trigger a movement
detection.
'Capture Time' is the number of
seconds of the secuence to capture after a movement is detected. If
this value is 0, no recording will be taken.
'Time Between Motions' is the
number of seconds between movement detections to consider both
detections as different motions. If two motions are separated by a
shortest time, they will be joined in a single secuence.
Under 'Notifications' there are
three options that can be selected in any combination.
With 'e-mail' notification
selected, JVigilancia will send you an e-mail each time a movement
is detected. This feature needs an optinal Java package: Java Mail.
See the 'Java Installation' section of
this document for more info.
'sound' notification plays an
alarm audio signal for each movement detected.
'visual' notification shows a
flashing red area next to camera view after motion detection.
Very important: if you want to
commit the changes, click on 'Set' before changing to a different
camera. The camera actual view, using the selected params, will be
shown in the panel at the right.
Perhaps you are interested in receive e-mail notifications
when some capture device detects motion. Following the previous
instructions, you have enable motion detection in these devices.
But, how and where will be sent the e-mails? Just complete the
following steps to have a running e-mail enabled system. But
remember: as mentioned earlier, this feature needs an optinal Java
package: Java Mail. See the 'Java
Installation' section of this document for more info.
As first step, click on the caption marked as 'General
Configuration'. A panel will be shown where a text field will accept
the e-mail addresses where the notifications will be sent. You can
enter several addresses separated by semicolons ';', as in the
following example. This addresses will receive notifications for all
the cameras in the opened configuration.
The
remaining information for e-mail notifications is not associated
with the actual configuration. It is system related information that
not changes each time you close a configuration and open a different
one. This kind of information is located in File->Preferences.
There, an 'e-mail notifications' label opens the following view.
The
configuration is similar to the one used in your mail client
program. In fact, you will find all this information in whichever
you are using: Outlook, Netscape, Mozilla, Firebird, etc.
'Origin e-mail address (from)' is
a required field where you must type the address that the generated
mails will contain in their 'from' field.
'SMTP Server name/address', also
required, is the server name or IP address of your e-mail provider.
'SMTP Port' is also required, but
the standard value, 25, is often valid.
If your provider requires user
authentication, you must check the appropriate checkbox. At this
moment, user and password text field will be enabled. Caution!
In their actual version, JVigilancia does not store sensitive
information in encripted format. Don't enable this feature if your
system can be used by strangers.
Another important feature of JVigilancia, is the option of
monitoring in remote the view recorded by your cameras. You can use
this feature to watch in real time the actual view, or play the
recoded secuences captured during movement detection. In this way,
after receiving an e-mail notifing a movement, you can connect to
your home/business from any location, and see for yourself the
importance of the alarm. This time again, this kind of functionality
depends on system capabilities (Internet Connection, etc) and not on
a configuration. So, the related configuration panel is located
under Archive->Preferences.
Let's
see the options needed to enable and configure this important
feature:
Selecting 'Web (HTTP) access
enabled' checkbox, will configure your system for remote access.
After the selection, all the following controls will accept input.
'HTTP port', is the TCP port
where the embeded web server will be listening for your request.
The standard value is 80, but if your system already has a web
server running or you want to use a less known port for security
reasons, you can change it here to any other free value. Remember
that if you select a non standard value, you will need to write
this value to call your system. For example, if your system IP
address is 10.1.1.21, and you choosed 81 for the port value, in a
remote connection you must enter in your browser something like
'http://10.1.1.21:81/jvigilancia'.
'User authentication required'
enables basic web authentication to your web access. Each time you
call your system from a remote location, the user and password
entered here will be required by your browser. Caution!
In their actual version, JVigilancia does not store sensitive
information in encripted format. Don't enable this feature if your
system can be used by strangers.
If your system is connected to the Internet using a dialup
connection that offers a dynamic IP address, each time you reboot
your system it will obtain a different address. In this way, it will
be very difficult for you to know when connecting from remote, the
address to write in your browser navigation bar. The last block of
options is an experimental feature that tries to solve this problem
under several conditions: if your connection is a xDSL line, it must
be provided by modem, not router; your access provider has assigned
to you some web space with your own address, something like
'myname.myprovider.com'; and this web space is updated using FTP.
Under these conditions, the following options are available. The
solution implemented tries to copy on each server restart a small
page in this web space that only redirects you to the real instance
of the server.
The checkbox 'My computer has a
dynamic IP address' is the option that you must check to enable
this feature. Remember that it will work only if you are under the
terms described above.
At the edit field labeled as 'FTP
server address', you must type the address of the FTP server
provided by your Internet service provider to update your web site.
At the edit field labeled as
'Write directory in FTP server', you must type the full path to the
write access directory where you want to place the entry point to
your remote access.
'FTP user name' and 'FTP user
password' are the user identification data required for FTP access.
Caution! In their actual version, JVigilancia
does not store sensitive information in encripted format. Don't
enable this feature if your system can be used by strangers.
Once configured, you have two modes of operation when the program
is running: 'Surveillance Mode' and 'Control Mode'. Remember: only
when placed in any of these modes, the program is capturing video and
detecting movement. While in 'Configuration Mode', no work is
processed. Let's explain the two running modes.
This program can be used to monitor your home or business. In this
case, it could be interesting to configure the program to start
always in a running mode with an specific configuration. In this way,
just a single click or even an automatic run on operating system
startup, can put your surveillance system running.
