The individual configuring the IntelliBoard connection must be a Site Administrator of Moodle with the ability to enable web services, change web protocols, and create Moodle tokens.
Before you get started...
- You must have an IntelliBoard account and have the IntelliData plugin installed.
- Additional details on plugin installation and initial connection may be found here.
- IntelliBoard is a web-based service. If your LMS is behind a firewall, a port will need to be configured for the IntelliBoard service to connect. Contact helpdesk@intelliboard.net for additional details.
- The IntelliData plugin will only migrate data from Moodle plugins that use XMLDB. Additional information maybe found here.
General Overview
IntelliBoard Pro leverages a standard Moodle Plugin to create a table structure that then processes Moodle data on a regular schedule into IntelliBoard Pro's unified and dynamic tables. Before a the LMS data can be processed automatically by the connection, the must go through an initial migration.
When should I complete the migration process?
- Initial Connection: The migration must be complete after you make the initial connection and before your first processing.
- Plugin Update: Restart the migration process each time you update the IntelliData plugin.
- Filter Changes: When you change or add data through additional filters, restart the migration process.
How long does the Migration process take?
Initial migrations may take between 1 - 3 days depending on the size of your LMS database. LMS databases that have more than 200 GB of data may take up to 7 days with the default settings. The number of rows to be migrated and the cron schedule may be updated to speed up the migration process.
Step 1: Trigger Migrations from IntelliData Plugin
After initial plugin install and connection, you will trigger the migration:
1) Via Command Line directly on the Server or 2) Via Cron Tasks within the LMS
1: Via Command Line on the Server:
Please run the following commands. Note that this is a faster way to complete the task, but will have an impact on server load.
cd public_html/local/intellidata/cli
php migration_process.php
php export_process.php
2: Via Cron Tasks within the LMS
Site Admin > Plugins > Local Plugins > IntelliData > General
Pathway: admin/settings.php?section=local_intellidata
From General, please review, update and save:
| 1 | Migration Processing Limit | Default: 100,000 |
| 2 | Migration Processing Limit Write to Temp File | Default: 10,000 |
| 3 | Export file during migration | Default: Yes; keep this setting enabled |
| 4 | Reset Migration Process | Default: No; In this action, click to enable |
Required Actions:
- Change Migration Processing Limits if desired.
- Enable Export file during migration
- Enable Reset Migration
- Click Save.
Step 2: Enable Migrations from IntelliData Plugin
Site Admin > Plugins > Local Plugins > IntelliData > Migration
Pathway: /local/intellidata/migrations/index.php
Please click "Enable Migration" in the top right corner.
You can monitor the migration process from the Migrations page.
After the migration task is enabled, it may take between 1 and 3 days to make your initial migration, depending on the size of your LMS database. For clients who have more than 200 GB of data, the migration may extend up to 7 days. Changing the migration limits and cron schedule may speed up or slow down the migration process.
Step 3: Review Migration Cron Task (Optional)
Site Admin > Severs > Tasks > Scheduled Tasks
Pathway: /admin/tool/task/scheduledtasks.php
Search: IntelliData
After enabling "Reset Migration Process" in the step above, the Migration Task will be enabled.
After disabling "Export file during migration" in the step above, the Export Task will be disabled.
Note: You may edit the cron schedule to your desired limits.
How can I monitor the process to ensure it's successful?
You can monitor the process from the following pages:
Site Admin > Plugins > Local Plugins > IntelliData > Migration
Pathway: /local/intellidata/migrations/index.php
Expected behavior is that the Status column reads "Completed" or "In Process". The goal is to have all tables read Completed.
Site Admin > Severs > Tasks > Scheduled Tasks
Pathway: /admin/tool/task/scheduledtasks.php
Search: IntelliData
Review: Migration Task
Click on the "Logs" view
Pathway: /admin/tasklogs.php?filter=local_intellidata%5Ctask%5Cmigration_task
Review the logs for any failed attempts.
If you feel the Migration task has stopped or you wish to speed up the Migration task, please contact helpdesk@IntelliBoard.net
Do I need to change any settings or manually process the data after the migration completes?
No, this will happen automatically. The migration task will automatically become disabled and the export setting will re-enable. When the migration is complete, the data will begin processing every 24 hours.
For additional assistance, please email helpdesk@IntelliBoard.net.