Overview

NOTE: The Item Scoring component is typically deployed to the same application server that hosts the Student and Proctor applications. That is, a single AWS instance will host the Student and Proctor applications.

Instructions - Deploy Item Scoring to AWS Instance That Already Hosts Student and Proctor

Deploy the Item Scoring Component

Create Log Directory

• Create a directory for the Item Scoring component’s log file(s):
  • sudo mkdir -p /usr/share/tomcat7/logs/itemscoring/
  • sudo chown tomcat7:tomcat7 /usr/share/tomcat7/logs/itemscoring/
  • OPTIONAL: Create links in the Tomcat log directory to the Web Application log file:
    • sudo ln -s /usr/share/tomcat7/logs/itemscoring/itemscoring.log /var/lib/tomcat7/logs/itemscoring.log

Deploy the Item Scoring Component

• Stop the Tomcat server:
  • sudo service tomcat7 stop
• Download the latest .war file for the Item Scoring Component into the Tomcat server’s webapps directory:
  • sudo wget https://github.com/SmarterApp/TDS_ItemScoring/releases/download/1.1.0/item-scoring-service-1.1.0.war -O var/lib/tomcat7/webapps/itemscoring.war

Update Item Scoring Configuration in the Itembank Database

• Connect to the MySQL server that supports the TDS Components
• Execute the following SQL statements:

SET SQL_SAFE_UPDATES = 0;
START TRANSACTION;
UPDATE configs.client_itemscoringconfig
SET serverurl = 'http://localhost:8080/itemscoring/Scoring/ItemScoring'
WHERE serverurl != 'http://localhost:8080/itemscoring/Scoring/ItemScoring';
COMMIT;
SET SQL_SAFE_UPDATES = 1;

SET SQL_SAFE_UPDATES = 0;
START TRANSACTION;
UPDATE configs.client_itemscoringconfig
SET clientname = 'SBAC_PT'
WHERE clientname = 'SBAC';
COMMIT;
SET SQL_SAFE_UPDATES = 1;

IMPORTANT: If your deployment is using an environment designation other than Development, run the UPDATE statement below

SET SQL_SAFE_UPDATES = 0;
START TRANSACTION;
UPDATE configs.client_itemscoringconfig
SET environment = '[name of environment set in the progman.locator of JAVA_OPTS contained within the /etc/default/tomcat7 file.]';
COMMIT;
SET SQL_SAFE_UPDATES = 1;

• Example:

SET SQL_SAFE_UPDATES = 0;
START TRANSACTION;
UPDATE configs.client_itemscoringconfig
SET environment = 'Staging';
COMMIT;
SET SQL_SAFE_UPDATES = 1;

• Start Tomcat:
  • sudo service tomcat7 start

back to Deployment Checklists