====== Install Ortro ======


===== Requirements =====
  * Apache 2.x or a web server that supports php 5
  * Php 5.1.x
  * Mysql 5.0.x or Sqlite
  * Ssh
  * Subversion client ((Required only for devel version))



===== Install Ortro =====

Download the stable version of Ortro: [[download | Download]]

Extract and  move the Ortro web application where you want (i.e. /opt/):

  # tar zxvf /path/of/the/file/ortro-x.x.x.tar.gz
  # mv ortro-x.x.x <YOUR_FOLDER>/ortro

Add the alias directive reported below in apache conf file:

  Alias /ortro/ "<YOUR_FOLDER>/ortro/www/"

Check for the correct ownership of the ortro folder in according with the dedicated user for running httpd (i.e. www-data).\\

To change the ownership of the folder:

  # chown -R www-data <YOUR_FOLDER>/ortro

Restart the webserver and connect to:

[[http://<your_server_ip>/ortro|http://<your_server_ip>/ortro]]

if everything was ok you should see the install wizard.

Configure in according with your environment and... enjoy!!

===== Configure the remote hosts =====

Copy the public key ortro_rsa.pub on the remote host:
  $ scp ortro_rsa.pub remote_user@remote_host:~

Connect to the host

  $ ssh remote_user@remote_host
  $ cat ortro_rsa.pub >> .ssh/authorized_keys

When you connect to a ssh server the first time you will see the message:

  The authenticity of host ... (//remote_host//)' can't be established.
  RSA key fingerprint is 68:85:7d:7a:5a:7f:96:3c:3a:b6:9b:8c:4f:d7:a3:c0.
  Are you sure you want to continue connecting (yes/no)?

To avoid this you can add the following option at your ssh command:
<code>
-o StrictHostKeyChecking=no
</code>

<note warning>
To avoid authentication error, please check the permissions and ownership of the .ssh folder and authorized_keys files.\\
Eventually you may fix permissions and ownership using the commands reported belows on the remote host: 

<code>
$ cd ~
$ chown remote_user .ssh
$ chown remote_user .ssh/authorized_keys
$ chmod 700 .ssh
$ chmod 644 .ssh/authorized_keys
</code>

</note>