1 |
# $Source: /cvsroot/gnumed/gnumed/gnumed/client/doc/TODO/user-manual.txt,v $ |
2 |
# $Revision: 1.25 $ |
3 |
--------------------------------------------------- |
4 |
Rules: |
5 |
------ |
6 |
- add material for the User Manual in this text file if you |
7 |
don't want to edit the sgml code yourself |
8 |
- leave behind an email address |
9 |
- delete things if you incorporated them into the manual |
10 |
- please date it. |
11 |
Thanks |
12 |
--------------------------------------------------- |
13 |
Karsten.Hilbert@gmx.net Mit 05 Feb 2003 14:25:17 CET |
14 |
|
15 |
Belongs into Admin->Config: |
16 |
|
17 |
Upon startup the client autoconfigures the language used |
18 |
in the database. |
19 |
|
20 |
The following things influence its decision: |
21 |
|
22 |
The language is taken from the system locale in the environment |
23 |
variables checked for the GUI language by gmI18N.py. |
24 |
|
25 |
If there's no i18n_curr_lang table in the database the client |
26 |
assumes that no translations are wanted and tries to work |
27 |
without it. Same if other errors prevent normal operations - a |
28 |
warning is logged and things continue. |
29 |
|
30 |
If the language given in the database doesn't match the system |
31 |
locale the user is asked whether to update the database setting |
32 |
to that. One can influence the system locale setting in |
33 |
per-instance wrapper scripts if so desired. |
34 |
|
35 |
The database language setting is only updated if translations |
36 |
are actually available for the target language. Two levels of |
37 |
truncation of the system locale are used to find matching |
38 |
translations: |
39 |
|
40 |
1) full locale: 'de_DE@euro' |
41 |
2) no dialect: 'de_DE' |
42 |
3) no country: 'de' |
43 |
|
44 |
This allows for a missing Austrian translation to fall back to |
45 |
a general German (de_AT -> de) one, for example. |
46 |
--------------------------------------------------- |
47 |
I looked up the syntax in gmCfg.py, but could I suggest that a line be |
48 |
inserted in the bootstrap_gm-db.py file which says something like |
49 |
|
50 |
#before running this script: |
51 |
# |
52 |
#-make sure you've installed the symbolic links as listed in make-links.sh |
53 |
# you can run this by typing sh make-links.sh |
54 |
# |
55 |
#-make sure you check the section: |
56 |
#language library dirs = $language library dirs$ |
57 |
#to make sure the pathways point to the pgsql libraries |
58 |
# |
59 |
#usage : |
60 |
# python bootstrap_gm-db.py --conf-file=yourconfigfilenamehere |
61 |
# e.g bootstrap_gm-db.py --conf-file=bootstrap-standard_AU.conf |
62 |
# |
63 |
|
64 |
Anyway, I can now get up the interface at work, so perhaps having struggled |
65 |
twice to do this the third time (when I get my dead machine at home back) |
66 |
it'll be relatively easy. when I do I'll keep a line by line instruction set |
67 |
to add to the installation docs. |
68 |
|
69 |
Regards |
70 |
|
71 |
Richard |
72 |
|
73 |
|
74 |
_______________________________________________ |
75 |
Gnumed-devel mailing list |
76 |
Gnumed-devel@gnu.org |
77 |
http://mail.gnu.org/mailman/listinfo/gnumed-devel |
78 |
|
79 |
|
80 |
--------------------------------------------------- |
81 |
michael.bonert@utoronto.ca Wed Apr 2 23:21:21 EST 2003 |
82 |
ICQ ID: 97418709 |
83 |
|
84 |
GnuMed Install Instructions for Mandrake Linux 9.1 |
85 |
by Michael Bonert |
86 |
|
87 |
1. Install CVS (from the Mandrake CDs): |
88 |
cvs-1.11.5-1mdk |
89 |
|
90 |
2. Install postgresql (from the Mandrake CDs): |
91 |
postgresql-7.3.2-5mdk |
92 |
postgresql-devel-7.3.2-5mdk |
93 |
postgresql-python-7.3.2-5mdk |
94 |
postgresql-server-7.3.2-5mdk |
95 |
postgresql-pl-7.3.2-5mdk |
96 |
|
97 |
pgaccess-0.98.8.20030117-2mdk # nice to have |
98 |
postgresql-docs-7.3.2-5mdk # nice to have |
99 |
|
100 |
NOTE: If the packages all show up when you do a |
101 |
'remove software packages' (in 'mcc') they are all |
102 |
installed. |
103 |
|
104 |
3. Install wxPython -- (version used: wxPythonGTK-py2.2-2.4.0.7-1.i386.rpm) |
105 |
http://prdownloads.sourceforge.net/wxpython/wxPythonGTK-py2.2-2.4.0.7-1.i386.rpm |
106 |
|
107 |
NOTE: You should already have installed python from the Mandrake CDs. |
108 |
python-2.2.2-6mdk |
109 |
python-base-2.2.2-6mdk |
110 |
python-docs-2.2.2-6mdk # nice to have |
111 |
|
112 |
4. Install mx extenstion libraries -- (egenix-mx-base-2.0.4-py2.2_1.i386.rpm) |
113 |
http://www.egenix.com/files/python/egenix-mx-base-2.0.4-py2.2_1.i386.rpm |
114 |
|
115 |
5. Install pyPgSQL (pyPgSQL-2.3.tar.gz) |
116 |
http://sourceforge.net/project/showfiles.php?group_id=16528 |
117 |
|
118 |
Before building and installing pyPgSQL make sure you have the following |
119 |
(from the Mandrake CDs): |
120 |
libpython2.2-devel-2.2.2-6mdk |
121 |
|
122 |
$ tar zxvf pyPgSQL-2.3.tar.gz # gunzip + untar 'pyPgSQL-2.3.tar.gz' |
123 |
$ cd pypgsql |
124 |
|
125 |
Set include and library directories in "setup.py" with your favourite editor: |
126 |
--- |
127 |
# Set this to 1 if you need to use your own settings |
128 |
USE_CUSTOM = 1 # Don't forget to change this line!!! |
129 |
|
130 |
... |
131 |
|
132 |
if USE_CUSTOM: |
133 |
include_dirs = ["/usr/include/pgsql"] |
134 |
library_dirs = ["/usr/lib/pgsql"] |
135 |
--- |
136 |
$ python setup.py build |
137 |
$ python setup.py install |
138 |
|
139 |
NOTE: If the directory settings in 'setup.py' are wrong you get a misleading error about 'gcc' |
140 |
|
141 |
Testing pyPgSQL: |
142 |
$ cd test # install directory: ../pypgsql/test |
143 |
$ python PgSQLTestCases.py |
144 |
|
145 |
OUTPUT: |
146 |
.................................................................. |
147 |
---------------------------------------------------------------------- |
148 |
Ran 66 tests in 1.090s |
149 |
|
150 |
OK |
151 |
|
152 |
|
153 |
6. Get GnuMed source |
154 |
RECOMMENDATION: install gnumed in "/home/your_user_name/" |
155 |
-- where 'your_user_name' is your favourite normal user - e.g. 'michael' |
156 |
|
157 |
$ cvs -z3 -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/gnumed login |
158 |
$ cvs -z3 -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/gnumed checkout gnumed |
159 |
|
160 |
7. set 'GNUMED_DIR' variable |
161 |
$ cd # cd to home |
162 |
$ vi .bash_profile # or your favourite text editor |
163 |
|
164 |
Add the following: |
165 |
--- |
166 |
GNUMED_DIR=$GNUMED_DIR/home/your_user_name/gnumed/gnumed/client |
167 |
--- |
168 |
|
169 |
ASIDE: |
170 |
At this stage you can test the GUI with a public database. |
171 |
Email Karsten (Karsten.Hilbert@gmx.net) or Michael |
172 |
(michael.bonert@utoronto.ca) for the user name and |
173 |
password. |
174 |
|
175 |
Then... |
176 |
$ cd /home/your_user_name/gnumed/gnumed/client/wxpython |
177 |
$ python gnumed.py --debug |
178 |
A "Welcome to the" [GnuMed] window should appear. |
179 |
|
180 |
Click the "Options" button of the "Welcome to the" [GnuMed project] window |
181 |
An "Advanced login options" window should appear. |
182 |
|
183 |
Enter the following in it: |
184 |
gnumed-public (for 'database') |
185 |
anubis.homeunix.com (for 'host') |
186 |
5432 (for 'port' this should be the default) |
187 |
Click "Ok" to accept. |
188 |
|
189 |
In the "Welcome to the" [GnuMed project] window: |
190 |
enter the user name sent to you in "user" |
191 |
enter the password sent to you in "password" |
192 |
|
193 |
8. Modify postgresql.conf |
194 |
$ su |
195 |
# cd /var/lib/pgsql/data |
196 |
# vi postgresql.conf |
197 |
change '#tcpip_socket=false' to 'tcpip_socket=on' |
198 |
|
199 |
9. Modify "pg_hba.conf" found in "/var/lib/pgsql/data" |
200 |
# vi pg_hba.conf |
201 |
|
202 |
last part of our "pg_hba.conf" should look like this: |
203 |
--- |
204 |
# Using sockets credentials for improved security. Not available everywhere, |
205 |
# but works on Linux, *BSD (and probably some others) |
206 |
|
207 |
#local all all ident sameuser |
208 |
local all all trust |
209 |
host all all 127.0.0.1 255.255.255.255 trust |
210 |
--- |
211 |
|
212 |
10. Creating the database |
213 |
(see -- http://mail.gnu.org/archive/html/gnumed-devel/2003-02/msg00079.html) |
214 |
$ su root |
215 |
# passwd postgres # change password (I don't know what the default is-- |
216 |
# you'll need this password later so remember it.) |
217 |
# su postgres |
218 |
$ createuser your_user_name # in my case: "createuser michael" (answer 'y' to both questions) |
219 |
$ createuser _your_user_name # in my case: "createuser _michael" (answer 'y' to both questions) |
220 |
|
221 |
|
222 |
(as normal user) |
223 |
$ cd /home/your_user_name/gnumed/gnumed/server/bootstrap |
224 |
$ cp bootstrap-standard-AU.conf.sample your_user_name-db.conf |
225 |
$ ln -s /home/your_user_name/gnumed/gnumed/client/python-common modules |
226 |
$ ln -s /home/your_user_name/gnumed/gnumed/server/sql/ sql |
227 |
|
228 |
At this point you may want to confirm that postgresql is running: |
229 |
$ mcc |
230 |
click on 'System' |
231 |
click on 'DrakXServices...' |
232 |
'postgresql' should say 'running' |
233 |
|
234 |
$ python bootstrap-gm_db_system.py --conf-file=your_user_name-db.conf |
235 |
When prompted: |
236 |
- yes |
237 |
- give password |
238 |
- give another password |
239 |
|
240 |
|
241 |
NOTE 1: If you have problems the log file is in: "/home/your_user_name/.bootstrap-gm_db_system" |
242 |
NOTE 2: Make sure you have a current version of the code from the CVS |
243 |
NOTE 3: If bootstrapping fails it is a good idea to drop the gnumed database before trying again |
244 |
$ dropdb gnumed |
245 |
|
246 |
----- |
247 |
If you're still have problems bootstrapping: |
248 |
|
249 |
Capture the screen output from bootstrap: |
250 |
$ script -a bootstrapping.log # opens a log file to capture output to display |
251 |
$ python bootstrap-gm_db_system.py --conf-file=your_user_name-db.conf |
252 |
$ exit # closes 'script' session |
253 |
|
254 |
Send Karsten (Karsten.Hilbert@gmx.net) the follow files: |
255 |
- bootstrapping.log (in "/home/your_user_name/gnumed/gnumed/server/bootstrap") |
256 |
- bootstrap-gm_db_system.log (in "/home/your_user_name/.bootstrap-gm_db_system") |
257 |
|
258 |
----- |
259 |
Running GnuMed with a local database: |
260 |
$ cd /home/your_user_name/gnumed/gnumed/client/wxpython |
261 |
$ python gnumed.py --debug |
262 |
A "Welcome to the" [GnuMed] window should appear. |
263 |
in "user" enter: your_user_name |
264 |
the password: (leave blank) |
265 |
|
266 |
If you haven't started gnumed with another database |
267 |
GnuMed will start with the following backend defaults: |
268 |
gnumed (for 'database') |
269 |
127.0.0.1 (for 'host') |
270 |
5432 (for 'port') |
271 |
|
272 |
Find something you don't like and fix it... ;O) |
273 |
|
274 |
-------------------------------------------------- |