INSTALACIÓN Back-End Sistema Administrador de Contenidos (CMS) Instrucciones de instalación Autor: Peter Bojanic & Mike Gifford Última revisión: 2003-09-06 Versión de Back-End: 0.5.4 INTRODUCCCIÓN Back-End 0.5.4 es la tercera liberación oficial de Back-End basado en phpSlash (phpSlash versión 0.7) Se buscan desarrolladores para continuar con el desarrollo de Back-End, un Sistema Administrador de Contenidos moderno y multi lenguaje.   Si está instalando el sistema Back-End por primera vez, siga las instrucciones de Instalación por primera vez. Si quiere migrar una instalación existente de Back-End 0.5.2 a la última versión desarrollada, siga las instrucciones para Migrar desde Back-End 0.5.2. Si quiere actualizar desde una versión en desarrollo Back-End 0.5.x a la última versión bajo CVS, siga las instrucciones para Actualizar Sistema de desarrollo. REQUISITOS DE CONFIGURACIÓN PHP Puede utilizarse PHP 4.1 o versiones posteriores, el cual puede configurarse como módulo o como CGI. La instalación utilizando el CGI puede insumir más tiempo que si se utiliza el módulo. Es necesario que gpc_magic_quotes esté DESACTIVADO y register_globals debería poder trabajar con él desactivado. PHP Magic Quotes Asegúrese de que magic_quotes y magic_quote_gpc estén desactivados (OFF) en el archivo /etc/php.ini. Magic_quotes_gpc procesa los datos que llegan en modo GET, POST o COOKIE y prefija las comillas simples (') y las contrabarras con una contrabarra (\'), lo que hace que sus email se vean mal. Por esto se aconseja desactivarlo Servidor WEB Utilice un servidor Web moderno (Apache 1.3.x or Apache 2.x (ver notas))o incluso Microsoft IIS. Es útil (aunque no esencial) tener acceso del tipo .htaccess. Mysql Puede utilizarse MySQL 3.23 o posterior (Aún no ha sido probado sobre MySQL 4.x) A. INSTALACIÓN RÁPIDA 1. Descomprima el archivo Back-End0.5.x.tar.gz en su directorio web. Es fundamental que los archivos de la carpeta public_html estén en una ubicación pública dentro del servidor web. Por un tema de seguridad es importante que el directorio de clases no se encuentre en una ubicación pública para que las clases no sean visibles a los visitantes. 2. Setear los permisos de escritura sobre el archivo config.ini.php, desde el servidor escribir: cd public_html chmod 777 config.ini.php 3. Navegar hasta el directorio donde se instalaron los archivos public_html y seguir las pantallas de configuración para configurar Back-End ( esto asume que se ha configurado una base en MySql o que se tienen los permisos necesarios para crear una base nueva.) 4. Por seguridad borre el archivo config_setup.php file y restaure los permisos de escritura sobre el archivo config.ini.php : rmconfig_setup.php chmod 644 config.ini.php 5. Siga las instrucciones de logueo. B. INSTALACIÓN POR PRIMERA VEZ Estas instrucciones lo guiarán en el proceso de instalación de Back-End. Si ud. es un desarrollador o un verificador y quiere que su sistema se encuentre sincronizado con la última versión en desarrollo, siga las instrucciones para Actualizar Sistema de Desarrollo. Si ud. es un usuario y desea actualizar su sistema a la última versión en desarrollo sin perder información, siga las instrucciones para Actualizar Sistema en Producción. 1. Extraiga el archivo Tarball o Zip Descomprima los archivos Back-End0.5.x.tar.gz a su directorio web. Es imprescindible que los archivos de la carpeta public_html estén en una ubicación pública dentro del servidor web. No es necesario que los demás archivos estén en ubicaciones públicas, es incluso más conveniente que estén en una ubicación no visible desde la WEB. Estas instrucciones asumen el valor por defecto de Red Hat de /var/www y que Back-End ha sido instalado en este directorio /var/www/back-end0.5.x 2. Configuración en Apache /back-end directory en Apache Elegí esconder el directorio public_html, pese a que esto es contrario al escenario de instalación estándar de phpSlash, el cual es heredado por Back-End, pero no considero conveniente que los usuarios puedan ver el nodo public_html en la ruta. Por defecto Apache 2.0 (no sucede en Apache 1.3) intenta resolver la parte extra de la ruta, lo cual puede ser un problema si su script CGI utiliza la información extra de la ruta. En dicho caso es necesario forzar el pasaje de la parte extra de la ruta al script: http://httpd.apache.org/docs-2.0/mod/core.html#acceptpathinfo Un ejemplo de configuración sobre Apache 2: <VirtualHost *>   ServerName back-end.org   ServerAlias www.back-end.org   DocumentRoot /var/www/back-end0.5.x/public_html   ErrorDocument 404 /errordocument.php   ServerAdmin [e-mail]   DirectoryIndex index.php index.php3 index.html index.htm index.shtml   LogLevel debug   HostNameLookups off   <Directory /var/www/back-end0.5.x/public_html>   order allow,deny   allow from all   AcceptPathInfo on   # Descomente para habilitar permisos de .htaccess   # AllowOverride FileInfo AuthConfig Limit Options   # esta directiva es necesaria para que Apache 2.0 pase   # la información adicional de la ruta, luego del nombre del script, al PHP   # (ej. http://localhost/back-end/BE_article.php3/1/2)   # antes, la parte '/1/2'de la URI era accesible al   # script PHP por defecto, pero Apache 2.0 intenta resolver   # a una ruta "literal" por defecto   AcceptPathInfo on </Directory> </VirtualHost>  En caso de no tener permiso de escritura sobre el archivo httpd.conf y obtener un error 500 Server Error para cualquier script php que este seguido por una barra (ej test.php/) hay una solución implementada en en el archivo BE_config.php que consiste en insertar un ? entre el script y la / 3.Configurar la base de datos 3a. Crear la base de datos Esto se puede realizar utilizando phpmyadmin, pero me resulta mas sencillo realizarlo desde la línea de comandos.         mysqladmin -u root -h host.domain.ca         create be7 3b. Cargar la base de datos Cargar las tablas core y los valores           cd /var/www/back-end0.5.x/tables Transfiera el archivo SQL completo:        mysql -u root –h        host.domain.ca be7 < slash_core.sql o los componentes SQL individuales         mysql -u root -h         host.domain.ca be7 < slash_core.sql         mysql -u root -h         host.domain.ca be7 < BE_core.sql         mysql -u root -h         host.domain.ca be7 < extra_modules.sql Incluir soporte para acciones        mysql-u root -h        host.domain.ca be7 < BE_actions/add_action_tables.sql        mysql-u root -h        host.domain.ca be7 < BE_actions/populate_action_values.sql 3c.Crear una cuenta de base de datos Se puede evitar este paso especificando la cuenta root para el acceso a MySQL, aunque no se recomienda. En lugar de esto se debería crear y configurar una cuenta para la aplicación.        mysql -u root -h host.domain.ca mysql -e "INSERT INTO mysql.user SET Host = 'host.domain.ca', \        User = 'user', PASSWORD = PASSWORD( '**********' ) , Select_priv = 'N', Insert_priv = 'N', \        Update_priv = 'N', Delete_priv = 'N', Create_priv = 'N', Drop_priv = 'N', Reload_priv = 'N', \        Shutdown_priv = 'N', Process_priv ='N', File_priv = 'N', Grant_priv = 'N', References_priv = 'N', \        Index_priv = 'N', Alter_priv = 'N'" Luego actualice la base para que el usuario sea reconocido y asígnele permisos        mysqladmin -u root -h host.domain.ca reload 3d. Permisos Debemos dar permisos al usuario creado (en este caso user).         mysql -u root -h host.domain.ca mysql -e "GRANT SELECT, INSERT, UPDATE, DELETE ON \        \`be5\`.* TO\`user\`@\`host.domain.ca\`" Puede ser necesario darle permisos de acceso a localhost, dependiendo de como esté configurado MySQL :        mysql -u root -h host.domain.ca mysql -e "GRANT SELECT, INSERT, UPDATE, DELETE ON \        \`be5\`.* TO\`user\`@\`localhost\`" Y puede querer setear la contraseña mediante la clausula IDENTIFIED BY 'password' Finalmente actualice la base para que los permisos tengan efecto.        mysqladmin -u root -h host.domain.ca reload 4. Configure el sistema Nota para Back-End 0.5.3 El sistema de configuración ha cambiado en gran medida.El archivo prepend.php no se utiliza más y la mayoría de los seteos se encuentran en un archivo INI llamado config.ini.php 4a.Configuración de phpSlash (public_html/config.ini.php) Para mas información lea la descripción en el archivo de configuración por defecto de phpSlash config-dist.ini.php. Observese que se utiliza ';' para marcar comentarios. Edite el archivo por defecto config.ini.php        gvim /var/www/back-end0.5.x/public_html/config.ini.php Setee $basedir a la ubicación del directorio public_html        basedir = "/var/www/back-end0.5.x/public_html" Setee $classpath a la ubicación del directorio de clases        classdir = "/var/www/back-end0.5.x/class" Setee $rooturl al lugar donde debe apuntar el navegador para devolver las páginas de Back-End        rooturl = "/back-end0.5.3/public_html" o puede haberse configurado el servidor web por lo tanto        rooturl = "/back-end0.5.3" NOTA: no especifique una URL completa (ej. http://host.domain.ca/back-end0.5.3), porque esto hace que lossubsitios funcionene incorrectamente Setee la configuración de la base de datos        ;; Variables de la base de datos        DB_Host     = "localhost" ; or "host.domain.ca" o lo que corresponda        DB_Database = "be54"        DB_User     = "user"        DB_Password = "password" Setee la ruta hacia los archivos phplib (observe la / al final de la ruta)        phplibdir = "/var/www/back-end0.5.x/phplib/php/" Setee las extensiones de Back-End para soporte de sitios        rootdomain= "domain.ca" ; *** DEPENDIENTE DEL LENGUAJE *** Los seteos de be_domainInit() sobreescriben estos        rootsubdomain  ="www."            ; NB Include trailing '.' if needed (eg 'www.') **** Nota: el dominio raiz "localhost" no se logeará en algunos sistemas. Si está realizando una instalación en su puesto de trabajo con fines de testeo deberá modificar el archivo /etc/hosts para que be.org apunte a 127.0.0.1. También debería ajustar la configuración de Apache para que acepte su nombre de dominio. Para una instalación en ambiente Windows existe un equivalente al archivo de configuración de hosts en c:/windows **** Setee la extensión de Back-End para el mecanismo de autorización        auth_type = 1 ; 1: MySQL (no se especifica valor por defecto) 2: LDAP Descomente la extension de Back-End para LDAP si auth_type se seteo en 2        ;LDAP_Host         = "localhost"        ;LDAP_Port         ="389"  ; default LDAP port #389        ;LDAP_Base_dn      ="dc=localhost,dc=back-end,dc=org"        ;LDAP_Search_detail= "cn"        ;LDAP_BE_uid       = "uid" ; name of uid in the ldap that coresponds to BE uid        ;; user and password for updating LDAP directory        ;LDAP_edit_user     = ""        ;LDAP_edit_user_pass= "secret"        ;LDAP_edit_user_dn  = "cn=Manager,dc=waiter,dc=thepinecone,dc=com" 4b.Configuración de Back-End(public_html/BE_config.php) En muchos casos los seteos por defecto son suficientes, pero puede decidir habilitar o deshabilitar alguno de los módulos opcionales. Edite el archivo de configuración por defecto BE_config.php        gvim /var/www/back-end0.5.x/public_html/BE_config.php Configure los items del lenguaje del dominio        $_BE['languagedomains'] = array ('bojanic.ca'=> 'en','bojanic-french.ca' => 'fr'); 4c.Revisando la configuración A esta altura debería poder ver el sitio de demostración y poder logearse (usuario: admin., contraseña: password). Pueden crearse usuarios nuevos, editar, agregar y borrar contenidos del sitio y explorar los módulos acoplados a Back-End. Si encuentra algún problema vea el archivo test.php a través de su navegador y revise los valores de:        * php version        * php include_path        * php auto_prepend        * gpc_magic_quotes Cualquier error potencial debería aparecer en color rojo. 5.Chequeo de permisos sobre el directorio de transferencia (Opcional) Back-End utiliza el directorio public_html/updir para varias funciones, incluyendo la transferencia (upload) de archivos, el despliegue de archivos PDF y la galería de imágenes. Si los directorios no fueron creados automáticamente por medio de un checkout de CVS o al descomprimir un archivo de tipo tarball debe crearlos en forma manual. El siguiente ejemplo es para un sistema sobre Red Hat 8.0 con httpd corriendo bajo el usuario 'apache'.        cd /var/www/back-end0.5.x/public_html        chown apache.apache updir        chmod 700 updir Los archivos PDF necesitan un área de caché para hacer posible la visualización con Internet Explorer        chown apache.apache updir/dynamicPDFcache        chmod 700 updir/dynamicPDFcache Las galerias de imagenes necesitan un área de caché para acelerar el procesamiento.        chown apache.apache updir/images        chown apache.apache updir/images/tn        chmod 700 updir/images        chmod 700 updir/images/tn 6. Configuracíon de Búsqueda Avanzada (Opcional) La función de búsqueda avanzada utiliza htdig para crear una base de búsqueda y htsearch para satisfacer los pedidos de búsqueda. Puede obtenerse información acerca de la configuración de los mismos en contrib/CUPE/htdig/README. 7.Configuración de LDAP (Opcional) El esquema de autenticación LDAP de Back-End soporta OpenLDAP. Puede obtenerse documentación detallada acerca de su configuración en contrib/CUPE/ldap/README 8.Completar la Instalación En este punto debería poder navegar el CMS una vez logueado en: public_html/login.php El login por defecto es: Usuario: root, Contraseña: back-end En la barra de navegación (la barra azul debajo de los iconos de temas que contiene vínculos de texto) haga clic sobre ‘Authors’. Cambie la contraseña para el usuario root y haga clic en update (actualizar). Nota: No borre aún la cuenta root, antes utilícela para crear una cuenta personal con todos los permisos de seguridad. Luego, publique un artículo en el sitio. Puede navegar a través de la interface de administración o de la página web pública. Mediante la edición inline es posible editar, borrar o insertar paginas a medida que se navega. 9. Instalación de Módulos Adicionales phpESP Ha sido probado con phpESP 1.6.1. Lea el archivo INSTALL de phpESP. Copie los contenidos de phpESP a /phpESP/ Modifique el archivo public_html/phpESP/admin/phpESP.ini.php. Borre los contenidos de mysql_create.sql & mysql_populate.sql del directorio public_html/phpESP/scripts/db/ Asegúrese de que la información acerca del nombre de servidor (ServerName) del host virtual sea correcta y logéese en public_html/phpESP/admin/ con el usuario por defecto (usuario: root, password: esp). Por último cree una nueva plantilla por medio de esta interface 10. Notas sobre Seguridad Back-End posee algunos módulos que permiten que php escriba archivos directamente al servidor.      - instalación por defecto de jpcache     - Módulo de Bibliografía     - Módulo Galería     - Módulo BE_Upload     - Módulo de edición de Plantillas     - PDF ViewWe ha limitado los tipos de archivos Se ha restringido la transferencia de archivos dentro de Back-End de modo que sólo algunos tipos de archivos puedan ser transferidos y sólo las plantillas puedan ser editadas. Sin embargo, si este aspecto le parece crítico, puede deshabilitar estos módulos. Por mas información acerca de aspectos de seguridad revise:     http://ca3.php.net/manual/en/security.filesystem.php Cuando su sistema este configurado y funcionando pueden borrarse los siguientes archivos:        public_html/test.php        public_html/config_setup.ini.php        public_html/config_setup.php Una vez instalado el sistema deberían asegurarse los permisos de escritura sobre el directorio público:        chmod 644 public_html/* 11. Troubleshooting y FAQs [En desarrollo] Si tiene problemas contacte a los desarrolladores a través del foro se soporte en http://sourceforge.net/forum/?group_id=6763 o de la lista de distribución http://sourceforge.net/mail/?group_id=6763 C.Migrar desde Back-End 0.5.x Respalde la base de datos y copie los archivos a otro directorio. Instale el código nuevo desde el tarball Configure el sistema (como en la Sección A) Configure phpSlash (public_html/config.ini.php) Revise las notas de configuración en la sección A4a:Configuración de phpSlash y edite los valores en : public_html/config.ini.php para ajustarlos a su sitio (la explicación completa acerca de los valores comentados en el original se encuentra en el archivo config-dist.ini.php Configure Back-End (public_html/BE_config.php) Revise las notas de configuración en la secciónA4b: Configuración de Back-End y edite los valores en public_html/BE_config.php para ajustarlos a su sitio. Actualice la base de datos mediante el script tables/Upgrade52_to_53.sql        cd /var/www/back-end0.5.x/tables        mysql -u root -h host.domain.ca        be7 < Upgrade52_to_53.sql Configure otras funcionalidades Para configurar el soporte de Búsquedas Avanzadas, revise la sección A6: Configuración de Búsqueda Avanzada. Para configurar el soporte de Autenticación via LDAP, revise la sección A7: Configuración de LDAP> Configuración del bloque de administración. Las tareas de administración se muestran en un bloque aparte. La instalación ha configurado el bloque, pero es necesario hacerlo visible en las pantallas apropiadas Agregar una sección de administración oculta Logueese en su sitio como root. Como las funcionalidades de administración han sido migradas desde la Barra de Navegación NO verá el vínculo a la Sección administración. Navegue en forma manual hasta la página de administración de secciones http://www.domain.ca/back-end/admin/BE_sectionAdmin.php Cree una nueva sección con URLname admin. y agréguele un titulo Edición del bloque de tareas Navegue en forma manual hasta la página de administración de bloques http://www.domain.ca/back-end/admin/blockAdmin.php Seleccione para editar el bloque Tasks (tareas) y copie el siguiente texto en los campos menu_ary=menuadmin&tpl=navbarBlockh Cambie la opción de columna de 'right'a'center'. D.Actualizar sistema de Desarrollo 1.Instale el nuevo código 2. Actualice la base de datos, editando el script tables/Upgrade52_to_53.sql cd /var/www/back-end0.5.x/tables gvim Upgrade52_to_53.sql Busque los segmentos de código de migración de la base que fueron agregados desde la última vez que migró la base de datos # 28Feb03 # Adding Wiki text editing by storing source # ALTER TABLE `be_articleText` ADD `content_source` TEXT NOT NULL AFTER content, Puede copiarse el texto y pegarlo en una herramienta de administración basada en web, por ejemplo phpMyAdmin, o puede escribir los trozos de código a un archivo temporal y ejecutarlo desde la línea de comandos. mysql -u root -h host.domain.ca be7 < temp_upgrade_snippets.sql