Page 1

A TOOL FOR ENHANCING ASSESSMENT AND LEARNING IN FOUNDATION PHASE

TARMII 3.0

Technical Document

Page 2

TARMII Installation and

Administration Manual v 1.0

Page 3

Introduction This document serves to guide and inform the System Engineer on the technical specifications and

processes that was followed in setting up and preparing the platforms for TARMII 3.0

Section 1: Server Roles

1. Go to the Server Manager Dashboard and Add Server Roles and Features

Page 4

Page 5

Page 6

Section 2: Installation of Web Platform 2. Go to the IIS management console and install the Web Platform Installer

3. Install WFastCGI 2.1 Gateway for IIS and Python 2.7.9 using Web Platform Installer

Page 7

4. Install Microsft Visual C++ 2013 Redistributle (required by MySQL Workbench).

Location: http://public.upfronthosting.co.za/tarmii/vcredist_x86.exe

5. Install Visual C For Python 2.7.

Location: http://public.upfronthosting.co.za/tarmii/VCForPython27.msi

6. Install MySQL components (Server, Workbench, Python Connector)

Location: http://public.upfronthosting.co.za/tarmii/mysql-installer-community-5.7.14.0.msi

Page 8

7. Download tarmii.sql from http://public.upfronthosting.co.za/tarmii/tarmii.sql and place it

inside your Downloads folder.

8. Import the database using MySQL Workbench

Page 9

Add the TARMII database user in mysql workbench

1. Go to Users and Privileges and click on “Add Account”

2. Complete the details on the “Login” tab

3. Next, go to “Schema Privileges” and click on “Add Entry”. Select “tarmii” next to

“Selected schema” and click “OK”.

Page 10

4. Click “Select ALL” to assign the necessary rights to the user. Click on “Apply”.

9. Install MySQL for Python from http://public.upfronthosting.co.za/tarmii/MySQL-python-

1.2.5.win32-py2.7.exe

10. Install virtualenv for Python. Open up the command prompt and type the following:

c:\> cd c:\Python27

c:\Python27> Scripts\easy_install.exe virtualenv

11. Download the tarmii application from http://public.upfronthosting.co.za/tarmii/tarmii.zip

and extract tarmii.zip to c:\tarmii

12. Create virtualenv for TARMII. Open up the command prompt and type the following:

cd c:\tarmii

c:\tarmii>c:\Python27\Scripts\virtualenv --system-site-packages .

(note the dot at the end of the above line)

Page 11

13. Install TARMII dependencies. Open up the command prompt and type the following:

c:\tarmii>Scripts\pip.exe install -e src\tarmii.app

14. Configure sqlalchemy.url in local.ini. Open c:\tarmii\local.ini in a text editor and set up the

database url by assigning it to sqlaclhemy.url.

15. Keep local.ini open in the text editor and set up the smtp server by completing the lines for

mail.host and mail.port

16. Configure domain name in c:\tarmii\theme\app\js\config.js

Page 12

17. Configure WFastCGI handlers in IIS. Open the IIS Management Console and select the

server. Open FastCGI settings. Click on Add Application and fill in

C:\Python27\python.exe as “Full Path” and C:\Python27\Scripts\wfastcgi.py as

“Arguments”. Click on “OK” to save it.

18. Stay inside the IIS Management Console and go to the Default Web Site. Click on Basic

Settings and edit the physcial path of the site. Change it to C:\tarmii\theme and click OK.

Page 13

19. Next, click on Handler Mappings and click on Add Module Mapping. Complete as per

the screenshot below. Click on Request Restrictions and uncheck the option labeled

Invoke handler only if request is mapped to: Click OK to close Request Restrictions.

Click OK again to add the module mapping

Request path: /api/*

Module: FastCgiModule

Executable: C:\Python27\python.exe|C:\Python27\Script\wfastcgi.py

Name: Python FastCGI

20. Go to Configuration Editor for the Default Web Site. Open the appSettings section and

open (Collection). Add the following keys and values:

WSGI_HANDLER: wsgi.app

WSGI_LOG: c:\tarmii\wsgi.log

PYTHONPATH: c:\tarmii

PYTHON_EGG_CACHE c:\tarmii\eggs

21. Go the server in the IIS management console and restart it. Test your application at the

domain name as per your configuration in step 17 to verify that the application is working.