1. eyeOS 2.x Installation Manual
Requirements
▪ Apache
Apache HTTP Server 2.x
▪ MySQL
MySQL-server and MySQL-client 5.x
▪ PHP
php 5.2, or higher
Installation
1. Download eyeOS
If you have not got a copy of eyeOS you can dowload it just clicking this link eyeOS it will show
what file best fits your needs.
2. Unpack & Placement
2.1. Uncompress the downloaded package to your web directory you should see a folder named
eyeOS with 4 to 6 files and folders (depending on eyeOS version).
2.2. After we do that If we are On a Unix meshen we need to chmod 777 our eyeOS folder
2.3. Open a command prompt(terminal) Do as super user most do "sudo" or "su root"
EX. #sudo chown -R www-data.www-data /var/www/eyeOS (change www-data to your
apache user.)
EX. #sudo chmod 750 -R /var/www/eyeOS
replace /var/www/eyeOS as needed
3. Installation
3.1. Open your browser and navigate to
• On local Computer from home setup or Portable media
http://localhost/eyeOS/install
• On a Hoster
2. http://xxx.yoururl.xxx/eyeOS/install
You should see a screen like this
3.2. Follow the instructions. If you have some System requirements not installed on your server,
please, take a look at Installation FAQ to know how install and configure them.
3.3. Fill the required information to finish the installation!
3.4. Configure the mod-rewrite on Apache
1)Execute
a2enmod rewrite
2)Edit
nano /etc/apache2/sites-available/default
Change, at <Directory /var/www/> the variable AllowOverride to All
3)Restart Apache
/etc/init.d/apache2 restart
3.5. Install exiftool in order to be able to extract mp3 infos
apt-get install libimage-exiftool-perl
3.6. Please remember to remove the install directory after a succesfull instalation.
But... I still have problems...
Please, visit the eyeOS Forums. There you will meet other eyeOS users and developers which will
help you!
Installation FAQ
I need the Curl extension but I have not it. What have I to do?
You have to run the following command
apt-get install php5-curl
3. I need the GD extension but I have not it. What have I to do?
You have to run the following command
apt-get install php5-gd
I need the Mbstring extension but I have not it. What have I to do?
Nothing. It comes with PHP5
I need the mcrypt extension but I have not it. What have I to do?
You have to run the following command
apt-get install php5-mcrypt
I need the Mysql extension but I have not it. What have I to do?
You have to run the following command
apt-get install php5-mysql
I need the Mysqli extension but I have not it. What have I to do?
You have to run the following command
apt-get install php5-mysql
I need the SQLite extension but I have not it. What have I to do?
You have to run the following command
apt-get install php5-sqlite
I need the PDO extension but I have not it. What have I to do?
You have to run the following command
apt-get install php-db
I need the PDO Mysql Driver but I have not it. What have I to do?
You have to run the following command
apt-get install pdo-mysql
I need the PDO Sqlite Driver but I have not it. What have I to do?
You have to run the following command
4. apt-get install pdo-sqlite
I need the Json Support but I have not it. What have I to do?
You have to run the following command
php5 (this is included in the PHP5 packet by default)
I need the Python but I have not it. What have I to do?
You have to run the following command
apt-get install python-support
I need the Python SimpleJson but I have not it. What have I to do?
You have to run the following command
apt-get install python-simplejson
I need the Python Uno but I have not it. What have I to do?
You have to run the following command
apt-get install python-uno
I need Stomp.py but I have not it. What have I to do?
You have to go to http://code.google.com/p/stomppy/ and follow this steps:
1- Download the last version
2- run the following command
dpkg -i stomp.py_3.0.2_all.deb (or the version downloaded)
If you get no errors is done.
In case of error:
1- Add the testing repository: deb http://ftp.debian.org/debian/ experimental main non-free contrib
2- Run the following command
apt-get update
3- Run the following command
apt-get install python-support (important! only this package)
5- Remove or comment the testing repo.
6- Run the following command
dpkg -i stomp.py_3.0.2_all.deb
I have problems with the PHP.ini. What have I to do?
Configure the PHP.ini:
5. • error_reporting = E_ALL & ~E_NOTICE
• display_errors = Off
• max_execution_time = 30
• max_input_time = 60
• memory_limit = 128M
• post_max_size = 200M
• upload_max_filesize = 100M
• allow_url_fopen = On
• disable_functions =
• safe_mode = Off
• short_open_tag = On
• magic_quotes_runtime = Off
• file_uploads = On
I need the Recoll but I have not it. What have I to do?
You have to run the following command
apt-get install recoll
I need the Open Office Deamon but I have not it. What have I to do?
You have to run the following command
apt-get install openoffice.org
• Be sure www-data is able to write his own home (take a look at /etc/passwd to find out
www-data's home, and set the right permissions if needed)
• OpenOffice daemon must be launched by www-data user, by doing:
'su www-data'
'soffice "-accept=socket,host=localhost,port=2002;urp;" -headless'
• If it does not work, then we need the X server; in a debian based system, we can fix this
problem by doing:
'apt-get install xvfb'
'soffice "-accept=socket,host=localhost,port=2002;urp;" -headless -display :1.0'
I need Java but I have not it. What have I to do?
You have to run the following command
apt-get install sun-java6-jre for this you need the non free repos: deb
http://ftp.us.debian.org/debian/ lenny main contrib non-free
I need the Kaazing Gateway and the ActiveMQ Deamon but I have not it. What have I to do?
You have to
6. 1- Download this file: http://kaazingcorp.cachefly.net/org/download/kaazing-gateway-demos-
8.12_2-bin.tar.gz
2- Extract it with tar -xzf kaazing-gateway-demos-8.12_2-bin.tar.gz
3- Configure it:
• Copy /your/path/to/eyeos/extras/netSyncCONF/apache- activemq/conf/activemq.xml into
/path/to/downloaded_kazing/apache-activemq-5.1.0/conf/
• Copy /your/path/to/eyeos/extras/netSyncCONF/kazing- gateway/conf/gateway-config.xml
into /path/to/downloaded_kazing/kazing/conf/
• Edit /path/to/downloaded_kazing/conf/gateway-config.xml and change <service_domain> to
*.*.*.*
• Edit /path/to/downloaded_kazing/conf/gateway-config.xml, find all the entries with the ip
address 192.168.1.62, and change this entry to your server ip address.
Once Kaazing is installed, open /your/path/to/eyeos/settings.php, in the
“//ACTIVEMQ URL” section, and edit the following entries:
the 'ACTIVEMQ_DESTINATION_URL' must be setted to
'ws://your_server_ip/activemq'
(the ports 80 and 8000, 8001 must be open from outside)
4- Execute the 2 services with:
first command: nohup ./apache-activemq-5.1.0/bin/activemq &
second command: nohup ./kaazing-gateway-8.12_2/bin/gateway.start &