Pre-1.3.1 Installation

ATutor Installer is Available! The installation instructions below are obsolete with the introduction of the ATutor Installer available in versions 1.3.1 and later.

Linux/Unix Systems

Speedy Instructions

  1. tar -zxvf ATutor-x.x.x.tar.gz (unpack into a Web accessible, PHP enabled directory)
  2. cd ATutor/ (enter the directory created)
  3. chown -R nobody:nobody content (recommended, so instructors can upload files)
    or chmod -R a+rwx content (less secure)
  4. cd include/db/
  5. mysqladmin -u username -p create atutor (create an empty db called "atutor")
  6. mysql -u username -p atutor < atutor_schema.sql to create the database tables.
  7. cd .. (enter the parent ./include/ directory)
  8. vi config.inc.php (set a few variables to match your system)
    Edit DB_USER, DB_PASSWORD, DB_HOST, DB_NAME, ADMIN_EMAIL, and ADMIN_PASSWORD to suit your environment.
  9. In a web browser login to ATutor with the user "instructor" and password "instructor" (e.g. http://www.your_site.edu/ATutor)(admin:admin for pre 1.3)
  10. Administrative access with login "admin" and the password you defined in config.inc.php (e.g. http://www.your_site.edu/path_to_atutor/users/admin.php)

Detailed Instructions

  1. Untar the ATutor distribution from within the directory in which you would like it to reside:

    tar -zxvf ATutor-x.x.x.tar.gz
  2. Move into the directory created with cd ATutor,and change the owner of the ./content directory to the webserver user:

    chown -R nobody:nobody content (assuming the webserver is being run as nobody)

    Important: If you do not have the permissions needed to change that directory then you can execute chmod -R a+rwx content instead, but it is less secure. If the correct permissions are not set on the ./content directory a number of ATutor features will not work.
  3. Enter the directory created during the unpacking and open the file ./include/config.inc.php in your favourite plain text editor. Change the corresponding values to fit your environment. Values are inserted between the single quotes.

    Have a look at the Configuration section for an explanation of all values.
  4. Create the database named in config.inc.php (Default: atutor).
    [If a database already exists that you would like to use, then you can skip this step]

    mysqladmin -u username -p create atutor (replace username with your MySQL user that has permissions to create databases).

    OR

    mysql -u username -p (Login into MySQL).

    create database atutor; (Create the atutor database as a regular mysql user, if your ISP allows it.)

    [If you are unable to create the database yourself, ask your ISP to create it for you, then carry on to the next step.]
  5. Use the SQL file in ./include/db/atutor_schema.sql to create the required tables. Either execute the file by copy and pasting it into an application like phpMyAdmin, or by using the method below. If your system adminstrator has setup an empty "atutor" database for you, you can populate the database from the shell command line with:

    mysql -u username -p atutor < ./include/db/atutor_schema.sql

  6. Login to your ATutor course server with the default user instructor and the default password instructor(admin:admin for pre 1.3). That account is the default Instructor account created during installation.

    http://www.your_site.edu/path_to_ATutor/

  7. As the ATutor Administrator (login: admin -- password: the one defined in config.inc.php) you can manage users, course properties, language, and statistics. Access your admin tools at:

    http://www.your_site.edu/path_to_ATutor/users/admin.php

  8. See the ATutor HowTo course for more documentation.

Upgrade Instructions

Upgrading ATutor is possible from one stable release to another.

[WARNING: Upgrading will replace the English language of your system so any changes made will be lost. Upgrading will also delete languages other than English. Do not upgrade your system until the appropriate language pack is available for the version you are upgrading to. If a language pack is not yet available for your chosen language, you might volunteer to complete the translation. Visit the ATutor Translation site to register as a translator. http://www.atutor.ca/atutor/translate/ ]

  1. Download the latest ATutor distribution and place it in the parent directory for your ATutor installation (i.e. the directory above ATutor).
  2. You are advised to backup your ATutor database at this time using any method possible. We recommend using phpMyAdmin or using mysqlhotcopy, which comes with MySQL.
  3. mv ATutor ATutor_old Move the current installation as a backup.
  4. tar -zxvf ATutor-X.X.X.tar.gz Unpack the latest ATutor distribution.
  5. cp -R ATutor_old/content/* ATutor/content/ Copy the current course contents to the new installation.
  6. vi ./ATutor/include/config.inc.php Update the new config.inc.php file with your existing settings from the old version you saved in Step 1. (Do not replace the new file with the old one, since new variables may be introduced in newer versions of the file.)
  7. mysql -u adminuser -p atutor < ./include/db/atutor_upgrade_x.x_to_y.y.sql As the MySQL user that has alter permissions on your ATutor database, run the update script named from version "x.x" to version "y.y". Run each of the update scripts between the version you are upgrading from, and the version you are upgrading to, in their consecutive order.

Windows Systems

Follow the instructions below if you are installing ATutor on a Windows system

  1. Untar and ungzip the archive. You can use either WinZip or WinRar to do that.
  2. Edit ./include/config.inc.php using a plain text editor.
    WARNING: When editing in some Windows text editors, an extra space gets inserted at the end of a saved file that may break the file. If after editing an ATutor file, particularly the include files, seemingly inexplicable errors are generated, try deleting the trailing space in the files you've edited. To avoid this problem, set you text editor to use UNIX end of line characters instead of Windows EOLs.
  3. Create the database named in config.inc.php (Default: atutor).
    [If a database already exists that you would like to use, then you can skip this step]

    mysqladmin -u username -p create atutor (replace username with your MySQL user that has permissions to create databases).

  4. Use the SQL file in ./include/db/atutor_schema.sql to create the required tables. Either execute the file by copy and pasting it or by using the method below. If the system adminstrator has setup an empty "atutor" database for you, you can populate the database from the shell command line with:

    mysql -u username -p atutor < ./include/db/atutor_schema.sql

  5. Login to your ATutor course server with the default user instructor and the default password instructor (admin:admin for pre 1.3). That account is the default account that is created upon installation.

    http://www.your_site.edu/path_to_ATutor/

  6. As the ATutor system admin (the one you defined in config.inc.php) you can view the ATutor system user list, and update user status' when instructor account requests are made. Access your admin tools at:

    http://www.your_site.edu/path_to_ATutor/users/admin.php

  7. See the ATutor HowTo course for more documentation.