Steps for installing LIS 2.4a in Linux:
-----------------------------------------------------

REQUIREMENTS:

A. Hardware and software
1. having a web server installed (*);
2. having PHP (**) installed and configured for the web server;
3. having PHP configured to use XML and XSL treatment functions (Sablotron and eXpat);

(*) Tested - Apache 1.3.xx and IIS 4/IIS 5 under Red Hat Linux 7.x and Windows 9x/NT/2000 
(**) Tested under 4.3.xx version

B. Technical skills
1. advanced knowledge of Linux operating system, configuration and network administration, web server configuration, and installation of software application;
2. basic knowledge of XML and XSL.

References:
PHP: http://www.php.net/
eXpat: http://expat.sourceforge.net/
Sablotron: http://www.gingerall.com/charlie/ga/xml/p_sab.xml
Apache: http://www.apache.org

IMPORTANT:
This software application does not run on Apache 2.x and was not tested with versions superior than 4.x dPHP.

STEPS:

1. Create the directory where you want to instal LIS

ex: mkdir myLIS

or, if you are reinstalling it, go to the directory corresponding to the installation

ex: cd /home/myLIS


2. If you are installing it, unzip the system package in the directory created in step 1

Example:
cd /home/myLIS
tar xvfzp bvsLIS-Linux-2.4a.tgz

The file tgz creates the following directory structure:
	
	lis
	
	lis/htdocs
	lis/cgi-bin
	lis/bases

If you are reinstalling it, unzip the same package with the parameters (lis/htdocs and lis/cgi-bin) and go to step 4

ex: tar xvfzp bvsLIS-Linux-2.4a.tgz lis/htdocs lis/cgi-bin


3. Configure your Web Server according to the directory structure that the command in step 2 created.
Example of VirtualHost for Apache server

	<VirtualHost *>
	
	ServerAdmin serveradmin@bvs.br
	DocumentRoot "/home/myLIS/lis/htdocs/"
	<Directory "/home/myLIS/lis/htdocs">
	Options Indexes FollowSymLinks MultiViews
	</Directory>
	ServerName myLIS.bvs.org
	DirectoryIndex index.htm index.php homepage.htm
	ScriptAlias /cgi-bin/ "/home/myLIS/lis/cgi-bin/"

	<Directory "/home/myLIS/lis/cgi-bin">
	AllowOverride None
	Options None
	Order allow,deny
	Allow from all
	</Directory>
	
	</VirtualHost>


3.1. Directories to consider when configuring the Web Server:

htdocs --> data directory (document root)
cgi-bin --> cgi script execution directory


4. Access the system setup page in a browser, entering /lis/start-up.php, the url and follow the steps described to configure the system in your server

	ex: 	http://www.myLIS.org/lis/start-up.php


5. Access the URL of LIS administration website, adding /lis/, for example:

		http://www.myLIS.org/lis/


6. Access the URL of LIS website, adding /lis-Regional/, for example:

		http://www.myLIS.org/lis-Regional/

Attention: 

To use LIS it is necessary to have a license to use WWWISIS software.

For further information on WWWISIS and about the use license, access the website:

http://productos.bvsalud.org/html/pt/home.html

or send an email to:

vendas@bireme.br


7. If you have any questions or problems, send an email to:

bvs.technical.support@bireme.br


Attachment

Steps for checking the links in the LIS database:

1. Go to the directory bases/lis/checklinks. There, you will see the checklinks base, which includes the links checked, along with the corresponding error codes (for further information, read the user manual of the checklinks program).

2. The subdirectory bases/lis/checklinks/batch includes the two programs that maintain the checklinks database:

A) resetCheckLinksDatabase.bat - restarts the checklinks database.
B) LIS-checklinks.bat - checks the links of LIS database and puts results in the checklinks base.

NOTE: Checking the links assumes that a Java virtual machine version 1.4 or superior is installed. To check the version, enter a following a command line:
	java -version

Java’s latest version can be downloaded from the website: http://www.java.sun.com