Assistance Needed for Migrating Open edX Server to a New Server

Site Operators Site Operations Help
1

Dear community ,
I am currently attempting to migrate my Open edX server to a new server and have encountered challenges during the process. Despite following the recommended migration steps, the system is not functioning as expected on the new server.

Here’s a brief overview of what I’ve done so far:

  1. Stopped services on the original server using tutor local stop.
  2. Transferred the configuration, environment, and platform data using:
rsync -avr "$(tutor config printroot)/" username@new-server:/path/to/destination/
  1. Moved the data to the correct location on the new server.
  2. Started the services on the new server using tutor local start -d.

However, I am facing the following issues:

  • [Mention specific issues, e.g., MySQL container restart errors, configuration mismatches, or inability to access the LMS/CMS interface.]

Could you please provide guidance or documentation to ensure a successful migration? I am particularly looking for clarification on:

  1. Whether additional steps, such as database dumps or reconfigurations, are necessary.
  2. How to resolve issues like [mention any errors or issues observed].
  3. Any best practices for migrating an Open edX server in a Tutor-managed environment.

Your assistance would be greatly appreciated, as I aim to minimize downtime and ensure a smooth transition.

Thank you for your support. I look forward to your guidance.

Best regards,
Faisal Tufail

2

If you are using a cloud service provider like AWS and hosted the Open Edx on EC2 instance you can create an image (AMI) of the EC2 instance and restore it on a new server, all the major cloud service providers have similar features.

3

Thanks for the tip, Harout! I’m currently using Azure VMs and am looking into migrating to AWS. Your suggestion to create an AMI of the EC2 instance and then restore it on a new server seems like a great strategy. Are there any specific nuances or best practices I should be aware of when transitioning from Azure to AWS to ensure a seamless migration?

4

Try tutor local launch to apply your moved configurations/data.

How to move your openedX instance from one server to another if you using Tutor installed as pip package:

  • rsync your tutor root dir (~/.local/share/tutor by default) to new server
  • pip freeze > requirements.txt to get actual python packages from your old server
  • pip install -r requirements.txt to install the same packages on your new server (Tutor package, plugins packages, etc.), use venv
  • tutor plugins list - check that plugins the same on both servers
  • if you have custom plugins it may be necessary to rebuild docker images: tutor images build openedx mfe for example
  • and finally: tutor local launch to create and start docker containers with your config
5

@tech I haven’t migrate Open Edx from Azure to AWS before , but I think the way of creating image and then restoring isn’t straightforward since Azure and AWS use different virtualization systems.