|
Table of Contents
|
NOTE: OpenProximity is not compatible with Ubuntu 11.04 yet, please stick to 10.04LTS while we fix the problem
Install in Ubuntu 11.04 (natty)
Installing in Ubuntu 11.04 is possible now, but not yet through our PPA, you may still need to add our PPA to provide some dependencies.
You will get it installed by running this commands in the terminal
wget http://proximitymarketing.googlecode.com/files/openproximity2_1rc1-aircable2_all.deb
sudo dpkg -i openproximity2_1rc1-aircable2_all.deb
If it fails then try with adding our PPA. Then run "apt-get install -f" to force installation. That usually works.
Note that after adding the PPA you will get notifications telling you there's an upgrade for OpenProximity, by now that's fake.
Install in Ubuntu 10.04LST
Ubuntu 10.04LST is the latest Ubuntu we support by now. Ubuntu 10.10 works as well.
Installing in Ubuntu is quite easy because we provide ready to use Ubuntu Packages, the way to do it is:
- Add our PPA to your sources.list
- Optional add our devel PPA (with testing packages)
- Install our PPA key
- apt-get update
- apt-get upgrade
- apt-get install
What you have to do is summarized as:
echo "deb http://ppa.launchpad.net/manuel-aircable/ppa/ubuntu jaunty main " | sudo tee -a /etc/apt/sources.list
# optional if you want to get devel version uncomment the next line.
# echo "deb http://ppa.launchpad.net/manuel-aircable/openproximity-devel/ubuntu jaunty main " | sudo tee -a /etc/apt/sources.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys B85B0133
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install python-gobject python-dbus libglib2.0-data openproximity2
After this steps you should reboot, and that will get you OpenProximity2 up and running.
Install in Ubuntu 9.10 (karmic)
OpenProximity PPA packages can be used in karmic you only need to run an extra command before rebooting:
sudo chmod 755 /etc/init.d/openproximity2
sudo update-rc.d openpriximity2 defaults
MobileServerXR from AIRcable.net
If you already have an installed Unbuntu system with an older version of OpenProximity2 installed, you can use the Synaptic package manager.
Make sure you click on "RELOAD" first, then the package OpenProximity2 can be marked as update. Clock "APPLY" and you have the new version.
Installing on Ubuntu Netbook Remix 9.10
Add PPA to sources.list
- Modify sources.list with Software sources
- Go to System | Administration menu, run Software sources
- Select Other softwares tab
- Click Add…
- Type the first source : deb http://ppa.launchpad.net/manuel-aircable/ppa/ubuntu jaunty main and Add Source
- Once more with Devel source : deb http://ppa.launchpad.net/manuel-aircable/openproximity-devel/ubuntu jaunty main
- Close after having reloaded packages
Note that even if source is defined for Jaunty (9.04), it works with Karmic (9.10)
Install packages from key and sources
- Open a command line console
- Switch to Super-User mode :sudo bash
- Execute commands above :
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys B85B0133
apt-get update
apt-get upgrade
sudo apt-get install python-gobject python-dbus libglib2.0-data openproximity2
Start OpenProximity2
- Now you can restart
- Go to menu Other | OpenProximity .
- It runs Mozilla Firefox with local Web server : http://localhost/
It's not working fine : Error message : (111, 'Connection refused')
Some servers are not running.
Starting servers manually and debugging
If you want to make it working, you have to start several servers (from console, on several consoles) :
cd /opt/openproximity2/
sudo DEBUG=yes bash server.sh // if web server is not running
sudo DEBUG=yes bash rpc.sh // if RPC Server is running = false
sudo DEBUG=yes bash pairing.sh // to get pairing support
sudo DEBUG=yes bash run_rpc.sh scanner // if Scanners Connected = 0
sudo DEBUG=yes bash run_rpc.sh uploader // if Uploaders Connected = 0
To keep all messages when a server is launched, open a new tab in console with right-click | New Tab.
In the "Known Dongles" table, a dongle can be seen as "Scanner enabled", as "Is uploader", but not "Uploader Enabled". To make it uploader Enabled, access to Configure and validate Upload checkbox.
Starting servers automatically
One script can start all needed servers : /etc/init.d/openproximity2
This script has to be run at each Ubuntu start. This can be configured by :
sudo chmod 755 /etc/init.d/openproximity2 // if not correct
sudo update-rc.d openpriximity2 defaults
Configuring campaigns
- Screencastings :
- New campaign : New campaign on OpenProximity2
Debugging
Basic Linux commands
# Managing tasks
ps aux|grep Open // List all tasks and find rpc server task-id
kill <task-id> // Kill task
# Managing servers
netstat -anpe
netstat -anpe | grep 80 // to find web server listening port 80
OpenProximity commands
cd /opt/openproximity2/
openproximity2 start
openproximity2 restart
openproximity2 stop
