DiarmaCMS. Manual de instalación. Versión de la aplicación 0.1.0

Transcripción

1 DiarmaCMS Manual de instalación Versión de la aplicación Versión del documento Marzo 2010

2 Preparar servidor de datos Diarma CMS esta optimizado para utilizar MySQL 5.0 o posterior no obstante es compatible con cualquier servidor de datos que sea capaz de interpretar SQL. Desde un administrador de base de datos conéctese al servidor de datos y cree un usuario y una base de datos. Así mismo debe asociar la base de datos creada con el usuario asignando todos los permisos a dicho usuario. Nota: Luego de que ha finalizado la instalación puede reducir el nivel de acceso del usuario a la base de datos. Preparar archivos Usted seguramente cuenta con un archivo comprimido cuyo nombre es: diarmacmsvx_y_z donde x, y, z son valores numéricos que representan la versión del sistema. Cree una carpeta en su equipo y descomprima este archivo en ella. Al hacerlo notará que se crea, entre otras, una carpeta llamada diarma. Súba esta carpeta a su servidor web. Le recomendamos que esta carpeta no sea accesible via web. Por ejemplo súbala como carpeta hermana de la carpeta pública (htdocs, public_html, www, etc..). Nota: Vea el Anexo I para conocer el motivo de esta sugerencia. Recuerde la ruta donde ha quedado esta carpeta ya que la necesitará para configurar la aplicación más adelante. La ruta de esta carpeta será llamada Diarma Home en el resto de este documento. Importar base de datos Entre las carpetas que se han creado luego de descomprimir el archivo encontrará una llamada sql que contiene el archivo database_structure.sql el cual debe importar a la base de datos que ha creado mediante un administrador de base de datos.

3 Configuración de Diarma Core Diarma Core es el software base de todas las aplicaciones Diarma, es decir, el corazón de todas ellas. Debido a que por servidor solo existe un Diarma Core y múltiples aplicaciones Diarma es que Diarma Core debe conocer a todas ellas. Para ello, dentro de la carpeta diarma podrá encontrar otra llamada diarma_conf donde se encuentra la configuración de todas las aplicaciones Diarma. Abra la carpeta diarma_conf. Allí encontrará otra carpeta llamada apps. Abrala. Dentro de ella existen una carpeta por cada aplicación Diarma que se encuentre instalado en su servidor web. Abra la carpeta diarmacms donde se encuentra la configuración de Diarma CMS. Verá dos archivos: configuration.ini y modules.ini. A continuación una breve descripción del objetivo de cada archivo. Archivo modules.ini Este archivo contiene la configuración de los módulos de Diarma Core que se requieren para ejecutar las aplicaciones Diarma que se encuentran instaladas en su servidor web. Generalmente no necesitará modificar este archivo salvo que realice una actualización. Archivo configuration.ini Este archivo es uno de los que debe modificar para poner en funcionamiento la aplicación Diarma. La estructura de este archivo puede verla en la Imágen 1. Notará que esta compuesta por cinco secciones: GENERAL, ENVIRONMENTS, WEB SERVERS, SQL SERVERS y MAIL SERVERS. GENERAL Nota: Para una instalación rápida no tenga en cuenta esta sección y pase a la siguiente. Esta sección agrupa los parámetros de configuración general, entre ellos el parámetro defaultenvironment que le permite definir cual es el ambiente sobre el cual la aplicación Diarma será ejecutada. Este parámetro existe para que pueda definir ambientes de ejecución alternativos, por ejemplo, uno de emergencia. De este modo usted podrá definir varios ambientes y utilizar el parámetro defaultenvironment para indicar cual debe ser utilizado. Para facilitar la instalación se proporciona un ambiente por defecto: default_environment por lo que no necesita modificar este parámetro. ENVIRONMENT Nota: Para una instalación rápida no tenga en cuenta esta sección y pase a la siguiente. Aquí deberá definir todos los ambientes sobre el cual la aplicación Diarma deberá ser ejecutada.

4 Para facilitar la instalación se proporciona un ambiente por defecto: default_environment compuesto por tres servidores también por defecto. WEB SERVERS Aquí debe definir todos los servidores web sobre los cuales esta aplicación Diarma será ejecutada. Generalmente usted solo necesitará un solo servidor web por lo que se proporciona una configuración por defecto llamado default_www que deberá modificar. Veamos la configuración del servidor web: [default_www] name="default" server="localhost" path="" url="" filerepositorypath="default" Como verá la configuración esta compuesta por cinco parámetros de los cuales solo debe modificar path y url para lograr una instalación rápida. El parámetro path define la ruta o dirección interna de la aplicación diarma. A modo de ejemplo, si usted instalará la aplicación Diarma en la raiz de su sitio web debe definir este parámetro con la ruta de la carpeta pública de su servidor web. Algunos ejemplos típicos: path="/home/user/public_html" path="c:/xampp/htdocs" El parámetro url define la dirección web de la aplicación Diarma. A modo de ejemplo, si used instalará la aplicación en la raiz de su sitio web debe definir este parámetro con la dirección web de su sitio. Ejemplo: url=" Otro parámetro que puede querer modificar es filerepositorypath, es aquel que indica la ruta de la carpeta diarma_filerepository que por defecto se encuentra dentro de la carpeta diarma. Si desea mantener la carpeta en dicha ubicación debe mantener el valor default de otra forma deberá indicar aquí la ruta. Consejo: Si cambia la ubicación de la carpeta diarma_filerepository se recomienda que siempre se mantenga fuera de las carpetas de acceso público. Vea el Anexo I para obtener una explicación. SQL SERVERS Del mismo modo que lo hizo con los servidores web debe aquí definir los servidores de base de datos con los cuales se conectará la aplicación.

5 Y al igual que para los servidores web se proporciona la configuración de un servidor de base de datos por defecto para el cual solo debe definir el usuario (user), contraseña (password) y el nombre de la base de datos (database) que ha creado para las aplicaciones Diarma. Una de las fortalezas de las aplicaciones Diarma es que pueden comunicarse con múltiples servidores de base de datos a la vez lo que permite distribuir los datos en diferentes servidores y otras ventajas que ofrece esta fortaleza. Para obtener estos beneficios debe definir en esta sección todos los servidores de base de datos que se comunicarán con la aplicación. El servidor principal es aquel que esta asociado al ambiente (environment) definido en la sección GENERAL. No obstante lo anterior, para realizar una instalación simple basta con definir los parámetros del servidor que se proporciona por defecto. ; GENERAL [general] defaultenvironment="default_environment" debuglevel="3" ; ENVIRONMENTS [default_environment] WebServerConfig="default_www" SQLServerConfig="default_sql" MailServerConfig="default_mail" ; WEB SERVERS [default_www] name="default" server="localhost" path="" url="" filerepositorypath="default" ; SQL SERVERS [default_sql] name="default" brand="mysql" server="localhost" user="" password="" database="" ; MAIL SERVERS [default_mail] name="default" ="" protocol="pop" server="localhost" port="110" timeout="30" user="" password="" Imágen 1: Archivo configuration.ini

6

7 Intalación de Diarma CMS Una vez que ha subido la carpeta diarma a su servidor web y ha configurado la aplicación Diarma CMS es momento de subir los archivos que componen el área pública de Diarma CMS. Suponemos que instalará la aplicación en la raiz de su sitio web aunque puede instalarla en una subcarpeta, solo debe definir la ruta y la dirección web acorde en el archivo configuration.ini en los parámetros path y url. En la carpeta donde ha descomprimido el archivo diarmacmsvx_y_z encontrará una carpeta llamada diarmacms. Suba el contenido de la misma a la carpeta pública de su servidor web. En la raiz de esta carpeta encontrará un archivo start_diarmacms.php en cuya tercera línea se verá como la siguiente: $diarma_home=""; Debe igual esta variable a Diarma Home, es decir, la ruta de la carpeta diarma que ha subido al servidor al inicio de este manual. Algunos ejemplos típicos: $diarma_home="/home/user/diarma"; $diarma_home="c:/xampp/diarma"; De esta forma usted esta indicándole a la aplicación Diarma CMS donde se encuentra la carpeta que contiene los archivos privados que componen la aplicación.

8 Anexos Anexo I Los productos Diarma fueron diseñados para aumentar la seguridad de sus aplicaciones web pero para lograr el más alto nivel de seguridad es necesario que ciertos archivos no se encuentren accesibles vía web. Para ello debe subir la carpeta diarma al servidor web dentro de una carpeta no pública. A modo de ejemplo seguramente la carpeta pública de su servidor web puede llamarse public_html, www o htdocs. Recomendamos que la carpeta diarma sea hermana de dicha carpeta pública.