Versions Compared

Version Old Version 29 New Version Current
Changes made by

David Lau

David Lau

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • On NUC hardware, if there is a previous Windows install, use diskpart to clean the drive partitions.

  • Install Ubuntu Server 24.04 according to Ubuntu Server Installation.

Docker Engine

Reference: https://docsuwaterloo.dockeratlassian.comnet/enginewiki/installspaces/ubuntu/

Install Docker Engine

  • Setup Docker’s apt repository.

    Code Block
    # Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

  • Install the Docker packages.

    Code Block
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

  • Verify Docker installation.

    Code Block
    sudo docker run hello-world

Python pip

Code Block
sudo apt install python3-pip libyaml-dev

ECELI/pages/44319047848/Docker#Install-Docker-Engine

DNS

Update IPAM so that subdomains point to server.

  • Add an alias for all sub-domains to the record for the server.

    • Open the record in IPAM.

    • Click on the EDIT button.

    • Click the NEXT button until reaching the ALIASES CONFIGURATION page.

    • Enter the *. sub-domain in the Name field, including the server name. For example, *.ece-openedx-01.

    • The Domain should be set to the same as for the server. For example, eng.uwaterloo.ca.

    • The Type should be set to CNAME.

    • Click the ADD button. The new alias should appear in the list of aliases.

    • It may take about 5 minutes for the DNS changes to propagate and be accessible from your local computer.

Python pip

Code Block
sudo apt install python3-pip python3.12-venv libyaml-dev

Python venv

  • Create the Python virtual environment.

    Code Block
    python3 -m venv openedx

  • Activate the Python virtual environment.

    Code Block
    source openedx/bin/activate

Tutor

  • Install Tutor:

    Code Block
    pip install "tutor[full]"

  • Add current user to docker group:

    Code Block
    sudo usermod -aG docker $USER

  • Logout and log back in.

  • Start tutor:

    Code Block
    source openedx/bin/activate
tutor local launch

  • Enter parameters:

    Code Block
    Are you configuring a production platform? Type 'n' if you are just testing Tutor on your local computer [Y/n] 
Your website domain name for students (LMS) [www.myopenedx.com] ece-openedx-01.eng.uwaterloo.ca
Your website domain name for teachers (CMS) [studio.ece-openedx-01.eng.uwaterloo.ca] 
Your platform name/title [My Open edX] ECE Open edX dev1 
Your public contact email address [contact@ece-openedx-03.eng.uwaterloo.ca] d24lau@uwaterloo.ca
The default language code for the platform [en] 
Activate SSL/TLS certificates for HTTPS access? Important note: this will NOT work in a development environment. [y/N]

  • Test the OpenEdX LMS site.

    • Open a browser to the server address (e.g., http://ece-openedx-01.eng.uwaterloo.ca).

    • The OpenEdX welcome page should be displayed.

...

You will be asked to set the password interactively.

Creating first course

  • Go to the OpenEdX CMS site (e.g. http://ece-openedx-01.eng.uwaterloo.ca).

  • Login with the administrator account previously created.

  • Click on the New course button.

  • Enter the course information:

    • Course name: In general, use the course name from the UW Academic Calendar.

    • Organization: A short, all caps, abbreviation for the organization. For example, UW or ECE. CAUTION: The programming for this field is buggy. It interferes with the activation of the Create button. After typing in this field, use the mouse to click to the next field. Do not use the drop-down selection. Do not use the TAB key to move to the next field. Failure to follow this may result in the Create button not activating and it being impossible to click it. This requires restarting the new course creation page from scratch.

    • Course number: The course code, without spaces. For example, ECE106.

    • Course run: The year and term the course is being run. For example, 2025_1W.

  • The Create button should activate (turn dark blue). Click the Create button.