From 8c41140d6a8159d297c58199811fbe684b37c348 Mon Sep 17 00:00:00 2001 From: Leandro Lucarella Date: Tue, 27 Jan 2004 21:20:29 +0000 Subject: [PATCH] Se agrega primer intento de intrucciones de intralacion. --- doc/doxygen/instalacion.php | 238 ++++++++++++++++++++++++++++++++++++ 1 file changed, 238 insertions(+) create mode 100644 doc/doxygen/instalacion.php diff --git a/doc/doxygen/instalacion.php b/doc/doxygen/instalacion.php new file mode 100644 index 0000000..3c5e8e6 --- /dev/null +++ b/doc/doxygen/instalacion.php @@ -0,0 +1,238 @@ +/** @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 ) 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 + + 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 + + + # Las siguientes líneas son para otros archivos de perl + + SetHandler perl-script + PerlHandler Apache::Registry + Options ExecCGI + + @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 '' > 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 + + +*/ -- 2.43.0