ASLM-LIS/BLIS-UGANDA

BLIS-uganda forked from iLabAfrica, is a port of the Basic Laboratory Information System (BLIS) to the Laravel PHP Framework by iLabAfrica. BLIS was originally developed by C4G. BLIS ===== BLIS is a port of the Basic Laboratory Information System ( BLIS ) to the Laravel PHP Framework by iLabAfrica. BLIS was originally developed by C4G. You can test and view the application here. Requirements ------------ 1. Supported database. Currently only MySQL has been tested. Laravel also supports PostgreSQL, SQLite and SQL Server. 2. PHP (>= 5.4). 3. Composer - Dependency manager for PHP. Installation ----------- ##### DOCKER The easiest way to install is using docker, follow instruction here to install via docker. ##### FROM SOURCE 1. Install the above mentioned requirements. 2. Extract this git repository to a local folder git clone git@github.com:ilabafrica/iBLIS.git 3. Change directory to the root folder of the application. Update **composer** then run it in order to install the application dependencies. You may need root permissions to update composer. composer self-update composer install 4. Update the application configuration files to suit your local settings: - Set the "Application URL" in `/app/config/app.php` - Create a database and set the database connection details in `/app/config/database.php` - The organization name in `/app/config/kblis.php` 5. Run the migrations to create the required database tables. php artisan migrate 6. Load the basic seed data php artisan db:seed If #5 or #6 above fails, you may need to run the following command then repeat the two commands again. composer dumpautoload 7. If you are running the application on a webserver eg. apache, ensure that the webserver has write permissions to the /app/storage folder. Ideally the web-root should be the /public folder. The default login credentials are '*administrator*' '*password*'. Troubleshooting ---------------- Ensure that you enable mod_rewrite, `sudo a2enmod rewrite` if you are using apache. This should solve the problem of routing failures.