+/** @page instalacion Manual de Instalación
+
+@section apache Instalación de Apache.
+
+ @verbatim
+ Nombre Versión
+ apache 1.3.29-1
+ apache-common 1.3.29-1
+ apache-utils 1.3.29-1
+ @endverbatim
+
+ @subsection apache_config Configuración.
+ Poner como DocumentRoot /var/www/htdocs.
+
+ @subsection apache_embperl Instalación del Embperl para la Intranet del MECON.
+
+ Paquetes del Apache utilizados
+ @verbatim
+ Nombre Versión
+ libapache-dbi-perl 0.92-0.1
+ libapache-mod-perl 1.29-1
+ libapache-session-perl 1.54-1
+ libapache-tempfile-perl_0.04-1_all.deb -
+ @endverbatim
+
+ @note El último paquete de la lista fue escrito por la fundación
+ Via Libre y por lo tanto no se encuentra en el repositorio del
+ apt de debian, y sirve para realizar el manejo de las sesiones de
+ los usuarios a través de una cookie que registra la información
+ en la base de datos Sessions de mysql.
+
+ Otros paquetes de perl usados para la instalación de la Intranet
+
+ Paquetes que están en el repositorio del apt de debian
+ @verbatim
+ Nombre Versión
+ perl 5.8.1-2
+ perl-base 5.8.1-2
+ perl-modules 5.8.1-2
+ libdbi-perl 1.35-1
+ libembperl-perl 2.0b9.0-1
+ libhtml-embperl-perl 1.3.6-1
+ libxml-perl 0.07-10
+ libwww-perl 5.69-4
+ liburi-perl 1.23-1
+ libxbase-perl 0.2400-1
+ libxml-parser-perl 2.34-1
+ libxml-dumper-perl 0.67-1
+ @endverbatim
+
+ Archivos adicionales para el manejo de la sesión del usuario
+ @verbatim
+ Nombre Ubicación
+ SimpleXMLISO.pm /usr/share/perl5/Apache/Session/Serialize/
+ DumperISO.pm /usr/share/perl5/XML/
+ Php2Embperl_Session.epl /var/www/htdocs/ (raiz del Apache)
+ @endverbatim
+
+ Todos estos archivos sirven para compartir las sesiones de los
+ usuarios entre diferentes lenguajes. En el caso de la Intranet
+ los lenguajes actualmente usados son PHP y Embperl. Los archivos
+ SimpleXMLISO.pm (autor: Gonzalo Merayo) y DumperISO.pm (autor:
+ Jonathan Eisenzopf <eisen@pobox.com>) son librerías escritas
+ en Lenguaje PERL que sirven para parsear el XML de la sesion
+ utilizada por los sistemas programados en Embperl. El archivo
+ Php2Embperl.epl le sirve a la Intranet para cargar todos los
+ datos de la sesión de PHP y pasarlos a la sesión de Embperl.
+
+
+ @subsubsection apache_embperl_apache Configuración del Servidor Apache
+
+ En este documento se incluye solamente la configuración de
+ Embperl, dejándose de lado por el momento la configuración de PHP
+ o de cualquier otro punto que pueda surgir durante la instalación.
+
+ Archivos @ref embperl_apache_httpd.conf y @ref embperl_apache_modules.conf
+
+ En versiones anteriores la información del archivo modules.conf
+ se encontraba incorporada al archivo httpd.conf pero para mayor
+ claridad fueron separados. Estos archivos se encuentran por
+ default en el directorio /etc/apache/ como el resto de los
+ archivos de configuración del Servidor Apache.
+
+ @par embperl_apache_modules.conf modules.conf
+ El archivo modules.conf contiene la declaración de
+ todos los módulos del Apache que serán cargados en el momento de
+ levantar el servicio. Para cargar el módulo perl es necesario
+ incluir en este archivo la siguiente línea: LoadModule perl_module
+ /usr/lib/apache/1.3/mod_perl.so Observación: El directorio 1.3
+ se corresponde con la versión del apache que se está instalando.
+
+ @par embperl_apache_httpd.conf httpd.conf
+ Este es el archivo de configuración principal
+ del Apache y para la configuración del Embperl se deben
+ seguir los siguientes pasos: Agregar la linea Include
+ /etc/apache/modules.conf para incorporar la información
+ del archivo modules.conf. Agregar las siguientes líneas
+ correspondientes a la configuración específica de Embperl:
+
+ @verbatim
+ # Las siguientes líneas son para páginas de Embperl
+ <Files *.epl>
+ PerlModule Apache::DBI # Módulo que permite interactuar con bases de datos
+ PerlModule Data::Dumper; # Módulo que permite devolver resultados de variables
+ AddType text/html .epl # Indica que los archivos .epl deben ser interpretados por el handler de perl
+ SetHandler perl-script # Indica que handler usar
+ PerlHandler HTML::EmbperlObject # Agrega el módulo de EmbperlObject
+ PerlSetEnv EMBPERL_COOKIE_DOMAIN ".mecon.ar" # Indica el dominio de la cookie usada para la sesion
+ PerlSetEnv EMBPERL_SESSION_ARGS "DataSource=dbi:mysql:Sessions;host=servidor_mysql UserName=usuario Password=password NSems=16" # Setea los argumentos de la base de datos que maneja la sesión
+ PerlSetEnv EMBPERL_OPTIONS 16 # Estaba así
+ PerlSetEnv EMBPERL_SESSION_CLASSES "MySQL Semaphore SimpleXMLISO" # Indica las librerías usadas para administrar el almacenamiento de la información de la sesión en la base de datos
+ PerlSetEnv EMBPERL_OBJECT_BASE base.epl #Indica el archivo base usado por EmbperlObject en cada directorio
+ Options ExecCGI # Indica el modo de ejecución del Embperl
+ </Files>
+
+ # Las siguientes líneas son para otros archivos de perl
+ <Files *.pl>
+ SetHandler perl-script
+ PerlHandler Apache::Registry
+ Options ExecCGI
+ </Files>
+ @endverbatim
+
+
+ @subsection apache_php Instalación de PHP.
+
+ Paquetes necesarios:
+ @verbatim
+ Nombre Versión
+ php4 4.3.3
+ php4-pear 4.3.3
+ php4-gd 4.3.3
+ php4-ldap 4.3.3
+ php4-mysql 4.3.3
+ @endverbatim
+
+ @subsubsection apache_php_pear Instalación de paquetes de PEAR.
+ @verbatim
+ pear install Date
+ pear install Validate
+ pear install Mail_Mime
+ pear install HTML_Common
+ pear install HTML_Table
+ pear install HTML_QuickForm
+ pear install HTML_Page
+ @endverbatim
+
+ @subsubsection apache_php_config Configuración de PHP.
+
+ La configuración por omisión de Debian es bastante buena, sólo hay que modificar
+ (o agregar en caso de no estarlo) lo siguiente:
+ @verbatim
+ zlib.output_compression = On
+ allow_call_time_pass_reference = Off
+ memory_limit = 16M
+ error_reporting = E_ALL
+ display_errors = Off
+ log_errors = On
+ log_errors_max_len = 4096
+ track_errors = On
+ html_errors = Off
+ error_log = /var/log/apache/php.log
+ register_globals = Off
+ register_argc_argv = Off
+ magic_quotes_gpc = Off
+ default_charset = "iso-8859-1"
+ include_path = ".:/var/www/sistemas_lib:/var/www/meconlib/lib:/var/www/meconlib/pear_lib_tmp:/usr/share/php"
+ extension=gd.so
+ extension=ldap.so
+ extension=mysql.so
+ [mail functions]
+ SMTP = mail1.mecon.ar
+ sendmail_from = intranet@mecon.gov.ar
+ [Session]
+ session.cookie_domain = .mecon.ar
+ session.name = INTRANET_PHPSESSID
+ session.auto_start = 1
+ @endverbatim
+
+
+@section locales Configuración de locales.
+ @verbatim apt-get install locales @endverbatim
+ Luego elegir es_AR ISO.8859-1 en la primera lista y es_AR en la segunda.
+
+
+@section sistemas Instalacion de sistemas.
+
+ @subsection sistemas_subversion Instalación de Subversion.
+ Instalar el paquete subversion:
+ @verbatim apt-get install subversion @endverbatim
+
+ @subsection sistemas_permisos Permisos y estructura de directorios.
+ Asegurarse de que los permisos en /var/www sean correctos:
+ @verbatim
+ chown www-data.www-data /var/www -R
+ chmod 2770 /var/www
+ @endverbatim
+ Como el usuario www-data cree la estructura de directorios:
+ @verbatim
+ su www-data
+ cd /var/www
+ mkdir sistemas htdocs sistemas_lib
+ @endverbatim
+
+ @subsection sistemas_checkout Obtener bibliotecas y sistemas.
+ Obtener MEconlib:
+ @verbatim
+ svn co http://portal.mecon.ar/svn/meconlib/tronco meconlib
+ @endverbatim
+ Obtener Intranet, SAMURAI, AI y otros sistemas:
+ @verbatim
+ cd sistemas
+ svn co http://portal.mecon.ar/svn/intranet/tronco intranet
+ svn co http://portal.mecon.ar/svn/samurai/tronco samurai
+ svn co http://portal.mecon.ar/svn/ai/tronco ai
+ @endverbatim
+
+ @subsection sistemas_public Crear estructura pública.
+ @verbatim
+ cd /var/www/htdocs
+ ln -s ../meconlib/www MECON
+ echo '<?php header("Location: /sistemas/intranet/") ?>' > index.php
+ mkdir sistemas
+ cd sistemas
+ ln -s ../../sistemas/intranet/sistema/www intranet
+ ln -s ../../sistemas/samurai/sistema/www samurai
+ ln -s ../../sistemas/ai/sistema/www ai
+ @endverbatim
+
+ @subsection sistemas_libs Crear estructura de bibliotecas.
+ @verbatim
+ cd /var/www/sistemas_lib
+ ln -s ../sistemas/ai/lib/AI
+ ln -s ../sistemas/samurai/lib/SAMURAI
+ @endverbatim
+
+
+*/
projects / mecon / intranet.git / commitdiff