2017 © Pedro Peláez
 

tao-extension extension-tao-offline

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

image

oat-sa/extension-tao-offline

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  • Friday, July 27, 2018
  • by oat-lionel
  • Repository
  • 20 Watchers
  • 0 Stars
  • 84 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 8 Versions
  • 0 % Grown

The README.md

TAO Offline Extension

TAO Logo, (*1)

GitHub GitHub release GitHub commit activity, (*2)

TAO Offline Capability offers schools the possibility to take assessments in environments with unstable internet connections. It uses Virtual Machines (VM) and a Central Server (CS). The assessment is performed on the VMs that contain a TAO installation as well as the tests. At the end the results of the test will be synchronized with the Central Server., (*3)

Installation instructions

These instructions assume that you already have a TAO installation on your system. If you don't, go to package/tao and follow the installation instructions., (*4)

Add the extension to your TAO composer and to the autoloader:, (*5)

composer require oat-sa/extension-tao-offline

Install the extension on the CLI from the project root:, (*6)

Linux:, (*7)

sudo php tao/scripts/installExtension oat-sa/extension-tao-offline

Windows:, (*8)

php tao\scripts\installExtension oat-sa/extension-tao-offline

As a system administrator you can also install it through the TAO Extension Manager: - Settings (the gears on the right-hand side of the menu) -> Extension manager - Select taoOffline on the right-hand side, check the box and hit install, (*9)

Synchronization and Encryption

Synchronization

The synchronization process is based upon two actors, the Client Server, which is installed on a Virtual Machine, and the Central Server., (*10)

Setting up the Client Server

The following script needs to be run on a TAO instance in order to create a Client Server:, (*11)

sudo -u www-data php index.php '\oat\taoOffline\scripts\tools\setup\SetupClientServer'

On systems where extension-tao-encryption is installed, the script will set it up with encryption., (*12)

Point the instance to a specific server by executing the following command:, (*13)

shell sudo -u www-data php index.php '\oat\taoSync\scripts\tool\RegisterHandShakeRootURL' --rootUrl=http://tao-central.dev/, (*14)

Setting up the Central Server

Run the following to turn a TAO instance into a Central Server., (*15)

sudo -u www-data php index.php 'oat\taoOffline\scripts\tools\setup\SetupCentralServer'

Again, instances with taoEncryption will benefit from encryption., (*16)

Types of available synchronizations

  • Central Server to VM
    • Test Centers
    • Users
    • Deliveries
    • Eligibilities
    • LTI Consumers
  • VM to Central Server
    • Test Sessions
    • Results
    • Result Logs
    • LTI Users

Overview of the workflow

Overview workflow, (*17)

Sequence Diagram

Sequence Diagram, (*18)

Synchronizing users with encryption

Every user has been assigned an application key that is used to decrypt the delivery content. Properties that are excluded from the synchronization process can be found under excludedProperties in the configuration file config/taoSync/syncService.conf.php. Properties that are encrypted are defined inside config/taoEncryption/encryptUserSyncFormatter.conf.php., (*19)

Synchronizing users, (*20)

Synchronizing deliveries with encryption

During the synchronization of the deliveries, the test package is sent to the client. The client then imports the test and generates a delivery., (*21)

Note: If you are synchronizing a delivery that already exists on the VM a new import of the test will be created., (*22)

Synchronizing Deliveries, (*23)

Synchronizing results with encryption

The chunkSize of a result is an essential configuration parameter that needs to be set in advance; the default is 10. It can be set depending on the number of variables included in a result., (*24)

If you have, for example, a test with 100 items (which means about 400 variables), the total request will contain about 4000 variables. This scenario is likely to overload the server. In this case, reducing the chunkSize to a smaller value is advised., (*25)

The statuses of a result that needs to be sent can be configured under statusExecutionsToSync in config/taoSync/resultService.conf.php. Each request to the server will include the number of results. The process will stop after all results have been sent., (*26)

Synchronizing Results, (*27)

Synchronizing results - Logs

Each result log is synchronized with the Central Server to maintain a history of the test. The number of logs sent per request is defined in the configuration inside config/taoSync/SyncDeliveryLogService.conf.php., (*28)

The Versions

27/07 2018

dev-master

9999999-dev http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

27/07 2018

dev-develop

dev-develop http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

27/07 2018

v1.1.0

1.1.0.0 http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

26/07 2018

dev-release-1.1.0

dev-release-1.1.0 http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

18/07 2018

v0.3.0

0.3.0.0 http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

13/07 2018

v0.2.0

0.2.0.0 http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

15/06 2018

v0.1.1

0.1.1.0 http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment

18/05 2018

v0.1.0

0.1.0.0 http://www.taotesting.com

An extension to assist the setup of an offline context. Setup synchronisation and encryption by test center identifier

  Sources   Download

GPL-2.0

The Requires

 

tao computer-based-assessment