printable version
- email this article
View article without comments
Tutorial de instalación de SF-Active 0.9.4
by Mat - CMI Buenos Aires ((i)) Argentina
Friday, Nov. 05, 2004 at 10:16 AM
mat(a)riseup.net
Utilizando Debian GNU/Linux.
Instalación de paquetes necesarios y sf-active desde cero.
Manual y tutorial de instalación paso a paso.
Tutorial
de instalación de SF-Active 0.9.4
Utilizando Debian GNU/Linux
Instalación de paquetes necesarios y sf-active 0.9.4 desde cero.
El sistema operativo Debian GNU/Linux (requerimientos)
Comenzamos con
la instalación 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ón 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á la instalación de “otros” paquetes,
que se necesitan para que estos programas funcionen correctamente. Ante la pregunta,
responderemos afirmativamente.
Instalación y configuración de SF-Active
Luego, descargar
del sitio de sf-active [ http://sfactive.indymedia.org ] la ultima versión
del programa.
Al momento de realizar
este tutorial de instalación (15 Octubre 2004 ), la ultima versión
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ón 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ás 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ón
de ejemplo utilizaremos el directorio /home para instalar el directorio compartido
(shared) y también los directorios de cada sitio en particular (sitename).
También
crearemos los usuarios individuales en el servidor, para utilizar sus directorios
personales creados en /home como los directorios de instalación de cada
sitio.
El sitio creado en este tutorial será 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ón.
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ídos y modificados por el servidor apache. (usuario
www-data)
Luego hay que copiar
y ejecutar el script que modificará 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ño es el usuario argentina y que el grupo es el usuario www-data (el
servidor de web apache)
Todas las líneas que siguen son para ejecutar, línea por línea,
y en el orden en el que están aquí.
# 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ón
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ón de apache [ /etc/apache/httpd.conf ] y le agregamos
debajo de todo la siguiente configuración 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íneas en el mismo archivo de configuración 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én 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ón “Directory Index” se debe agregar “index.php”
y quedaría así:
<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ón 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ón de PHP
Modificamos el
archivo php.ini
/etc/php4/apache/php.ini
Buscamos y modificamos
la sección:
;;;;;;;;;;;;;;;;;;;;;;;;;
; Paths and Directories ;
;;;;;;;;;;;;;;;;;;;;;;;;;
; UNIX: "/path1:/path2"
include_path = ".:/php/includes/:/home/sfa94/"
Incluimos el directorio
donde esta la instalación base compartida de sfactive.
Luego de estos
cambios, reiniciar el servidor apache, para que cargue todos los cambios.
# /etc/init.d/apache restart
Configuración de SF-Active
Ahora modificaremos
el archivo compartido principal de configuración de sfactive, ubicado
en /home/sfa94/shared/global.cfg
Primero modificamos
la línea
$server_root =
"";
Y le agregamos la ruta al directorio principal de sfactive, dejándola
así:
$server_root = "/home/sfa94";
Luego buscamos
la siguientes líneas 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íneas, se modifico:
case "argentina":
$config_dir = "/home/argentina/local/config";
Configuración de base de datos MySQL
Ingresar un password para el usuario “root” del nuevo servidor mysql,
ya que el mismo después de instalarse no tiene contraseña.
# 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á del administrador de mysql.
Ahora ingresaremos
la estructura de la base de datos e información de ejemplo.
Acceder al directorio de instalación 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íneas
usamos el usuario “argentina” y nos pedirá el password de
la base de datos “argentina” e ingresamos la información
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ón 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és.
Con esta información
ya tendremos un sitio de prueba funcionando.
Seguir leyendo
todas las líneas del archivo sfactive.cfg para personalizar el sitio
a gusto.
Todas las líneas están explicadas ahí 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ían otros tutoriales de instalación
muy poco detallados.
Siguiendo esas guías, solo pude completar mi primer instalación
exitosa recién 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élo
y envíalo 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ón:
Para que la misma maquina reconozca el nombre sfa94.argentina.indymedia.org
como propio, es necesario agregar esta información 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ón 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ón 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ír.
linefeed.org/~mat/sf-active_tutorial.html
| 
