by Mat - CMI Buenos Aires ((i)) Argentina Friday, Nov. 05, 2004 at 10:16 AM
mat(a)riseup.net

Utilizando Debian GNU/Linux.
Instalaci\xF3n de paquetes necesarios y sf-active desde cero.
Manual y tutorial de instalaci\xF3n paso a paso.

Tutorial de instalaci\xF3n de SF-Active 0.9.4

Utilizando Debian GNU/Linux
Instalaci\xF3n de paquetes necesarios y sf-active 0.9.4 desde cero.

• El sistema operativo Debian GNU/Linux (requerimientos)
• Instalaci\xF3n y configuraci\xF3n de SF-Active
• Configuraci\xF3n del servidor de web Apache
• Configuraci\xF3n de PHP
• Configuraci\xF3n de SF-Active
• Configuraci\xF3n de base de datos mysql
• Personalizando el sitio
• Comentarios
• Cr\xE9ditos

El sistema operativo Debian GNU/Linux (requerimientos)

Comenzamos con la instalaci\xF3n base de Debian.
Eso no lo voy a explicar aca.

Luego instalamos uno a uno, los siguientes paquetes.

apache
mysql-server
php4
php4-mysql
php4-gd2
php4-cgi

Usamos la utilidad de instalaci\xF3n apt-get

# apt-get install apache
# apt-get install mysql-server
# apt-get install php4
# apt-get install php4-mysql
# apt-get install php4-gd2
# apt-get install php4-cgi

Cada uno de estos paquetes nos pedir\xE1 la instalaci\xF3n de “otros” paquetes, que se necesitan para que estos programas funcionen correctamente. Ante la pregunta, responderemos afirmativamente.

Instalaci\xF3n y configuraci\xF3n de SF-Active

Luego, descargar del sitio de sf-active [ http://sfactive.indymedia.org ] la ultima versi\xF3n del programa.

Al momento de realizar este tutorial de instalaci\xF3n (15 Octubre 2004 ), la ultima versi\xF3n es la 0.9.4 (sf-active_v0_9_4.tar.gz)

Descomprimir el tar.gz
# tar –xzvf sf-active_v0_9_4.tar.gz

Eso nos creara un directorio en la misma carpeta donde estaba el archivo tar.gz

/sf-active_v0_9_4

Dentro de ese directorio encontraran los siguientes directorios:
“doc”
“sf-active”

El directorio “doc” contiene la ultima documentaci\xF3n del programa.
El directorio “sf-active” contiene todo lo necesario para instalar el programa.

Dentro del directorio “sf-active” encontraras los siguientes directorios:
“install”
“shared”
“sitename”

El directorio “install” contiene archivos que solo se utilizan para la instalacion del sistema.
El directorio “shared” contiene los archivos que se “comparten” del sistema, en el caso que tengas m\xE1s de un sitio instalado en el servidor.
El directorio “sitename” contiene los archivos para cada uno de los sitios en particular.

Procederemos a copiar o mover estos directorios.

En esta instalaci\xF3n de ejemplo utilizaremos el directorio /home para instalar el directorio compartido (shared) y tambi\xE9n los directorios de cada sitio en particular (sitename).

Tambi\xE9n crearemos los usuarios individuales en el servidor, para utilizar sus directorios personales creados en /home como los directorios de instalaci\xF3n de cada sitio.
El sitio creado en este tutorial ser\xE1 el del usuario “argentina”

Creamos el usuario “argentina” ejecutando:
# adduser argentina
En ese momento se creara el directorio /home/argentina que luego utilizaremos para la instalaci\xF3n.

Creamos el directorio /home/sfa94 para alojar el directorio “shared”
# mkdir /home/sfa94

Luego copiamos el contenido completo del directorio “sitename” dentro del directorio “argentina”
# cp -r sitename/* /home/argentina/

Copiamos el contenido completo del directorio “shared” dentro del directorio “sfa94”
# cp -r shared /home/sfa94/

Permisos de directorios.
Para que el sitio funcione, debemos modificar los permisos de archivos y directorios, para que puedan ser le\xEDdos y modificados por el servidor apache. (usuario www-data)

Luego hay que copiar y ejecutar el script que modificar\xE1 los permisos del directorio “argentina” para el correcto funcionamiento del sitio.
# cp /sf-active_v0_9_4/sf-active/install/sfa-perm.sh /home/argentina
Le damos persmiso de ejecucion a este archivo
# chmod 770 sfa-perm.sh
Estando dentro del directorio /home/argentina
Ejecutamos el script
# ./sfa-perm.sh argentina www-data
Con las opciones “argentina www-data” le decimos al script que el due\xF1o es el usuario argentina y que el grupo es el usuario www-data (el servidor de web apache)

Todas las l\xEDneas que siguen son para ejecutar, l\xEDnea por l\xEDnea, y en el orden en el que est\xE1n aqu\xED.

# chown -R www-data /home/sfa94
# find /home/sfa94/ -type f -exec chmod 644 {} \;
# find /home/sfa94/ -type d -exec chmod 755 {} \;

# chown -R www-data /home/argentina
# find /home/argentina/ -type f -exec chmod 644 {} \;
# find /home/argentina/ -type d -exec chmod 755 {} \;

# chown -R www-data /home/sfa94/shared/session
# find /home/sfa94/shared/session -type f -exec chmod 644 {} \;
# find /home/sfa94/shared/session -type d -exec chmod 755 {} \;

# chmod 660 /home/argentina/website/newswire.rss
# chmod 660 /home/argentina/website/newswire.xml

Configuraci\xF3n del servidor de web Apache

Ahora vamos a configurar el servidor apache.
El nombre de servidor que utilizaremos es sfa94.argentina.indymedia.org

Comentario: (1)

Editamos el archivo de configuraci\xF3n de apache [ /etc/apache/httpd.conf ] y le agregamos debajo de todo la siguiente configuraci\xF3n para el virtualhost.

<VirtualHost AQUI_VA_LA_DIRECCION_IP_DEL_SERVIDOR>
ServerName sfa94.argentina.indymedia.org
DocumentRoot /home/argentina/website
SetEnv SITE_NAME argentina
ServerAdmin root@sfa94.argentina.indymedia.org
CustomLog /var/log/apache/sfa94.argentina.indymedia.org.log indy
ErrorLog /var/log/apache/sfa94.argentina.indymedia.org-error.log
</VirtualHost>

En la linea CustomLog se esta utilizando un tipo de logueos de apache. Estas dos lineas deben ser agregadas al httpd.conf para que funcione correctamente.

#Logs que NO guardan la IP de los visitantes
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" indy

Buscar las siguientes l\xEDneas en el mismo archivo de configuraci\xF3n de apache.

LoadModule env_module /usr/lib/apache/1.3/mod_env.so
LoadModule setenvif_module /usr/lib/apache/1.3/mod_setenvif.so
LoadModule php4_module /usr/lib/apache/1.3/libphp4.so

Descomentarlas (eliminar #) en el caso que est\xE9n comentadas o agregarlas para que apache utilice estas extensiones.
Otra posibilidad de configuracion es que estos modulos esten en el archivo [ /etc/apache/modules.conf ]


La secci\xF3n “Directory Index” se debe agregar “index.php” y quedar\xEDa as\xED:

<IfModule mod_dir.c>
DirectoryIndex index.php index.html index.htm index.shtml index.cgi
</IfModule>

Es importante que index.php este primero que index.html para evitar cambios en el sitio.
Finalizada la modificaci\xF3n del httpd.conf
Probar que todo esta bien, luego de los cambios en httpd.conf ejecutando
# apachectl configtest
Esto prueba la configuracion y avisa si algo no esta bien.

Configuraci\xF3n de PHP

Modificamos el archivo php.ini
/etc/php4/apache/php.ini

Buscamos y modificamos la secci\xF3n:

;;;;;;;;;;;;;;;;;;;;;;;;;
; Paths and Directories ;
;;;;;;;;;;;;;;;;;;;;;;;;;

; UNIX: "/path1:/path2"
include_path = ".:/php/includes/:/home/sfa94/"

Incluimos el directorio donde esta la instalaci\xF3n base compartida de sfactive.

Luego de estos cambios, reiniciar el servidor apache, para que cargue todos los cambios.
# /etc/init.d/apache restart

Configuraci\xF3n de SF-Active

Ahora modificaremos el archivo compartido principal de configuraci\xF3n de sfactive, ubicado en /home/sfa94/shared/global.cfg

Primero modificamos la l\xEDnea

$server_root = "";
Y le agregamos la ruta al directorio principal de sfactive, dej\xE1ndola as\xED:
$server_root = "/home/sfa94";

Luego buscamos la siguientes l\xEDneas en global.cfg

if ($site_name)
{
switch ($site_name)
{
case "argentina":
$config_dir = "/home/argentina/local/config";
$time_diff = 0;
break;
}
} else

En esas l\xEDneas, se modifico:
case "argentina":
$config_dir = "/home/argentina/local/config";

Configuraci\xF3n de base de datos MySQL

Ingresar un password para el usuario “root” del nuevo servidor mysql, ya que el mismo despu\xE9s de instalarse no tiene contrase\xF1a.
# mysqladmin -u root password 'PASSWORD'

Crear la base de datos de “argentina”
# mysqladmin -u root -p create argentina

Ingreso al mysql y le doy permisos sobre la base de datos argentina al usuario argentina.
# mysql -u root -p
Si el usuario y password son correctos, ingresamos al administrador del mysql, que nos muestra este prompt.
mysql>

Ahi dentro ejecutar

grant all on argentina.* to argentina@localhost identified by "PASSWORD_BD";

Donde "PASSWORD_BD" es el password que el usuario “argentina” va a utilizar en mysql.

mysql> exit
y eso nos sacar\xE1 del administrador de mysql.

Ahora ingresaremos la estructura de la base de datos e informaci\xF3n de ejemplo.
Acceder al directorio de instalaci\xF3n del sfactive
cd sf-active_v0_9_4/sf-active/install
Y ejecutar:
# mysql -u argentina -p argentina < mysql_db.sql
# mysql -u argentina -p argentina < mysql_db_sample_data.sql

En esas dos l\xEDneas usamos el usuario “argentina” y nos pedir\xE1 el password de la base de datos “argentina” e ingresamos la informaci\xF3n del archivo “mysql_db.sql” y “mysql_db_sample_data.sql” respectivamente.

Personalizando el sitio:

El siguiente paso es configurar el sitio editando el archivo sfactive.cfg

/home/argentina/local/config/sfactive.cfg

Dentro de este debemos ingresar la informaci\xF3n de la base de datos y otros datos del sitio que estamos creando.

// Database
define('DB_HOSTNAME', 'localhost');
define('DB_USERNAME', 'argentina');
define('DB_PASSWORD', 'PASSWORD_BD');
define('DB_DATABASE', 'argentina');
define('DB_VENDOR', 'mysql');

// Main Path
define('SF_BASE_PATH', '/home/sfa94');
define('SF_INSTALL_PATH', '/home/argentina');

// Urls
define('SF_ROOT_URL', 'http://sfa94.argentina.indymedia.org');

// Lang Config
$GLOBALS['dict'] = array();
$GLOBALS['lang'] = "es";

Cambiar a "es" para que el sitio este en castellano. Otras opciones son "en" ingles, "es" castellano, "nl" holandes, "it" italiano, "fr" franc\xE9s.

Con esta informaci\xF3n ya tendremos un sitio de prueba funcionando.

Seguir leyendo todas las l\xEDneas del archivo sfactive.cfg para personalizar el sitio a gusto.
Todas las l\xEDneas est\xE1n explicadas ah\xED mismo.

Luego ingresar al admin del sitio, para realizar todas las modificaciones que sean necesarias.
http://sfa94.argentina.indymedia.org/admin

Otras personalizaciones deben ser realizadas para que el sitio quede funcional.

Comentarios:
Realice este tutorial de la forma mas completa y detallada posible, porque cuando yo mismo quise instalar el sf-active por primera vez para comenzar a probarlo y conocerlo, tan solo exist\xEDan otros tutoriales de instalaci\xF3n muy poco detallados.
Siguiendo esas gu\xEDas, solo pude completar mi primer instalaci\xF3n exitosa reci\xE9n al tercer intento.
Es por eso que espero que les sirva este tutorial a todos aquellos que deseen instalar sf-active y no morir en el intento. :-)
Gracias a pseudopunk, guido, gek, libertinus y mtoups por la ayuda y por aprender juntos.
Copyleft: Se puede modificar, copiar y difundir este tutorial por todos los medios posibles, siempre y cuando no se utilice para fines comerciales.
Traducciones: si queres traducir el documento a otros idiomas, hac\xE9lo y env\xEDalo por e-mail.

Creditos:

Octubre 2004
Mat (( i ))
CMI Buenos Aires
Argentina
http://argentina.indymedia.org
Comentarios, preguntas, correciones y dudas a:
mat (a) riseup.net

O en el chat de indymedia irc.indymedia.org
Canal #sf-active

Acceso al canal de soporte de sf-active por web.
http://chat.indymedia.org/?lang=es&chans=sf-active

Sitio de sf-active
http://sfactive.indymedia.org

Sitio de Debian GNU/Linux
http://www.debian.org

(1) Aclaraci\xF3n: Para que la misma maquina reconozca el nombre sfa94.argentina.indymedia.org como propio, es necesario agregar esta informaci\xF3n al archivo /etc/hosts
127.0.0.1 localhost sfa94.argentina.indymedia.org

En el caso que se quiera acceder al servidor desde una maquina windows conectada en la misma red local, agregar esta informaci\xF3n al archivo “hosts” del windows.

127.0.0.1 localhost
192.168.0.10 sfa94.argentina.indymedia.org

Donde 192.168.0.10 es la direcci\xF3n ip del servidor donde se instala sf-active.

Octubre 2004
Mat (( i ))
CMI Buenos Aires
Argentina
http://argentina.indymedia.org
Comentarios, preguntas y dudas a:
mat (a) riseup.net

Libertad es decirle a la gente lo que NO quiere o\xEDr.

-- MatRiseup - 14 Jan 2013