Hey again, I suggest that I will start by editing the wikibooks because we also need a documentation for a university course quite soon.
Afterwards you tell me if it's okay like this, give me access to the repository and I translate it into RST? Best Gerald On 10/13/21 2:12 PM, Luis Falcon wrote: > Dear Gerald > > On 10/13/21 10:13, Gerald Wiese wrote: >> Hey, >> >> I was working on connecting a GNU Health HMIS node to Thalamus and it took >> me quite a lot time. I shared my suggestions >> for improvements of the documentation here: >> >> https://en.wikibooks.org/wiki/Talk:GNU_Health/Federation_Technical_Guide >> >> If desired I can make those changes on my own in wikibooks. >> > > Thank you very much for your very valuable input! Of course, we'd love > improvements in the documentation, so please > feel free to contribute updating the wiki page. > > About the venv... could you please write a dedicated section for those users > that want to use virtual environment? > This way we keep the "vanilla" installation and the virtual env. > > We're migrating the GNU Health documentation to our own portal > (www.gnuhealth.org/docs). We have done the initial > documentation for MyGNUHealth, and next will be the Hospital Management > component. > We use RST format and the versioning is done trough mercurial at our offical > GNU Health repositories in GNU Savannah. > > If you would like to work on the documentation migration for Thalamus, let us > know! > > All the best > Luis > > >> Best >> >> Gerald >> >> >> [content of the link: >> >> While trying to get Thalamus/Federation running I noticed there are some >> missing and wrong informations in the >> documentation. I suggest the following changes: >> >> - Advise to use a virtual environment. Otherwise the main server will crash >> since it uses a different version of >> werkzeug >> >> - Put "pip3 install --user thalamus" above "Initializing PostgreSQL for the >> HIS and Person Master Index" because it >> depends on files delivered during the pip installation >> >> - Add the information that the "demo directory" is where "pip3 show >> thalamus" points >> >> - Change "psql < federation_schema.sql" to "psql -d federation < >> federation_schema.sql" >> >> - In "Initializing PostgreSQL for the HIS and Person Master Index" change >> the numbering to 1,2,3 instead of 1,3,4 >> >> - The demo user/pw ITAPYT999HON:gnusolidario would also be a nice hint >> >> - I finally managed to connect over uwsgi & https (on Ubuntu), but I needed >> some more steps: >> >> sudo apt install uwsgi uwsgi-plugin-router-access uwsgi-plugin-python3 >> >> pip3 install flask-cors >> >> replace psycopg2.connect(...) by psycopg2.connect(dbname=’federation’) in >> import_pg.py and thalamus.py >> >> add lines "plugins = http,python3" and “venv = /path/venv/” to >> thalamus_uwsgi.ini >> >> ] >> >> >