Difference between revisions of "Apertus.ElphelVision Install Guide"

From ElphelWiki
Jump to: navigation, search
(Running ElphelVision)
(Moved "setting the permissions of ElphelVision.sh" to User Guide page.)
 
(7 intermediate revisions by one other user not shown)
Line 1: Line 1:
=Overview=
+
= Overview =
This guide explains how to install ElphelVision on your Elphel camera and a computer running Ubuntu connected to your camera over Ethernet.
 
  
This guide assumes that you have successfully downloaded the required files.
+
This guide explains how to install ElphelVision on your Elphel camera and a computer running Ubuntu (32bit) connected to your camera over Ethernet.
 +
 
 +
This guide assumes that you have successfully downloaded the required files.
 +
 
 +
= Installation =
 +
 
 +
== FTP Transfer ==
 +
 
 +
Use an FTP client of choice (eg. Filezilla) and connect to your Elphel camera.  
  
=Installation=
 
==FTP Transfer==
 
 
Use an FTP client of choice (eg. Filezilla) and connect to your Elphel camera.
 
 
  Default IP: 192.168.0.9
 
  Default IP: 192.168.0.9
 
  User: root / PW: pass
 
  User: root / PW: pass
Upload the complete "ElphelVision" directory in "elphel/Apertus/camera www/" to the "/mnt/flash/html/" directory of your Elphel camera
 
  
You can test if everything worked properly by opening a browser and  
+
Upload the complete "ElphelVision" directory in "elphel/Apertus/camera www/" to the "/mnt/flash/html/" directory of your Elphel camera
going to:  
+
 
 +
You can test if everything worked properly by opening a browser and going to:  
 +
 
 
  http://192.168.0.9/ElphelVision/elphelvision_interface.php?cmd=status  (replace 192.168.0.9 with your Elphel cameras IP).  
 
  http://192.168.0.9/ElphelVision/elphelvision_interface.php?cmd=status  (replace 192.168.0.9 with your Elphel cameras IP).  
If you get lots of xml output installation was successful.
 
  
 +
If you get lots of xml output installation was successful.
 +
 +
<br>
 +
 +
== Running ElphelVision ==
 +
 +
Requirements:
 +
 +
=== Java JRE (Java Runtime Environment)  ===
 +
 +
Careful, OpenJDK produced some drawing artefacts with Text in Buttons, you will get strange color fringes.
 +
 +
Install the Official Java JRE from Sun/Oracle:
 +
 +
first enable the "Canonical Partners" Software Source (Software Sources -&gt; Other Software: enable "Canonical Partners - Software packaged by Canonical for their partners")
 +
 +
then update the software index and run:
 +
 +
sudo apt-get install sun-java6-jre
 +
 +
You can have both of them installed side-by-side
 +
 +
Just installing new Java flavours does not change the default Java pointed to by /usr/bin/java. You must explicitly set this:
 +
 +
To see the current configuration and possibilities:
 +
 +
sudo update-java-alternatives -l
 +
 +
To set the XXX java version as default.
 +
 +
sudo update-java-alternatives -s XXXX
 +
 +
For Sun Java 6 this would be
 +
 +
sudo update-java-alternatives -s java-6-sun
 +
 +
To ensure that the correct version is being called:
 +
 +
java -version
  
==Running ElphelVision==
+
=== VLC ===
  
Requirements:
+
For ElphelVision you require a VLC version 1.1.4 or higher
* recent Java JRE
+
<pre>sudo apt-get install vlc
sudo apt-get install openjdk-6-jre-headless
+
</pre>
* recent VLC (careful: Ubuntu maintained software channel is outdated, check: http://www.videolan.org/vlc/download-ubuntu.html for a guide how to get a recent version)
+
Careful: Ubuntu maintained software channel might be outdated (it was the case for some time with 10.04), check: http://www.videolan.org/vlc/download-ubuntu.html for a guide how to get a recent version  
  
Change the permissions of the *.sh file to enable execution.
+
<br>
  
Open a terminal and run
+
You should now go to [http://wiki.elphel.com/index.php?title=Apertus.ElphelVision_User_Guide this User Guide] to continue.
./ElphelVision.sh
 

Latest revision as of 16:23, 19 April 2012

Overview

This guide explains how to install ElphelVision on your Elphel camera and a computer running Ubuntu (32bit) connected to your camera over Ethernet.

This guide assumes that you have successfully downloaded the required files.

Installation

FTP Transfer

Use an FTP client of choice (eg. Filezilla) and connect to your Elphel camera.

Default IP: 192.168.0.9
User: root / PW: pass

Upload the complete "ElphelVision" directory in "elphel/Apertus/camera www/" to the "/mnt/flash/html/" directory of your Elphel camera

You can test if everything worked properly by opening a browser and going to:

http://192.168.0.9/ElphelVision/elphelvision_interface.php?cmd=status  (replace 192.168.0.9 with your Elphel cameras IP). 

If you get lots of xml output installation was successful.


Running ElphelVision

Requirements:

Java JRE (Java Runtime Environment)

Careful, OpenJDK produced some drawing artefacts with Text in Buttons, you will get strange color fringes.

Install the Official Java JRE from Sun/Oracle:

first enable the "Canonical Partners" Software Source (Software Sources -> Other Software: enable "Canonical Partners - Software packaged by Canonical for their partners")

then update the software index and run:

sudo apt-get install sun-java6-jre

You can have both of them installed side-by-side

Just installing new Java flavours does not change the default Java pointed to by /usr/bin/java. You must explicitly set this:

To see the current configuration and possibilities:

sudo update-java-alternatives -l 

To set the XXX java version as default.

sudo update-java-alternatives -s XXXX 

For Sun Java 6 this would be

sudo update-java-alternatives -s java-6-sun

To ensure that the correct version is being called:

java -version

VLC

For ElphelVision you require a VLC version 1.1.4 or higher

sudo apt-get install vlc

Careful: Ubuntu maintained software channel might be outdated (it was the case for some time with 10.04), check: http://www.videolan.org/vlc/download-ubuntu.html for a guide how to get a recent version


You should now go to this User Guide to continue.