Publicar varios ABCD-Site bajo una misma instalación de ABCD

From ABCD Wiki
Revision as of 01:52, 5 January 2020 by Guilda (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Para configurar varios sitios en la misma instalación de ABCD hay que tener en cuenta los siguientes archivos de configuración del iAH:

iah.def.php Localizado en la carpeta htdocs/iah/scripts. Son importantes los siguientes parámetros:

PATH_DATA

Indica la ruta relativa a la raíz de la aplicación en el servidor Web donde se encuentran las páginas estáticas (IAH);

PATH_CGI-BIN

Indica la ruta absoluta del directorio de scripts de CGI

       Ej.: /ABCD/www/htdocs/iah/scripts/

PATH_DATABASE

Indica el camino absoluto del directorio de base de datos en el servidor

       Ej.:/ABCD/www/bases/

PATH_DEF

Indica la ruta absoluta del directorio que contiene los archivos de configuración de las bases de datos

       Ej.: /ABCD/www/bases/par/

Para mayor información ver: [1]


bvs-site-conf.php

Localizado en la carpeta htdocs/site/ contiene los parámetros de configuración de un sitio en particular. Merecen atención los siguientes:

DIRECTORY

Establece el directorio del site para ser accedido mediante HTTP.

       Ej.: DIRECTORY=/site/

SITE_PATH

Ruta completa a la carpeta donde está alojado el directorio del site.

       Ej.: SITE_PATH=/ABCD/www/htdocs/site/

DATABASE_PATH

Ruta completa al lugar donde están alojados los archivos del site en la carpeta de bases de datos

       Ej.: DATABASE_PATH=/bases/site/
DBN.def Es un archivo de texto compuesto por seis secciones y localizado en la carpeta que indica el parámetro PATH_DEF del iah.def.php.

En estas secciones se define las rutas de acceso a la base de datos, índices, formatos de presentación y elementos requeridos por el interfaz iAH.

DBN puede corresponder con el nombre de la base de datos, pero también puede ser un nombre simbólico usado para vincular una base de datos en particular con sus recursos. En los parámetros al interior del DBN.def se hará mención al nombre verdadero de la base de datos identificada con ese nombre simbólico.

Basados en estos archivos de configuración vemos que para poseer varios sites bajo la misma instalación de ABCD, tenemos que replicar la carpeta htdocs/site/ tantas veces como instalaciones diferentes queramos tener. A fin de mantener la estructura propia de ABCD recomendamos tener una única carpeta htdocs/site/ y al interior de ella replicar su contenido en tantas carpetas como instalaciones vayamos a crear:

centro

Al interior de cada una de estas carpetas copiaremos los archivos contenidos en la carpeta htdocs/site/ original: centro

Como ya se mencionó, archivo bvs-site-conf.php localizado en cada carpeta de un site, contiene los parámetros:

DIRECTORY para establecer el acceso via http al directorio base del site

SITE_PATH para establecer la ruta completa el directorio base del site

DATABASE_PATH para establecer la ruta completa al directorio de la carpeta de bases de datos donde se encuentran los archivos de configuración del site

En nuestro ejemplo el archivo bvs-site-conf.php del sitio facultad1 deberá especificar:

       DIRECTORY=/site/facultad1/
       SITE_PATH=/ABCD/www/htdocs/site/facultad1/

Entonces, para administrar el site facultad1 escribiremos en nuestro navegador:

       http://[HOST]/site/facultad1/admin/  

y para visualizar el site de la facultad1, escribiremos en nuestro navegador:

       http://[HOST]/site/facultad1/

Nota: La carpeta htdocs/site/bvs-mod contiene una sub-carpeta denominada FCKeditor que contiene el editor utilizado por ABCD para presentar los campos que ingresan como Area de HTML. La ruta relativa hacia esa carpeta se define en el archivo config.php mediante el parámetro $FCKEditorPath. Dado que esta carpeta es común a todos los "sites" pudiera permanecer en el carpeta original htdocs/site/bvs-mod y crear en las las carpetas de los diferentes ABCD-Site un Enlace simbólico hacia la carpeta bvs-mod evitando de esta forma replicar ésta en los diferentes sites


Acceso a las bases de datos

ABCD-SITE viene configurado, en su versión original, para acceder a las bases de datos contenidas en una única carpeta bases. Para estos efectos existen los parámetros PATH_DATABASE y PATH_DEF en el iah-def.php. El parámetro PATH_DATABASE está designado a sustituir la porcion %path_database% que conseguimos en los archivos DBN.def para así construir la ruta absoluta hacia los diferentes recursos de las bases de datos. El parámetro PATH_DEF se utiliza para localizar los archivos DBN.def definidos para cada base de datos.

Como el iah.def.php tiene el parámetro

      PATH_DEF=/ABCD/www/bases/par/ 

corresponde colocar en esa carpeta los archivos DBN.def de las bases de datos mencionadas en la configuración de cada site independiente. Por lo tanto si mantenemos en el DBN.def la referencia a los recursos de la base de datos a través del parámetro %path_database%las líneas del DBN.def que estén de la siguiente forma:

      FILE DATABASE.*=%path_database%biblo/data/biblo.*  

se convertirán a : FILE DATABASE.*=/ABCD/www/bases/biblo/data/biblo.* ya que el segmento %path_database% de todas las líneas del DBN.def apuntará a la carpeta /ABCD/www/bases/. Esto significa que si tenemos múltiples carpetas bases la opción es colocar rutas absolutas hacia los recursos de la base de datos, ejemplo,

      FILE DATABASE.*=/bases/facultad1/biblo/data/biblo.*.

Recuerde que DBN.def define un nombre simbólico para relacionar un conjunto de recursos con las páginas de iAH y no es necesariamente el nombre de la base de datos. Por lo tanto si en nuestras carpetas bases tenemos tenemos una base de datos denominada biblo en cada una, en lugar de tener el BIBLO.def podemos tener FACULTAD1.def para referenciar los recursos de ese site en particular.