For Teachers and Admins
Architecture Migration Guide
Vocareum has released an updated architecture for courses that provides increased stability as well as new lab types and features.
While the older Elite architecture will continue to be supported for our current customers and will receive maintenance, all active development and innovation is now focused on the new architecture.
Migrating courses from Elite to the new architecture is highly recommended to ensure the best experience in Vocareum. New architecture courses also have access to the latest features, including AI-enabled teaching and learning.
This guide will walk you through basic steps for migrating a Vocareum course to new architecture. Please feel welcome to reach out to support@vocareum.com for additional help with the process.
NOTE: The architecture of a course cannot be changed after the course is created.
Basic Migration Steps
To migrate assignments from Elite architecture to new architecture:
Create a Vocareum course using the new “Container” architecture.
In the new course, navigate to the Edit Assignments page.
Select the Copy Assignment option.
Copy assignments from your Elite Architecture course into the new course.
For each copied assignment part where Python Jupyter Notebooks are used:
Open the assignment part using Configure Workspace.
In the lower right corner of the workspace, open the Kernel menu.
Change the kernel to a supported Python kernel option (the Elite architecture kernel, Python 3.8, is not supported for new architecture labs).
Click the Publish Notebook button to persist the updated kernel.
Test the learning activities to ensure all code is compatible with the update package versions in the new environment.
Automatic File Tree Mapping
Vocareum Notebook has a simplified file tree structure from the one used in Elite labs. You can find more details on the new structure here: Navigating the Vocareum Files Browser.
When an assignment is copied from Elite architecture to the new architecture, the lab type is automatically changed to Vocareum Notebook. Existing files are moved to the equivalent folders in the new architecture as outlined in the following table.
Elite Architecture File Path | Modern Architecture File Path |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*Any content in the /resource/asnlib/public folder that is not contained in the docs folder will not be automatically migrated to the new architecture.
**Everything in asnlib folder will be automatically migrated to the new /voc /private folder, except the public, publicdata, and solution folders. Those 3 folders will be migrated to different locations (see the table for details).
***The /voc/solution folder is only shown in the file tree when it has contents.
Script Support
In order to reduce complexity, the new architecture supports fewer scripts than the Elite architecture.
Using the Copy Assignment will copy all existing script files from the Elite assignment to the new architecture copy; however, in the new architecture, only the supported scripts will actually be run.
Scripts in Elite arch architecture:
build
generate
grade
run
submit
Scripts in the new architecture:
grade
run*
*not currently supported, but will be added in the near future.
Vocareum Notebook Resources
Once you have
Documentation from the Vocareum Help Center: