Documentation

Manual

Installing on Windows

The Triangles Rotation program runs on current Windows systems, and has been tested on various Windows XP, Windows Vista, Windows 7, Windows 8.1 and Windows 10 systems. It needs Apache, MySQL and PHP to run.

In detail, you will need:

  • Apache web server (all current versions should work)

  • PHP (supported are only version 5.2.x 32 bit and 5.3.x 32 bit or 64 bit; all other versions are not supported by our binary distribution)

  • MySQL (5.0 to 5.5 have been tested) or MariaDB (5.5 and 10.11 have been tested)

  • Some PHP modules are required, especially the modules mysql and bcompiler

  • A web browser, such as a current Chrome or Firefox

We recommend to install XAMPP, as this contains almost everything you well need in a single package. Please use version 1.7.7, as other versions might not match the requirements of the system.

XAMPP can be downloaded from sourceforge.net, we strongly recommend to use xampp-win32-1.7.7-VC9-installer.exe

Note: Versions 1.8.x and later are definitly not usable due to PHP version unsupported by us.

In addition, we will need a compatible bcompiler PHP module. A suitable one for XAMPP 1.7.7. can be downloaded from this Link.


Instructions:

  • Execute xampp-win32-1.7.7-VC9-installer.exe (preferrably as administrator)

  • Choose c:\xampp as installation directory

  • A warning message regarding a possibly restricted functionality due to an activated "User Account Control (UAC)" that might be generated by XAMPP can be ignored.

  • Not recommended for beginners: You might choose the option of installing Apache and MySQL as a service

  • Copy the file php_bcompiler.dll (from the downloaded bcompiler ZIP file) to c:\xampp\php\ext\

  • Download the current version of the Triangles Rotation distribution.
    The file will be called something like "sd-v2.1b.zip".

    Extract the Triangles Rotation distribution file and move the sd directory to c:\xampp\htdocs\ (do not use the whole sd-v2.xxx directory, but the one simply named "sd" which is inside).

  • Make these changes to the file c:\xampp\php\php.ini:
    Add: extension=php_bcompiler.dll
    Change: register_globals = Off
    to: register_globals = On
    (since v2.1, register_globals is no longer needed)

  • On the XAMPP Control Panel (might need to be activated using Programs/Apache Friends first), start Apache and MySQL

  • If Windows warning dialogs pop up, please allow access for the program

  • If Apache and/or MySQL do not show up as "running" on the control panel, try to restart them

  • Go to http://localhost with your web browser, the XAMPP splash screen should show up

  • Call phpinfo() from the menu on the left and check that "bcompiler" is listed as an enabled module (between the modules "bcmath" and "bz2").

  • Choose "phpmyadmin" from the menu on the left

  • Create a database "web"; to do this, click on "Datenbases", enter "web" into the input field and click "create"

  • Click on the database "web" on the top left side, then use "Rights" from the menu on the right hand top side (if a "Rights" tab is not visible you can find it under "More")

  • "Create new user"

  • Enter "omerzu" as user name and choose host "local" from the menu and enter password "db". Repeat the password and click "ok" on the VERY bottom.

  • Go to http://localhost/sd/ with your web browser.

  • The Triangles Rotation program should come up and should, in the first place, complain that it cannot find its "config.php": Fatal error: config.php missing Please create your own config.php using config.php.template

  • Create your own "config.php" in the dircetory C:\xampp\htdocs\sd\ by making a copy of the provided "config.php.template". For the first steps, you do not need to make any changes here, later we recommend to follow the hints in this chapter.

  • Call http://localhost/sd/ in your web browser.

  • On the first call you will probably get the message "Running on different system, ignore config!". This is normal, just click the link "Restart program".

  • The web browser should now show the menu of the Triangles Rotation program.

  • Click "Admin", and "DB: Create"

  • If you have one, you should import a dancer database using the Admin/Import function.

Continue with Basic configuration and Basic operation hints.


Back to Index