Difference between revisions of "Installing LILDBI-WEB"

Revision as of 16:05, 20 February 2014

Linux

Steps to install LILDBI-Web 1.7a on Linux

Pre-requirements

A. Hardware and software

   1. a web server installed (*);
   2. the PHP (**) installed and set with the web server;
   (*)  We recommend using Apache 2.2.x
   (**) We recommend using PHP 5.3.xx

Doubts can be directed to the address below, under Pre-required software:

-  http://bvsmodelo.bvsalud.org/ 

B. Advanced technical knowledge

   1. on Linux operating system;
   2. on network configuration and management;
   3. on web server configuration;
   4. on application software installation.

Reference:

- PHP:       http://www.php.net/             
- Apache:    http://www.apache.org/            

Download Versões Recomendadas:

- PHP 5.3.0 http://museum.php.net/php5/
- Apache    http://archive.apache.org/dist/httpd/binaries/linux/

Installing

  I - Installing Lildbi-web (default)
 II - Installing Lildbi-web through a VirtualHost previously set on a web server 
III - Installing manualy in case of PHP configuration error or data access error

I - Installing Lildbi-web (default)

This procedure is the default one for users without expertise on installing and configuring Apache and PHP

STEPS:

1. Unpack the LILDBIWEB-linux-1.7a.tgz file to a temporary directory (e.g.: /tmp). The following directory structure will be created:

  e.g.:  tar xvzpf LILDBIWEB-linux-1.7a.tgz

  bvs-+
      |- htdocs
      |- cgi-bin
      |- bases

It is assumed a web server has been installed under /usr/local/apache.

In that directory create a directory named bases, usr/local/apache/bases.

Then, move the cursor to the directory where the LILDBI-Web was unpacked, in this example we used the directory /tmp.

Copy all files and directories (recursivelly) from /tmp/bvs/htdocs/ to /usr/local/apache/htdocs/

Repeat the copy process with the directory /tmp/bvs/cgi-bin/ to the directory /usr/local/apache/cgi-bin/

Repeat the copy process with the directory /tmp/bvs/bases/ to the directory /usr/local/apache/bases/

2. Access the system setup page through an internet browser (Internet Explorer, Firefox and so on), by adding /lildbi/install/setup.php to the base URL and follow the steps described to setup the system on the server.

  e.g.:     http://localhost/lildbi/install/setup.php

3. Access the LILDBI-Web administration site by adding /lildbi/index_en.htm and then clicking on Database administration.

  e.g.:     http://localhost/lildbi/index_en.htm

4. Access the LILDBI-Web site URL by adding /lildbi/index.htm and then clicking on "Search"

  ex:     http://localhost/lildbi/index_en.htm

II - Installing Lildbi-web through a VirtualHost previously set on a web server

One can set a VirtualHost on the web server using any desired directory structure, therefore the example will use the structure adopted by BIREME to its applications.

STEPS:

1. Unpack the LILDBIWEB-linux-1.7a.tgz file to a temporary directory (e.g.: /tmp). The following directory structure will be created:

  e.g.:  tar xvzpf LILDBIWEB-linux-1.7a.tgz

  bvs-+
      |- htdocs
      |- cgi-bin
      |- bases

Open the configuration file of Apache web server (httpd-vhosts.conf) and place a VirtualHost according to your configuration.

VirtualHost sample for Apache server:

<VirtualHost localhost:80>
    DocumentRoot "/bvs/htdocs"
    Options Indexes FollowSymLinks MultiViews
    ServerName localhost
    DirectoryIndex index.htm index.php homepage.htm
    ScriptAlias /cgi-bin/ "/bvs/cgi-bin/"
    <Directory "/bvs/cgi-bin">
        AllowOverride None 
        Options FollowSymLinks
        Order allow,deny 
        Allow from all 
    </Directory>
    <Directory "/bvs/htdocs">
        AllowOverride None 
        Options All
        Order deny,allow
        Allow from all 
    </Directory>
</VirtualHost>

2. Access the system setup page through an internet browser (Internet Explorer, Firefox and so on), by adding /lildbi/install/setup.php to the base URL and follow the steps described to setup the system on the server.

  e.g.:     http://localhost/lildbi/install/setup.php

3. Access the LILDBI-Web administration site by adding /lildbi/index_en.htm and then clicking on Database administration.

  e.g.:     http://localhost/lildbi/index_en.htm

4. Access the LILDBI-Web site URL by adding /lildbi/index.htm and then clicking on "Search"

  ex:     http://localhost/lildbi/index_en.htm

III - Installing manualy in case of PHP configuration error or data access error

After unpacking and copying to the installation directory according to previous steps one must edit the files indicated below in order to change path information to the path that corresponds to the current installation:

  /htdocs/lildbi/lildbi.def.php
  /htdocs/lildbi/iah/iah.def.php
  /htdocs/lildbi/iah/edit/iah.def.php
  /htdocs/lildbi/decs/decsserver.def.php
  /htdocs/lildbi/docsonline/pft/cipar.pft

See the example below: If LILDBI-Web is being installed below /home/bireme, then you should replace in the files listed above all paths containing /bvs-site/ with /home/bireme/.

  [PATH]
  PATH_DATA=/lildbi/
  PATH_CGI-BIN=/bvs-site/cgi-bin/lildbi/
  PATH_DATABASE=/bvs-site/bases/lildbi/

  [PATH] - installed
  PATH_DATA=/lildbi/
  PATH_CGI-BIN=/home/bireme/cgi-bin/lildbi/
  PATH_DATABASE=/home/bireme/bases/lildbi/

After these changes have been made to the files the application is set and ready to run. In order to access the application, open an internet browser (such as Internet Explorer, firefox and so on) and use the URL defined during web server installation by adding /lildbi/index_en.htm

  e.g.:     http://localhost/lildbi/index.html

In case of doubts or problems send a mail to:

  bvs.technical.support@listas.bireme.br

Windows

Steps to install LILDBI-Web 1.7a on Windows

Pre-requirements

A. Hardware and software

   1. a web server installed (*);
   2. the PHP (**) installed and set with the web server;
   (*)  We recommend using Apache 2.2.x
   (**) We recommend using PHP 5.3.xx

Doubts can be directed to the address below, under Pre-required software:

-  http://bvsmodelo.bvsalud.org/ 

B. Advanced technical knowledge

   1. on Linux operating system;
   2. on network configuration and management;
   3. on web server configuration;
   4. on application software installation.

Reference:

- PHP:       http://www.php.net/             
- Apache:    http://www.apache.org/            

Download Versões Recomendadas:

- PHP 5.3.0 http://museum.php.net/php5/
- Apache    http://archive.apache.org/dist/httpd/binaries/linux/

Installing

  I - Installing Lildbi-web (default)
 II - Installing Lildbi-web through a VirtualHost previously set on a web server 
III - Installing manualy in case of PHP configuration error or data access error

I - Installing Lildbi-web (default)

This procedure is the default one for users without expertise on installing and configuring Apache and PHP

STEPS:

1. Unzip the file LILDBIWEB-windows-1.7a.zip to a temporary directory (e.g.: c:\temp). The following directory structure will be created:

  bvs-+
      |- htdocs
      |- cgi-bin
      |- bases

It is assumed a web server has been installed under c:\Program Files\Apache\.

In that directory create a directory named bases, c:\Program Files\Apache\bases\

Then, move the cursor to the directory where the LILDBI-Web was unpacked, in this example we used the directory c:\temp\

Copy all files and directories (recursivelly) from c:\temp\bvs\htdocs\ to c:\Program Files\Apache\htdocs\

Repeat the copy process with the directory c:\temp\bvs\cgi-bin\ to the directory c:\Program Files\Apache\cgi-bin\

Repeat the copy process with the directory c:\temp\bvs\bases\ to the directory c:\Program Files\Apache\bases\

2. Access the system setup page through an internet browser (Internet Explorer, Firefox and so on), by adding /lildbi/install/setup.php to the base URL and follow the steps described to setup the system on the server. During setup it is required the web user to have full rights in htdocs directory (read, write and execute). After setting up, check permissions according to LILDBI-WEB-protecao-etapa3

   e.g.:     http://localhost/lildbi/install/setup.php

3. Access the LILDBI-Web administration site by adding /lildbi/index_en.htm and then clicking on Database administration.

  e.g.:     http://localhost/lildbi/index_en.htm

4. Access the LILDBI-Web site URL by adding /lildbi/index.htm and then clicking on "Search"

  ex:     http://localhost/lildbi/index_en.htm

II - Installing Lildbi-web through a VirtualHost previously set on a web server

One can set a VirtualHost on the web server using any desired directory structure, therefore the example will use the structure adopted by BIREME to its applications.

STEPS:

1. Unzip the file LILDBIWEB-windows-1.7a.zip to a temporary directory (e.g.: c:\temp). The following directory structure will be created:

  bvs-+
      |- htdocs
      |- cgi-bin
      |- bases

Open the configuration file of Apache web server (httpd-vhosts.conf) and place a VirtualHost according to your configuration.

VirtualHost sample for Apache server:

<VirtualHost localhost:80>
    DocumentRoot "/bvs/htdocs"
    Options Indexes FollowSymLinks MultiViews
    ServerName localhost
    DirectoryIndex index.htm index.php homepage.htm
    ScriptAlias /cgi-bin/ "/bvs/cgi-bin/"
    <Directory "/bvs/cgi-bin">
      AllowOverride None 
      Options FollowSymLinks
      Order allow,deny 
      Allow from all 
    </Directory>
    <Directory "/bvs/htdocs">
      AllowOverride None 
      Options All
      Order deny,allow
      Allow from all 
    </Directory>
</VirtualHost>

2. Access the system setup page through an internet browser (Internet Explorer, Firefox and so on), by adding /lildbi/install/setup.php to the base URL and follow the steps described to setup the system on the server.

  e.g.:     http://localhost/lildbi/install/setup.php

3. Access the LILDBI-Web administration site by adding /lildbi/index_en.htm and then clicking on Database administration.

  e.g.:     http://localhost/lildbi/index_en.htm

4. Access the LILDBI-Web site URL by adding /lildbi/index.htm and then clicking on "Search"

  ex:     http://localhost/lildbi/index_en.htm

III - Installing manualy in case of PHP configuration error or data access error

After unpacking and copying to the installation directory according to previous steps one must edit the files indicated below in order to change path information to the path that corresponds to the current installation:

\htdocs\lildbi\lildbi.def
\htdocs\lildbi\iah\iah.def
\htdocs\lildbi\iah\edit\iah.def
\htdocs\lildbi\decs\decsserver.def
\htdocs\lildbi\docsonline\pft\cipar.pft

Para substituir o caminho padrão do pacote para o caminho da instalação atual

See the example below: If LILDBI-Web is being installed below /home/bireme, then you should replace in the files listed above all paths containing /bvs-site/ with /home/bireme/.

[PATH]
PATH_DATA=/lildbi/
PATH_CGI-BIN=/bvs-site/cgi-bin/lildbi/
PATH_DATABASE=/bvs-site/bases/lildbi/

[PATH] - installed
PATH_DATA=/lildbi/
PATH_CGI-BIN=/home/bireme/cgi-bin/lildbi/
PATH_DATABASE=/home/bireme/bases/lildbi/

After these changes have been made to the files the application is set and ready to run. In order to access the application, open an internet browser (such as Internet Explorer, firefox and so on) and use the URL defined during web server installation by adding /lildbi/index_en.htm

  e.g.:     http://localhost/lildbi/index.html

In case of doubts or problems send a mail to:

  bvs.technical.support@listas.bireme.br

Geral

Update with the security package

LILDBI-WEB-protecao-etapa3

Update to the DeCS2010

http://productos.bvsalud.org/d-center/login.php?lang=pt&product=lildbi-web&graphic=yes

Updating DeCS databases in LILDBI-Web

Update the auxiliary databases

linux - http://productos.bvsalud.org/download/linux/upd-BVSLILACS-lin.tgz
windows - http://productos.bvsalud.org/download/windows/upd-BVSLILACS-win.zip

Updating auxiliary databases in LILDBI-Web

Spanish

Instalando el LILDBI-Web
Actualizando bases DeCS en LILDBI-Web
Actualizando bases auxiliares en LILDBI-Web

Portuguese

Instalando LILDBI-Web
Atualizando bases DeCS no LILDBI-Web
Atualizando bases auxiliares no LILDBI-Web