Instructor Guide

Agoge Instructor Guide

Building New Labs

  1. Select a Lab: Begin by browsing the Lab Catalog to find the lab you want to build. Once located, click "Build."

  2. Set Expiration Date: Choose an expiration date and time, ensuring it is far enough in the future for students to complete assignments, including late submissions. Avoid exceeding your lab quota by keeping the number of concurrent labs manageable.

  3. Set Maximum Participants: Specify the maximum number of students that can join the lab. If your course is integrated with an LMS (Learning Management System), select the course for the lab assignment. For LMS setup details, refer to our [LMS Integration Guide].

  4. Build the Lab: Once ready, click "Build Labs". This will take you to the lab distribution and monitoring page.

Distributing Labs

  1. Join Code Distribution: If using a join code, copy and paste it into your communication with students. Learners will immediately gain access by entering the join code and their email address.

  2. Tracking Enrollment: Once students enroll, their details will appear on your lab’s dashboard, allowing you to monitor which students have successfully accessed the lab.

  3. Student Instructions: Provide students with instructions on how to join [here].

  4. Lab Expiration Management: View expiration dates for all labs on your dashboard, and extend them if needed.

Managing Labs

  1. Accessing Active Labs: Click "Manage Labs" to view a list of all active labs. Select any lab to view its details and student activity.

  2. Expired Labs: The second tab displays expired labs. These labs are no longer active but may still have associated student assessment data.

Creating New Labs

To create a new lab, follow these steps in the Lab Catalog:

  1. Lab Summary: Provide a lab description and clear instructions. Indicate whether the lab is solo (for individual learners) or community-based (where learners are on the same network for collaborative exercises).

  2. Networks: Define which networks to include. For most labs, a single network is sufficient. Specify network ranges for server placements and whether students should monitor traffic (e.g., for networking exercises).

  3. Servers: Attach servers to the networks from the previous step. Servers can be based on default operating system images or customized for your site. Configure server settings, including:

    • Visibility (e.g., hidden servers for students to discover),

    • Network traffic permissions (e.g., blocking outbound traffic),

    • Interactive connection protocol (RDP or SSH).

  4. Web Applications: Select any existing web applications for students to interact with. This is useful for web-based labs, such as cryptography or web application attacks.

  5. Assessment: Add assessment questions for students to complete alongside their lab tasks.

  6. Review: Review and correct any errors before saving the lab configuration.

Once created, you can test the lab to ensure everything is working as expected.

Managing Servers for Labs

Each lab includes virtual servers with predefined data, applications, and configurations. You can modify these servers or create new ones to fit your lab needs:

  1. Modifying Servers: To modify a server, check it out. This builds a copy of the server, allowing you to connect via RDP or SSH for configuration changes.

  2. Check-In Server: After making changes, check the server back in to save a new image, which can be used in future labs.

  3. Start/Stop Servers: Servers can be started and stopped to manage usage. If you plan to work on a server for an extended period, stop it when not in use to reduce metered costs, and start it again when needed.