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.)
 
(6 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.
  
==Running ElphelVision==
+
Install the Official Java JRE from Sun/Oracle:
  
Requirements:
+
first enable the "Canonical Partners" Software Source (Software Sources -&gt; Other Software: enable "Canonical Partners - Software packaged by Canonical for their partners")  
* recent Java JRE (Java Runtime Environment)
+
 
either OpenJDK:
+
then update the software index and run:
sudo apt-get install openjdk-6-jre-headless
 
or the Official Java JRE from Sun/Oracle:
 
  
first enable the "Canonical Partners" Software Source
 
 
  sudo apt-get install sun-java6-jre
 
  sudo apt-get install sun-java6-jre
  
You can have both of them installed side-by-side
+
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:
+
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:  
  
To see the current configuration and possibilities:
 
 
  sudo update-java-alternatives -l  
 
  sudo update-java-alternatives -l  
 +
 
To set the XXX java version as default.  
 
To set the XXX java version as default.  
 +
 
  sudo update-java-alternatives -s XXXX  
 
  sudo update-java-alternatives -s XXXX  
 +
 
For Sun Java 6 this would be  
 
For Sun Java 6 this would be  
 +
 
  sudo update-java-alternatives -s java-6-sun
 
  sudo update-java-alternatives -s java-6-sun
To ensure that the correct version is being called:
 
java -version
 
  
* recent VLC (careful: Ubuntu maintained software channel might be outdated, check: http://www.videolan.org/vlc/download-ubuntu.html for a guide how to get a recent version)
+
To ensure that the correct version is being called:
 +
 
 +
java -version
 +
 
 +
=== VLC ===
 +
 
 +
For ElphelVision you require a VLC version 1.1.4 or higher
 +
<pre>sudo apt-get install vlc
 +
</pre>
 +
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.