Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
m (Make installation super-simple)
m (Briefer, simpler instructions)
Line 4: Line 4:
First we need to add the repository information to our apt sources.  To do this, [https://help.ubuntu.com/community/UsingTheTerminal#Starting%20a%20Terminal open a terminal] and then copy the following line to run [http://www.ihris.org/w/upload/Ihris-deb-install.txt the installation script] for iHRIS Manage.
First we need to add the repository information to our apt sources.  To do this, [https://help.ubuntu.com/community/UsingTheTerminal#Starting%20a%20Terminal open a terminal] and then copy the following line to run [http://www.ihris.org/w/upload/Ihris-deb-install.txt the installation script] for iHRIS Manage.


wget -q -O - http://www.ihris.org/w/upload/Ihris-deb-install.txt | sudo sh
1. <tt>wget -q http://www.ihris.org/w/upload/Ihris-deb-install.txt;sudo sh -e Ihris-deb-install.txt</tt>
The script will prompt to type “I UNDERSTAND” to verify that it is ok to install the iHRIS Manage Demo.  Be aware that any database named “ihris” will be dropped.  This shouldn't be a problem if this is the first time you've installed the Demo.


===After Installation===
2. After the script completes, visit <tt>http://localhost/iHRIS/Manage</tt> in your web browser.  You'll to update the site. Click “OK”.


* Visit <tt>http://localhost/iHRIS/Manage</tt>
3. When this completes, you'll get another prompt to procede to the site. Click “OK” again.
* You should have the bare-bones installation running. If you want to modify the apache setup, change <tt>/etc/apache2/conf.d/ihris-mananage.conf</tt>.


===Trying the iHRIS Manage Demo===
4. Explore!
 
If you'd like to install the complete demonstration site, you can grab the i2ce-ihris-manage-site-demo from Launchpad:
 
sudo apt-get install i2ce-ihris-manage-site-demo
 
To complete the set up, follow these steps (also in <tt>/usr/share/i2ce-ihris-manage-site-demo/README.debian</tt>):
 
1. This package expects MySQL to be installed locally by default. Verify that it is, or add the MySQL host to <tt>/etc/i2ce/ihris-manage-demo.apache</tt> as the value of the environment variable <tt>I2CE_DB_PROTOCOL</tt>.
 
For example, if your MySQL host is reachable at “mysql-host”, you would put
 
        SetEnv I2CE_DB_PROTOCOL mysql-host
 
in <tt>/etc/i2ce/ihris-manage-demo.apache</tt>.
 
2. Create the database for the iHRIS demonstration.  By default, the demo expects to use a database named “ihris” with the user “ihris” and the password “ihris”.
 
To create the database, use the following commands:
 
mysqladmin -uroot -p create ihris
echo "GRANT ALL ON ihris.* to ihris@localhost \
      IDENTIFIED BY 'ihris'" | mysql -uroot -p
 
3. Symlink <tt>/etc/i2ce/ihris-manage-demo.apache</tt> to <tt>/etc/apache2/conf</tt> and restart apache:
 
sudo ln -s /etc/i2ce/ihris-manage-demo.apache /etc/apache2/conf.d
sudo /etc/init.d/apache2 restart
 
4. Point your browser to the URL.  By default, an alias is created at http://YOUR_SERVER/ihris/manage/Demo/. If you're installing this on your local machine, then you would probably use http://127.0.0.1/ihris/manage/Demo/.
 
5. You will be prompted to update the site.  Click “OK”.
 
6. When this completes, you'll get another prompt to procede to the site.  Click “OK” again.
 
7. Explore!


[[Category:HowTo]]
[[Category:HowTo]]

Revision as of 12:32, 31 August 2009

These directions are for the stable packages. If you would like to test the experiemental packages, or modify the demo site in any way, please see Customizing Packaged iHRIS

Ubuntu and Debian

First we need to add the repository information to our apt sources. To do this, open a terminal and then copy the following line to run the installation script for iHRIS Manage.

1. wget -q http://www.ihris.org/w/upload/Ihris-deb-install.txt;sudo sh -e Ihris-deb-install.txt The script will prompt to type “I UNDERSTAND” to verify that it is ok to install the iHRIS Manage Demo. Be aware that any database named “ihris” will be dropped. This shouldn't be a problem if this is the first time you've installed the Demo.

2. After the script completes, visit http://localhost/iHRIS/Manage in your web browser. You'll to update the site. Click “OK”.

3. When this completes, you'll get another prompt to procede to the site. Click “OK” again.

4. Explore!