/[gnumed]/gnumed/gnumed/client/doc/TODO/user-manual.txt
ViewVC logotype

Contents of /gnumed/gnumed/client/doc/TODO/user-manual.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.27 - (show annotations) (download)
Thu Apr 3 04:37:15 2003 UTC (21 years ago) by michaelb
Branch: MAIN
Changes since 1.26: +8 -3 lines
File MIME type: text/plain
mdk9.1 install guide revisions - links to RPMs added

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 --------------------------------------------------

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26