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:

1. From the home page, go to Admin Corner > Users Management.
2. Look for the desired user, and click Reset Password.
3. A popup will appear: click on Reset.
4. An email should be sent to the user to reset its password.

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:

1. Run the command:
   

   sudo dokku enter <app_name> web php artisan 2fa:reauthenticate --send_email

2. Enter the user's email address and press Enter.
3. Confirm by typing 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:

1. From the home page, go to Admin Corner > Users Management.
2. Look for the desired user, and click on Edit.
3. Under Roles choose the role to add to the user.
4. Click on 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