Difference between revisions of "Apertus.ElphelVision Install Guide"

From ElphelWiki
Jump to: navigation, search
(Running ElphelVision)
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 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.
  
==Running ElphelVision==
+
<br>
  
Requirements:
+
== Running ElphelVision ==
  
===Java JRE (Java Runtime Environment)===
+
Requirements:
Careful, OpenJDK produced some drawing artefacts with Text in Buttons, you will get strange color fringes.
 
  
Install the Official Java JRE from Sun/Oracle:
+
=== 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")
  
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:
+
 
 +
To ensure that the correct version is being called:  
 +
 
 
  java -version
 
  java -version
  
===VLC===  
+
=== 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
+
 
 +
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  
 +
 
 +
<br>
 +
 
 +
=== Setting Permissions and Running ===
  
 +
Change the permissions of the ElphelVision.sh to enable execution.
  
===Permission and & Run===
+
Open a terminal and run
Change the permissions of the ElphelVision.sh to enable execution.
 
  
Open a terminal and run
 
 
  ./ElphelVision.sh
 
  ./ElphelVision.sh

Revision as of 02:47, 30 December 2010

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.

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")

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


Setting Permissions and Running

Change the permissions of the ElphelVision.sh to enable execution.

Open a terminal and run

./ElphelVision.sh