← Back to branch summary

~oh-dev/openhealth/phit-tools

« back to all changes in this revision

Viewing changes to ihris-suite/lib/manage/docs/first-time-setup.txt

  • Committer: litlfred at ibiblio
  • Date: 2009-10-26 13:55:16 UTC
  • Revision ID: litlfred@ibiblio.org-20091026135516-7er0260tad01febt
ihris suite updated to 4.0.1 pre-release...
follows that did not get added on the last attempt did this time... the problem is that bzr does not like to include branches in a sub-directory even if you add them in which 
  is how ihris-suite/lib/* was structed.  so i had to move ihris-suite/lib/*/.bzr to ihris-suite/lib/*/.bzr_dir to trick it
the site will now succesfully install.  have not attempted change the root drive letter yet

Show diffs side-by-side

added added

removed removed

Lines of Context:
ihris-suite/lib/manage/docs/first-time-setup.txt
 
1
 
 
2
The most up to date information can be found on our wiki:
 
3
 http://open.intrahealth.org/mediawiki/Linux_(Ubuntu)_Installation
 
4
 
 
5
= How to Get Started =
 
6
 
 
7
This documentation covers setting up iHRIS Manage for the first time
 
8
user.
 
9
 
 
10
Before getting started, you'll need to have the following installed:
 
11
 
 
12
 * Webserver (we'll use Apache)
 
13
 * MySQL
 
14
 * PHP 5 version at least 5.2
 
15
 * MDB2 from PEAR
 
16
 * MySQL driver from PEAR
 
17
 * APC from PECL
 
18
 * Mod_rewrite for Apache
 
19
 * PHP5-GD
 
20
 
 
21
 * I2CE https://launchpad.net/ihris-common
 
22
 * iHRIS Common https://launchpad.net/ihris-common
 
23
 * iHRIS Manager https://launchpad.net/ihris-manage
 
24
 * TextLayout Tools https://launchpad.net/textlayout if you want to print PDF reports
 
25
 
 
26
These instructions will cover the installation of I2CE, iHRIS Common,
 
27
and iHRIS Manage.
 
28
 
 
29
*** TODO These instructions cover development versions.  They'll be
 
30
    updated to cover the released software when that is available.
 
31
    As a result, an additional requirement at this point is the bzr
 
32
    version control command.  This can be had from
 
33
    http://bazaar-vcs.org/
 
34
 
 
35
0. Decide where you're going to install the application.  For purposes
 
36
   of these instructions we'll use “/var/www/ihris” as the
 
37
   installation location.  Also decide the URL that your users will
 
38
   use.  We'll use “http://ihris.example.com/Manage” in these
 
39
   instructions.  It is best to have only I2CE and related modules
 
40
   underneath the directory.  For example, don't put anything else
 
41
   under /var/www/ihris except the directories we give.  Otherwise,
 
42
   I2CE will search those directories for configuration files and slow
 
43
   the system down.
 
44
 
 
45
1. Fetch the three modules from Lauchpad.  In the /var/www/ihris
 
46
   directory, type:
 
47
 
 
48
    $ bzr branch lp:i2ce/3.0 I2CE
 
49
    $ bzr branch lp:ihris-common/3.0 iHRIS-common
 
50
    $ bzr branch lp:ihris-common/3.0 iHRIS-Manage
 
51
 
 
52
2. Configure Apache so that the URL you've selected points to the
 
53
   sites/Demo/pages subdirectory of the iHRIS-Manage check out.  For
 
54
   this example, we want http://ihris.example.com/Manage to point to
 
55
   /var/www/ihris/iHRIS-Manage/sites/Demo/pages/, so we add the
 
56
   following line to the end of our Apache configuration:
 
57
 
 
58
    Alias /Manage/ /var/www/ihris/iHRIS-Manage/sites/Demo/pages/
 
59
 
 
60
3. Create a Database and Database user.  Load the Database schema from
 
61
   the I2CE checkout using the file I2CE_structure.sql.
 
62
 
 
63
    $ mysqladmin -u root -p create ihris-manage
 
64
    $ *** FIXME *** Create user
 
65
    $ mysql -u ihris-user -p ihris-manage < I2CE_structure.sql
 
66
 
 
67
4. Configure the application. Copy the
 
68
   sites/Demo/pages/config.values.php to
 
69
   sites/Demo/pages/local/config.values.php and edit it with the
 
70
   values of your system.
 
71
 
 
72
5. Move the sites/Demo/pages/htaccess.TEMPLATE file to
 
73
   sites/Demo/pages/.htaccess and make sure the RewriteBase line is
 
74
   set to the correct URL.
 
75
 
 
76
   For this example, we want RewriteBase to be changed so that it
 
77
   reads:
 
78
 
 
79
    RewriteBase /Manage
 
80
 
 
81
6. *** FIXME *** Navigate your browser to the url and tail your apache
 
82
   error log.  You should see set up messages as it goes along.
 
83
   (FIXME: This should really log to the web interface.)
 
84
 
 
85
7. Log in with the username "admin" and password "admin".
 
86
 
 
87
To run the Demo of iHRIS Manage (which can easily be customized to
 
88
your particular installation) point your webserver to the
 
89
sites/Demo/pages sub-directory
 
90
 
 
91
 
 
92
= Troubleshooting =
 
93
 
 
94
“MDB2: not found”
 
95
 
 
96
    install the MDB2 MySQL module
 
97
 
 
98
“Fatal error: Call to a member function search() on a non-object in
 
99
I2CE_Config.inc.php”
 
100
 
 
101
    Clear APC cache (restart Apache)?  Make sure the MySQL schema is
 
102
    loaded.
 
103
 
 
104
"The requested URL /ihris/login was not found on this server."
 
105
 
 
106
    Make sure mod_rewrite is enabled ("sudo a2enmod rewrite" on
 
107
    Debian/Ubuntu).  Make sure the .htaccess file can add rewrite
 
108
    rules ("AllowOverride All" under a <Directory> directive in your
 
109
    httpd.conf).
 
110
 
 
111
First navigation to the URL takes forever to load
 
112
 
 
113
    Make sure that only I2CE, ihris-common, and ihris-manage exist
 
114
    underneath the ihris directory.
 
115
 
 
116
    Try clearing the config table:
 
117
 
 
118
        mysql> delete from config;