Created Guía de Instalación de Friendica en DreamHost (markdown)

mpmonis 2012-03-01 13:33:53 -08:00
parent 1dcc7e8a5f
commit c9bbaff2da

@ -0,0 +1,79 @@
<p style="text-align: justify;">Texto original: https://github.com/friendica/friendica/wiki/DreamHost-Friendica-Install-Guide</p>
Paso a paso... ¡y con imágenes!
<h2>Introducción</h2>
<p style="text-align: justify;">Esta guía está basada en el <a href="https://github.com/friendica/friendica/blob/master/INSTALL.txt" target="_blank">INSTALL.txt</a> oficial de Friendica, comentado especialmente para una instalación sencilla en DreamHost.</p>
<h2>Creando el dominio</h2>
<p style="text-align: justify;">En la barra lateral del panel pulsa sobre Administrar Dominios (Manage Domains).</p>
<img class="alignnone" title="Dominios" src="https://github.com/friendica/friendica/wiki/images/dhguide/001%20-%20Manage%20Domains.png" alt="" width="160" height="203" />
<p style="text-align: justify;">Ahora puedes elegir el nombre de tu dominio (o subdominio). Puede ser uno que ya tuvieras registrado (o un subdominio del mismo) o uno nuevo. Recuerda que para dominios nuevos DreamHost puede que te cobre una cuota mensual. Y, como siempre, recuerda que los nuevos dominios pueden tardar un día o dos en expandirse por internet.</p>
<p style="text-align: justify;">Por favor, cuando vayas a crearlo, recuerda la advertencia de INSTALL.txt:</p>
<p style="text-align: justify;">"Piensa un poco sobre ello, porque el cambio (del nombre de dominio) no está soportado actualmente"</p>
<img class="alignnone" title="dominio2" src="https://github.com/friendica/friendica/wiki/images/dhguide/002%20-%20Domain%20to%20host.png" alt="" width="651" height="213" />
Ahora deberías seleccionar PHP 5.3 porque se requiere para enlazar con los "pods" de Diaspora*.
<img class="alignnone" title="federada" src="https://github.com/friendica/friendica/wiki/images/dhguide/003%20-%20Selecting%20PhP%205.3.png" alt="" width="657" height="274" />
¡Vamos a ello! Pulsa "el botón azul"
<img class="alignnone" title="botonazul" src="https://github.com/friendica/friendica/wiki/images/dhguide/004%20-%20Confirm%20fully%20host.png" alt="" width="194" height="62" />
<p style="text-align: justify;">Si todo salió bien recibirás el siguiente aviso de los chicos de DreamHost (¡felicidades!).</p>
<img class="alignnone" title="cheers" src="https://github.com/friendica/friendica/wiki/images/dhguide/005%20-%20Success%20report.png" alt="" width="865" height="258" />
<h2>Configurando un usuario de terminal</h2>
<p style="text-align: justify;">Necesitas un usuario con permisos de terminal para hacer las cosas mejor. Solo pulsa en "Administrar Usuarios" (Manage Users).</p>
<img class="alignnone" title="usuarios" src="https://github.com/friendica/friendica/wiki/images/dhguide/008%20-%20Manage%20Users.png" alt="" width="168" height="142" />
Añade un usuario nuevo. No te olvides de tu <strong>Nombre de Usuario</strong> y <strong>Contraseña</strong>, porque los vas a necesitar luego.
<img class="alignnone" title="usuarios2" src="https://github.com/friendica/friendica/wiki/images/dhguide/009%20-%20Add%20a%20new%20user.png" alt="" width="597" height="278" />
<p style="text-align: justify;"><em>¿A quién llamo?</em> - Necesitas saber en qué servidor de DreamHost será hospedada tu instalación de Friendica para poder conectarte vía ssh con ella. Para averiguarlo, pulsa en "Estado de la Cuenta" (Account Status) en el menú desplegable de la parte superior derecha.</p>
<img class="alignnone" title="callssh" src="https://github.com/friendica/friendica/wiki/images/dhguide/006%20-%20Account%20Status.png" alt="" width="171" height="40" />
<p style="text-align: justify;">Fíjate en la entrada "Tu Servidor Web" (Your Web Server).Toma nota de esa dirección. Recuerda que la dirección url completa sería yourmachine.dreamhost.com (cambiando "yourmachine" por el nombre que hayas configurado).</p>
<img class="alignnone" title="status" src="https://github.com/friendica/friendica/wiki/images/dhguide/007%20-%20Your%20Web%20Server.png" alt="" width="158" height="48" />
<h2>Configurando la base de datos MySQL</h2>
<p style="text-align: justify;">Friendica usa MySQL como motor de sus bases de datos. Así que necesitas una base de datos configurada y con los permisos apropiados. En el menú "Extras" (Goodies) pulsa en "Bases de Datos MySQL" (MySQL Databases).</p>
<img class="alignnone" title="mysql" src="https://github.com/friendica/friendica/wiki/images/dhguide/010%20-%20MySQL.png" alt="" width="168" height="151" />
Ahora añade un nuevo nombre pulsando en "Add MySQL Hostname".
<img class="alignnone" title="hostname" src="https://github.com/friendica/friendica/wiki/images/dhguide/011%20-%20Add%20MySQL%20Hostname.png" alt="" width="267" height="69" />
<p style="text-align: justify;">Si no quieres complicarte mucho, tan solo llámala mysql y se antepondrá así al nombre de tu dominio. Es más fácil recordar un nombre como mysql.yourdomain.com. Deberás tomar nota del nombre que elijas porque lo vas a necesitar luego.</p>
<img class="alignnone" title="nombresql" src="https://github.com/friendica/friendica/wiki/images/dhguide/012%20-%20MySQl%20-%20Hostname.png" alt="" width="575" height="235" />
<p style="text-align: justify;">Ahora que sabes dónde está instalada tu base de datos MySQL debes crear una base de datos que contendrá todas las tablas de Friendica. También es una buena idea elegir un nombre fácil de recordar para esta base de datos. Puede ser algo como el nombre de tu dominio sin puntos, tal vez "your_domain_com". En "Use Hostname:" selecciona el nombre que creaste en el paso anterior para "MySQL Hostname". Además, en "First User:" debes indicar el nombre de usuario e introducir la contraseña que creaste en el segundo paso.</p>
<img class="alignnone" title="database" src="https://github.com/friendica/friendica/wiki/images/dhguide/013%20-%20Create%20MySQL%20Database.png" alt="" width="602" height="494" />
<p style="text-align: justify;">Si todo salió bien, DreamHost volverá a mostrarte un aviso parecido al anterior. Fíjate en la línea donde te aconsejan cómo conectar con la base de datos, apúntala si ni estás muy versado en el tema de MSQL.</p>
<img class="alignnone" title="ole" src="https://github.com/friendica/friendica/wiki/images/dhguide/014%20-%20MySQL%20Success.png" alt="" width="592" height="180" />
<h2>Instalación de Friendica</h2>
Ahoraentraremos mediante un tunel ssh a la máquina donde está hospedado tu dominio.
$ ssh yourdomain -l username
<p style="text-align: justify;">Debes navegar hasta el directorio donde estén alojados los archivos. En DreamHost este directorio tiene el mismo nombre que el dominio, normalmente. Algo parecido a /home/yourusername/yourdomain.com, así que:</p>
$ cd yourdomain
Ahora debes usar git para clonar el repositorio de Friendica dentro del directorio. Tan sencillo como escribir:
$ git clone git://github.com/friendica/friendica.git .
(No te olvides el punto al final de la línea del comando).
<p style="text-align: justify;">Ya casi estamos. Visita la página web y sigue las instrucciones. Al principio Friendica realizará algunas comprobaciones y te mostrará los resultados. Todos los puntos deben aparecer en verde para indicarte que has pasado la prueba. ¡Suerte!</p>
<img class="alignnone" title="tests" src="https://github.com/friendica/friendica/wiki/images/dhguide/015%20-%20Friendica%20Setup.png" alt="" width="446" height="311" />
<p style="text-align: justify;">A continuación Friendica te pedirá los datos para acceder a la información de tu base de datos. MySQL hostname, usuario, contraseña y nombre de la base de datos (4 datos que ya tendrás apuntados de antemano, si me has hecho caso).</p>
<img class="alignnone" title="datas" src="https://github.com/friendica/friendica/wiki/images/dhguide/016%20-%20Database%20connection.png" alt="" width="685" height="383" />
¡Felicidades! Ya está hecho. (Solo un pequeño apunte sobre configurar cron más adelante).
<img class="alignnone" title="Felicidades" src="https://github.com/friendica/friendica/wiki/images/dhguide/017%20-%20MySQL%20ok.png" alt="" width="591" height="209" />
<p style="text-align: justify;">Al terminar debes asegurarte de que $a-&gt;config['php_path'] está configurado correctamente en tu archivo .htconfig.php. Probablemente apuntará a /usr/local/bin/php En Dreamhost (hoy: 11 de Febrero de 2012) apunta a PHP 5.2.17 (cli) (built: Jun 28 2011 17:39:50).</p>
Pero... queremos PHP 5.3, ¿recuerdas? Y en este momento php 5.3 está en /usr/local/php53/bin/php, así que...
Abre el archivo .htconfig.php con tu editor de textos preferido y verifica la siguiente línea:
$a-&gt;config['php_path'] = '/usr/local/php53/bin/php';
<h2>Configurando las tareas en Cron</h2>
<p style="text-align: justify;">Friendica necesita enlazar frecuentemente con el servidor donde están tus contactos para actualizar "las novedades". Esta tarea se lleva a cabo mediante un script en include/poller.php. (también llamado encuestador, del inglés "poll"). Para que tu sistema sepa que tiene que ejecutar dicho script cada cierto tiempo tienes que programar dicha tarea en Cron. Afortunadamente existe una sencilla interfaz en los extras (Goodies) de DreamHost. Solo tienes que rellenar un formulario. El comando a ejecutar tiene el siguiente formato: cd your_domain_directory; php_absolute_path poller_relative_path. Será algo parecido a, por ejemplo:</p>
cd /home/john/johnfriendica.com; /usr/local/php53/bin/php include/poller.php
<p style="text-align: justify;">Fíjate que, en DreamHost (actualmente), el directorio de PHP 5.3 es /usr/local/php53/bin/php. Configura correctamente tu correo electrónico y recibirás un correo si algo funciona mal con el encuestador.</p>
<img class="alignnone" title="encuestador" src="https://github.com/friendica/friendica/wiki/images/dhguide/018%20-%20Cron%20Jobs.png" alt="" width="599" height="725" />
Buena suerte. ;-)