This page gathers all the informations needed to use the medAL-data web application as an administrator.
Follow these steps to reset a user's password:
Admin Corner
> Users Management
.Reset Password
.Reset
.It may happen that some users do not have two-factor authentication enabled on their account (mainly due to accounts created before the medAL-data update adding this implementation).To generate secrets for users that do not yet have two-factor authentication enabled, run:
sudo dokku enter <app_name> web php artisan 2fa:authenticate_all --send_email
, and confirm by typing yes
. Press Enter.
Users should receive their code via email.
To refresh a new two-factor authentication secret for a given user, follow these steps:
sudo dokku enter <app_name> web php artisan 2fa:reauthenticate --send_email
yes
. Press Enter.The new code should be printed, and the user should receive their new code via email.
To assign a role to a user, follow these steps:
Admin Corner
> Users Management
.Edit
.Roles
choose the role to add to the user.Update
.If you are missing permissions or if some permissions are not assigned to the right role. Or if some items are missing in the left menu. Run the command:
sudo dokku enter <app_name> web php artisan permission:fix
If for some reason you find that the algorithm used by the tablets is not up to date. Run the command:
sudo dokku enter <app_name> web php artisan HealthFacilitiesAlgo:update sudo dokku enter <app_name> web php artisan update:versions
If you spot this error in the log file, then you should run the command :
sudo dokku enter <app_name> web php artisan json:fix_created
and then reload the failed json and confirm that it is now imported with :
sudo dokku enter <app_name> web php artisan cases:reload
First we need to know why the export didn't work. For that open the log file at 03:20AM and communicate the error. To launch manually the export, run this command :
sudo dokku enter <app_name> web php artisan export:start
If you have some JSON inside the Failed Folder table, then please retrieve the error in the log file. You can search with the JSON file name. Share with us the error. When we have corrected the issue, then you can reload the failed folder with this command:
sudo dokku enter <app_name> web php artisan cases:reload
dokku postgres:enter <postgres_container_name> psql -U postgres <postgres_database_name> -c "SELECT count(*) FROM public.medical_cases where redcap=false"
More information about medAL-data environment variable
# Example to retrieve all environment variable sudo dokku config:show <app_name> # Example to retrieve CREATOR_ALGORITHM_URL environment variable sudo dokku <app_name> config:get CREATOR_ALGORITHM_URL
sudo dokku config:set <app_name> MAIL_USERNAME="exemple@mail.com" # You can also add the --no-restart flag to set STUDY_ID environment variable without restarting the app sudo dokku config:set <app_name> STUDY_ID="Dynamic Tanzania" --no-restart