Re: [Health-dev] Thalamus/Federation documentation

[Gerald Wiese]

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