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

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)Executea2enmod rewrite

2)Editnano /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

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

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 version2- 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 contrib2- Run the following command apt-get update3- 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:

• 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

1- Download this file: http://kaazingcorp.cachefly.net/org/download/kaazing-gateway-demos-8.12_2-bin.tar.gz2- Extract it with tar -xzf kaazing-gateway-demos-8.12_2-bin.tar.gz3- 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 &