Installing iHRIS 4.2: Difference between revisions
From IHRIS Wiki
(Created page with "==Linux Ubuntu Installation - 4.2 == iHRIS Installation starting version 4.2.0 will be through debian packages. ==Packages== iHRIS has been packaged using different names...") |
No edit summary |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
==Linux Ubuntu Installation - 4.2 == | ==Linux Ubuntu Installation - 4.2 == | ||
iHRIS Installation starting version 4.2.0 will be through debian packages. | iHRIS Installation starting version 4.2.0 will be through debian packages. This (<small>click URL</small>) [https://youtu.be/_tCueReOgNs Youtube Video] complements this wiki article. | ||
==Packages== | ==Packages== | ||
iHRIS has been packaged using different names | iHRIS has been packaged using different names | ||
===I2CE=== | |||
* '''i2ce''': This is the package name for I2CE core code. | |||
===iHRIS Manage=== | ===iHRIS Manage=== | ||
| Line 11: | Line 15: | ||
iHRIS Manage which is the package for managing health worker information has two packages: | iHRIS Manage which is the package for managing health worker information has two packages: | ||
* '''ihris-manage-site''': This package installs | * '''ihris-manage''': This is the base iHRIS Manage package on which all iHRIS Manage sites depend on. | ||
* '''ihris-manage-site-demo''': This | * '''ihris-manage-site''': This package installs an empty iHRIS Manage site | ||
* '''ihris-manage-site-demo''': This installs iHRIS Manage that comes bundled with testing/demo data | |||
===iHRIS Qualify=== | ===iHRIS Qualify=== | ||
| Line 18: | Line 23: | ||
iHRIS Qualify which is the package for managing registration and licensing of health workers | iHRIS Qualify which is the package for managing registration and licensing of health workers | ||
* '''ihris-qualify-site''': Package | * '''ihris-qualify''': This is the base iHRIS Qualify package on which all iHRIS Qualify sites depend on. | ||
* '''ihris-qualify-site-demo''': comes with | * '''ihris-qualify-site''': Package that installs a blank iHRIS Qualify site | ||
* '''ihris-qualify-site-demo''': package that comes with testing/demo data | |||
===iHRIS Train=== | ===iHRIS Train=== | ||
| Line 25: | Line 31: | ||
iHRIS Train: an iHRIS package for managing Pre-service and In-service trainings. | iHRIS Train: an iHRIS package for managing Pre-service and In-service trainings. | ||
* '''ihris-train-site''': | * '''ihris-train''': This is the base iHRIS Train package on which all the iHRIS Train sited depend on. | ||
* '''ihris-train-site-demo''': iHRIS Train that comes bundled with testing data | * '''ihris-train-site''': installs an empty iHRIS Train site | ||
* '''ihris-train-site-demo''': installs iHRIS Train that comes bundled with testing/demo data | |||
==Installation Steps== | ==Installation Steps== | ||
# Add the iHRIS PPA to software sources <pre>sudo add-apt-repository ppa:openhie/release</pre> | # Add the iHRIS PPA to software sources <pre>$ sudo add-apt-repository ppa:openhie/release</pre> | ||
# Update the software sources lists <pre>sudo apt-get update</pre> | # Update the software sources lists <pre>$ sudo apt-get update</pre> | ||
# Install iHRIS Packages. <pre>sudo apt-get install PACKAGE_NAME</pre> | # Install iHRIS Packages. <pre>$ sudo apt-get install PACKAGE_NAME</pre>During the installation process there will be prompts for different settings and configurations including database configurations. The details are in the section below. | ||
#* Running the command <pre>$ sudo apt-get install ihris-manage</pre> will also install i2ce, ihris-common and textlayout on which it depends | |||
#* Running the command <pre>$ sudo apt-get install ihris-manage-site-demo</pre> on a clean install (where iHRIS has never been installed before) will install i2ce, textlayout, ihris-common, ihris-manage and the ihris-manage-site-demo site. | |||
# To access the installed site open the browser and visit <pre>http://localhost/iHRIS/PACKAGENAME</pre> | # To access the installed site open the browser and visit <pre>http://localhost/iHRIS/PACKAGENAME</pre> | ||
=== | ===Configuration Prompts During Installation=== | ||
====Database==== | |||
You will be prompted to set the '''database root user password'''. This is the password you use when accessing MySQL with username root in (<code>mysql -u root -p</code>) | |||
This first prompt is for setting the password. Type the password and press Enter when you are done. | |||
[[File:Mysql_root_password.png|thumb||center||Prompt for setting MySQL Password]] | |||
Then you will be required to confirm the password. Re-type the password you typed previously. | |||
[[File:Mysql_root_password_confirm.png|thumb||center||Prompt to confirm MySQL Password]] | |||
====APCU==== | |||
In configuring APCu (which is required for caching), just leave the default values by pressing enter at the prompt. | |||
First you will be asked for compatibility | |||
[[File:Apc_compatibility_prompt.png|thumb||center||Prompt for APCu compatibility]] | |||
And then to enable Debugging. | |||
[[File:Apc_debugging_prompt.png|thumb||center||Prompt for APCu debugging]] | |||
====UUID==== | |||
When installing iHRIS sites (such ihris-manage-site, ihris-qualify-site, ihris-manage-site-demo, etc) you will be prompted for setting UUID installation directory. | |||
As said earlier, just leave the default value [autodetect] and '''press Enter''' | |||
[[File:Uuid_directory.png|thumb||center||Prompt for setting UUID installation directory]] | |||
===Installation Example=== | ===Installation Example=== | ||
====ihris-manage-site-demo==== | |||
To install a demo site for iHRIS Manage run the command below: | To install a demo site for iHRIS Manage run the command below: | ||
<pre>sudo apt-get install ihris-manage-site-demo</pre> | <pre>sudo apt-get install ihris-manage-site-demo</pre> | ||
During installation you will be asked for the password for setting up the database. | |||
[[File:Manage_demo_password_config.png|thumb||center||Prompt for setting site database]] | |||
In the first prompt you enter the '''MySQL ''root user password''''' which you set earlier for root user | |||
[[File:Manage_demo_root_passwd.png|thumb||center||Prompt for entering MySQL ''root user password'']] | |||
Then, you will have to set the password for the ''iHRIS user'' that will be administering this database. Remember, this is the password you will be using when accessing the system using the ''i2ce_admin user'' and when prompted to update the site from the browser. | |||
[[File:Ihris_manage_user_password_prompt.png|thumb||center||Prompt for setting iHRIS Manage Demo site user password]] | |||
Once the installation has finished, you can visit the site by entering the address <code>http://localhost/iHRIS/ihris-manage-site-demo</code> on the browser. | |||
[[Category:Developer Resources]] | |||
Latest revision as of 20:59, 20 August 2019
Linux Ubuntu Installation - 4.2
iHRIS Installation starting version 4.2.0 will be through debian packages. This (click URL) Youtube Video complements this wiki article.
Packages
iHRIS has been packaged using different names
I2CE
- i2ce: This is the package name for I2CE core code.
iHRIS Manage
iHRIS Manage which is the package for managing health worker information has two packages:
- ihris-manage: This is the base iHRIS Manage package on which all iHRIS Manage sites depend on.
- ihris-manage-site: This package installs an empty iHRIS Manage site
- ihris-manage-site-demo: This installs iHRIS Manage that comes bundled with testing/demo data
iHRIS Qualify
iHRIS Qualify which is the package for managing registration and licensing of health workers
- ihris-qualify: This is the base iHRIS Qualify package on which all iHRIS Qualify sites depend on.
- ihris-qualify-site: Package that installs a blank iHRIS Qualify site
- ihris-qualify-site-demo: package that comes with testing/demo data
iHRIS Train
iHRIS Train: an iHRIS package for managing Pre-service and In-service trainings.
- ihris-train: This is the base iHRIS Train package on which all the iHRIS Train sited depend on.
- ihris-train-site: installs an empty iHRIS Train site
- ihris-train-site-demo: installs iHRIS Train that comes bundled with testing/demo data
Installation Steps
- Add the iHRIS PPA to software sources
$ sudo add-apt-repository ppa:openhie/release
- Update the software sources lists
$ sudo apt-get update
- Install iHRIS Packages.
$ sudo apt-get install PACKAGE_NAME
During the installation process there will be prompts for different settings and configurations including database configurations. The details are in the section below.- Running the command
$ sudo apt-get install ihris-manage
will also install i2ce, ihris-common and textlayout on which it depends - Running the command
$ sudo apt-get install ihris-manage-site-demo
on a clean install (where iHRIS has never been installed before) will install i2ce, textlayout, ihris-common, ihris-manage and the ihris-manage-site-demo site.
- Running the command
- To access the installed site open the browser and visit
http://localhost/iHRIS/PACKAGENAME
Configuration Prompts During Installation
Database
You will be prompted to set the database root user password. This is the password you use when accessing MySQL with username root in (mysql -u root -p)
This first prompt is for setting the password. Type the password and press Enter when you are done.
Then you will be required to confirm the password. Re-type the password you typed previously.
APCU
In configuring APCu (which is required for caching), just leave the default values by pressing enter at the prompt.
First you will be asked for compatibility
And then to enable Debugging.
UUID
When installing iHRIS sites (such ihris-manage-site, ihris-qualify-site, ihris-manage-site-demo, etc) you will be prompted for setting UUID installation directory.
As said earlier, just leave the default value [autodetect] and press Enter
Installation Example
ihris-manage-site-demo
To install a demo site for iHRIS Manage run the command below:
sudo apt-get install ihris-manage-site-demo
During installation you will be asked for the password for setting up the database.
In the first prompt you enter the MySQL root user password which you set earlier for root user
Then, you will have to set the password for the iHRIS user that will be administering this database. Remember, this is the password you will be using when accessing the system using the i2ce_admin user and when prompted to update the site from the browser.
Once the installation has finished, you can visit the site by entering the address http://localhost/iHRIS/ihris-manage-site-demo on the browser.
