App Builder self-hosted migration
Table of Contents
About
App Builder Self-Hosted to Managed Service migration utility. This utility moves your conferencing data to the new managed service, allowing for retaining older meetings created on the self-hosted version.
Getting Started
Follow the instructions below to migrate the data from the self-hosted systems database to managed service.
Prerequisites
We use Docker to run build & ship the utility, download & install docker. The migration utility is a publicly available docker image which is available here
Pull the image
docker pull agoraapp/migration-service-client:v1.0.0
Create an env file .env with connection details
#database connection config
DB_USERNAME=postgres
DB_PASSWORD=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=core
#refer to postgres SSL Mode Descriptions (https://www.postgresql.org/docs/current/libpq-ssl.html).
DB_SSL=allow
# gRPC endpoint of migration service
SERVER_ADDRESS=migration-services-prod.rteappbuilder.com:443
#checkpoint only required for large data sets, can be ignored
CHECKPOINT_FILE=checkpoint
#generate a API key to authenticate the migration client requests.
#Open Project -> Authentication Section -> Enable Token Server -> Generate API Key
API_KEY=YOUR-API-KEY
Disable Token Server once migration process completed. Because vercel deployment will be disabled while Token Server feature enabled.
Installing
Set the config values in .env and verify before running the migration.
Run the docker image with the env file to start the migration, it should take less than 30s to complete.
docker run --env-file=.env -it agoraapp/migration-service-client:v1.0.0