Difference between revisions of "VHL basic premises"

From Wiki.bireme.org/en
Jump to: navigation, search
m (Operating System)
m (PHP configuration)
 
(8 intermediate revisions by the same user not shown)
Line 11: Line 11:
 
All VHL model's applications, as well as their pre-required software can be hosted under Windows and Linux.
 
All VHL model's applications, as well as their pre-required software can be hosted under Windows and Linux.
  
==Acesso à internet==
+
==Internet access==
  
Para acessar uma BVS por meio de seus aplicativos já instalados, é necessário ter conexão com a internet, uma infra-estrutura de rede adequada (localização física do servidor, cabeamento de rede, configuração de drivers de rede etc) e a contratação de um serviço provedor de internet.
+
In order the VHL's applications can be accessible, it is essential to have an internet connection, all network infrastructure required (server's physical location, network cabling, net drivers well set etc), as well the hiring of an internet service provider.
  
Este passo depende diretamente do passo anterior: a instalação e configuração do sistema operacional.
+
This step depends on the previous step completely: installing and setting up the operating system.
  
==Software prerrequisito==
+
==Pre-required software==
  
'''Nota: '''Não recomendamos a utilização de pacotes de instalação como XAMPP e LAMP, pois os mesmos são destinados a ambientes de desenvolvimento e não são pré-configurados de forma segura para ambientes de produção.
+
'''Note: '''We strongly recomment NOT TO USE preinstalled packages such as XAMPP and LAMP because they are intended to be used in development environments and are not set based on a secure environment required by production servers.
  
As aplicações da BIREME são homologadas em servidor web [http://www.apache.org/ Apache] e linguagem [http://php.net/ PHP], sendo portanto necessária a correta instalação e configuração de ambos para que qualquer aplicação do modelo da BVS possa ser instalada.
+
BIREME's applications have been tested and approved to run under [http://www.apache.org/ Apache] web server and [http://www.php.net/ PHP] language, therefore being important the correct installing and setting up of both software so any VHL model application can be further installed.
  
A BIREME disponibiliza um manual de instalação e configuração destes softwares prerrequisito em suas versões homologadas. O Manual de instalação de software prerrequisito para aplicativos da BVS encontra-se disponível em[http://bvsmodelo.bvsalud.org/download/prereq/PreReq-Manual-pt.pdf português] ou [http://bvsmodelo.bvsalud.org/download/prereq/PreReq-Manual-es.pdf español].
+
BIREME makes available an installation and setting up manual of these pre-required software in its approved versions. The [http://bvsmodelo.bvsalud.org/download/prereq/PreReq-Manual-en.pdf Installation manual of pre-required software to VHL applications].
  
===Prerrequisitos específicos para o ABCD===
+
===ABCD specific requirements===
  
Para o caso especifico do [http://bvsmodelo.bvsalud.org/php/level.php?lang=pt&component=27&item=13 ABCD] consultar o Manual para instalação e configuração do software prerrequisitos disponível [http://bvsmodelo.bvsalud.org/download/abcd/manuais/Prereq_Installation_ABCD_PT.pdf neste link]
+
To the specific case of [http://bvsmodelo.bvsalud.org/php/level.php?lang=en&component=27&item=13 ABCD], please take a look at [http://bvsmodelo.bvsalud.org/download/abcd/manuais/Prereq_Installation_ABCD_EN.pdf ABCD].
  
==Domínio para acesso pelo navegador==
+
==Domain name for external browsing==
  
O nome de domínio destina-se à localização e identificação de um ou mais computadores na Internet, facilitando a memorização de seus endereços. Sem ele, teríamos de gerenciar sequências de números IPs. Para mais informações acesse [http://pt.wikipedia.org/wiki/Dom%C3%ADnio Wikipédia].
+
The domain name aims to locate and identify one or more computer over the Internet, making it easier to memorize their addresses. Without this resource we would have to manage IP sequences. For further informatio, please go to [http://en.wikipedia.org/wiki/Domain_name Domain name].
  
Para que seja possível divulgar o endereço de uma BVS, ex.: [http://brasil.bvs.br http://brasil.bvs.br], é necessário ter um domínio definido, registrado e devidamente configurado. Este processo envolve o [http://pt.wikipedia.org/wiki/Registro_de_dom%C3%ADnios registro de domínios], a configuração do servidor web e, posteriormente, sua configuração no [http://pt.wikipedia.org/wiki/DNS DNS].
+
Also, to announce and promote a VHL address, e.g.: [http://regional.bvsalud.org/php/index.php?lang=en Regional VHL], it is required to have a domain name registered and set accordingly. This process involves registering under one of the institutions that provide that service, the setting up of a web server and, lately its setting up into the [http://en.wikipedia.org/wiki/Domain_Name_System DNS] server.
  
==Configuração do PHP==
+
==PHP configuration==
  
Para confirmar se os passos anteriores foram realizados com sucesso, desenvolvemos um script PHP para apresentar as configurações do ambiente criado. Este script deve ser colocado no diretório apontado como Document Root do Servidor Web, de forma a ser acessível por uma URL como no exemplo abaixo:
+
In order to confirm the previous steps have been completed successfully, a PHP script has been created to present the current environment. This script must be placed in the Document_root of the web server to allow the script to be accessible through the URL below:
  
Supondo que o nome do script seja '''info.php'''
+
Assuming the script name be '''info.php''', therefore:
  
[http://meudominio.bvs.br/info.php http://meudominio.bvs.br/info.php]
+
[http://mydomain/info.php http://mydomain/info.php]
  
O conteúdo deste script deve ser:
+
The contents of this script must be:
  
 
  <?php phpinfo(); ?>
 
  <?php phpinfo(); ?>
  
Se a página apresentada for parecida com esta abaixo, o processo foi realizado com sucesso.
+
In case the resulting page is similar to the one showed below, the process was successfully done.
  
 +
[[File:Php.jpeg|centro]]
  
[[Arquivo:Php.jpeg|centro]]
+
===Variations in the configuration===
  
===Variações de Configuração===
+
In case the environment is intended to accomodate the installation of the '''VHL-Site''', '''DirEve''' or '''LIS''', it will be necessary to also check if both XML and XSLT modules have been installed and set within the PHP processor, as oriented in the [http://bvsmodelo.bvsalud.org/download/prereq/PreReq-Manual-en.pdf Installation manual of pre-required software to VHL applications].
  
 +
E.g.:
  
No caso da instância se destinar a instalação de '''BVS-site''', '''DirEve''' ou '''LIS''' será necessário verificar a existência dos módulos de XML e XSL junto ao PHP, como orientado no [http://bvsmodelo.bvsalud.org/download/prereq/PreReq-Manual-pt.pdf manual de software pre-requisito]. Por exemplo:
+
[[File:Xml-xsl.png|centro]]
  
 +
For most of the VHL applications, it is required to set the DNS server so the applications' domains are correctly solved. This configuration is necessary provided many of the applications do internal HTTP calls to their own addresses.
  
[[Arquivo:xml-xsl.png|centro]]
+
This setting is easily tested in the command line (DOS Prompt or Shell) of the server, using the PING command:
  
 +
$ ping mydomain
  
Para a maioria das aplicações da BVS, é necessário configurar o servidor - ou serviço de DNS - para que o mesmo saiba "resolver" o domínio das aplicações. Esta configuração é necessária porque muitas das aplicações fazem, internamente, chamadas HTTP para seu próprio endereço.
+
[[Category: Technical support]]
 
+
[[Category: VHL]]
Esta configuração é facilmente testada pelo terminal de linha de comando do próprio servidor, com o comando PING:
+
 
+
$ ping meudominio.bvs.br
+
 
+
[[Category: Suporte Técnico]]
+
[[Category: BVS]]
+

Latest revision as of 17:43, 4 May 2012

Basic premises for the hosting of a VHL site

This documento aims to describe the basic requirements for the hosting of a VHL. Hardware requirements are not included provided they depend on external factors such as: amount of installed applications, estimated amount of system users, data storage, memory and processing specific requirements.

Operating System

As any other application, it is required you have an operating system. This is the basic core for installing other software such as web server, PHP and the VHL model applications.

In BIREME, the standard operating system is OpenSUSE, a Linux flavor whose distribution is free and it has been chosen due to its stability and a broad capabality of setting up.

All VHL model's applications, as well as their pre-required software can be hosted under Windows and Linux.

Internet access

In order the VHL's applications can be accessible, it is essential to have an internet connection, all network infrastructure required (server's physical location, network cabling, net drivers well set etc), as well the hiring of an internet service provider.

This step depends on the previous step completely: installing and setting up the operating system.

Pre-required software

Note: We strongly recomment NOT TO USE preinstalled packages such as XAMPP and LAMP because they are intended to be used in development environments and are not set based on a secure environment required by production servers.

BIREME's applications have been tested and approved to run under Apache web server and PHP language, therefore being important the correct installing and setting up of both software so any VHL model application can be further installed.

BIREME makes available an installation and setting up manual of these pre-required software in its approved versions. The Installation manual of pre-required software to VHL applications.

ABCD specific requirements

To the specific case of ABCD, please take a look at ABCD.

Domain name for external browsing

The domain name aims to locate and identify one or more computer over the Internet, making it easier to memorize their addresses. Without this resource we would have to manage IP sequences. For further informatio, please go to Domain name.

Also, to announce and promote a VHL address, e.g.: Regional VHL, it is required to have a domain name registered and set accordingly. This process involves registering under one of the institutions that provide that service, the setting up of a web server and, lately its setting up into the DNS server.

PHP configuration

In order to confirm the previous steps have been completed successfully, a PHP script has been created to present the current environment. This script must be placed in the Document_root of the web server to allow the script to be accessible through the URL below:

Assuming the script name be info.php, therefore:

http://mydomain/info.php

The contents of this script must be:

<?php phpinfo(); ?>

In case the resulting page is similar to the one showed below, the process was successfully done.

centro

Variations in the configuration

In case the environment is intended to accomodate the installation of the VHL-Site, DirEve or LIS, it will be necessary to also check if both XML and XSLT modules have been installed and set within the PHP processor, as oriented in the Installation manual of pre-required software to VHL applications.

E.g.:

centro

For most of the VHL applications, it is required to set the DNS server so the applications' domains are correctly solved. This configuration is necessary provided many of the applications do internal HTTP calls to their own addresses.

This setting is easily tested in the command line (DOS Prompt or Shell) of the server, using the PING command:

$ ping mydomain