Release 5.0.0

[vinayvenu]

Refer Release Documentation: https://avni.readme.io/docs/release-process-for-the-cloud

Components to release

• avni-server (Note special instructions below)
• rules-server (only build artifact related changes in 5.0)
• integration-service and integration-admin-app (Will be handled by Himesh)
• avni-etl (Note special instructions below)
• avni-media (already deployed on Oct 3)
• avni-client (versionCode=50000, versionName=5.0.0), upload prod aab to open testing track
• avni-webapp

For each component

• tag latest commit used for release as v5.0.0 and auto-generate release notes
• Take backup of logs where applicable like avni-server - Important
• Deploy/build from circle-ci (perform special instructions below if any)
• Merge branchcode to main/master

avni-server

Pre-deployment

1. Create blacklist file at path /etc/openchs/avni_blacklisted_urls.json with the following content

["/profile/**", "/manifest.json"]

2. make sure the following lines are present in /etc/openchs/openchs.conf

export OPENCHS_CSP_ENABLED=false
# following line is commented on purpose. Uncomment it when enabling CSP above.
# export OPENCHS_CSP_ALLOWED_HOSTS="cognito-idp.ap-south-1.amazonaws.com ap-south-1.amazonaws.com prod-user-media.s3.ap-south-1.amazonaws.com"
export AVNI_ENHANCED_VALIDATION=true
export AVNI_CSRF_ENABLED=false
# commented below line because all request (mostly from avni client and integration service) were getting rejected
#export AVNI_WEB_VALIDHOSTS=app.avniproject.org 
export AVNI_BLACKLISTED_URLS_FILE=/etc/openchs/avni_blacklisted_urls.json

3. Run SQL#8 here - group_subject information doesn't sync to the user's device when direct assignment is ON avni-client#1058 (comment)

Post-deployment

1. (Not critical to release) Restore /ping as the load balancer target group health check url. It was set to /idp-details to fix an issue in a previous release.
2. Run the SQL#8 and SQL#7 here - group_subject information doesn't sync to the user's device when direct assignment is ON avni-client#1058 (comment)
3. Fix the rules - change to params.formElement from formElement - There are a few occurrences that need to be fixed manually.
   select o.name, form_element.group_id from form_element
   join organisation o on form_element.organisation_id = o.id
   where rule not like '%params.formElement%' and rule like '%formElement%' and form_element.is_voided = false;

avni-etl

Pre-deployment
Add following entry to /etc/avni-etl-service_appserver.conf as avni-etl-user

export AVNI_MEDIA_SERVER_DOWNLOAD_URL=http://localhost:3010/media-viewer/requestDownload

NOTE : If avni-media service is hosted on the same machine as the etl service, then <env-integration-server> = http://localhost:3010 else <env-integration-server> = https://int-<avnienv>.avniproject.org

• The above configuration is needed for ETL server to create a download job on media-server for all media matching a search filter

Remaining steps

• Inform in channel
• Release notes
• Blog
• Email
• Close all released issues in github if not closed yet
• Move avni-client aab to prod

[mahalakshme]

@1t5j0y
To the questions:AVNI_CSRF_ENABLED should be set to false so that users with older versions can continue using the app

[himeshr]

Additionally configure AVNI_WEBAPP_TIMEOUT to increase timeouts to 30 days.
export AVNI_WEBAPP_TIMEOUT=21600

[himeshr]

Merged 5.0 branch of avni-client to master to ensure last few patch commits are also pushed to master.