XAMPP installation

root@c37:/opt/lampp# ./lampp stop Stopping XAMPP for Linux 5.6.3-0... XAMPP: Stopping Apache...ok. XAMPP: Stopping MySQL...not running. XAMPP: Stopping ProFTPD...not running. root@c37:/opt/lampp#

Yes indeed....

How to start and stop XAMPP

Starting XAMPP:

dirk@c36:~$ sudo /opt/lampp/lampp start
[sudo] password for dirk:
Starting XAMPP for Linux 5.6.3-0...
XAMPP: Starting Apache...ok.
XAMPP: Starting MySQL...ok.
XAMPP: Starting ProFTPD...ok.
dirk@c36:~$

Stoppintg XAMP:

dirk@c36:~$ sudo /opt/lampp/lampp stop
Stopping XAMPP for Linux 5.6.3-0...
XAMPP: Stopping Apache...ok.
XAMPP: Stopping MySQL...ok.
XAMPP: Stopping ProFTPD...ok.
dirk@c36:~$

Now shut down your Linux box and star up again. This forces you to manually start XAMPP. It's an extra check. Better to check now than hours, days, month later find out ... @Q!@#$%!!

Secure XAMPP

Start XAMPP

• Browse to http://localhost/.
• In the left XAMPP menu select 'Security'. Read the instructions and observe that the installation is insecure.
• Return to the terminal, typing and follow instructions:
  

      
  root@c37:/opt/lampp# /opt/lampp/xampp security
  XAMPP:  Quick security check...
  XAMPP:  Your XAMPP pages are NOT secured by a 
  password.
  XAMPP: Do you want to set a password? [yes]
  XAMPP: Password:
  XAMPP: Password (again):
  XAMPP:  Password protection active. Please use 
  'xampp' as user name!
  XAMPP:  MySQL is accessable via network.
  XAMPP: Normaly that's not recommended. Do you want 
  me to turn it off? [yes]
  XAMPP:  Turned off.
  XAMPP: Stopping MySQL...ok.
  XAMPP: Starting MySQL...ok.
  XAMPP:  The MySQL/phpMyAdmin user pma has no 
  password set!!!
  XAMPP: Do you want to set a password? [yes]
  XAMPP: Password:
  XAMPP: Password (again):
  XAMPP:  Setting new MySQL pma password.
  XAMPP:  Setting phpMyAdmin's pma password to the 
  new one.
  XAMPP:  MySQL has no root passwort set!!!
  XAMPP: Do you want to set a password? [yes]
  XAMPP:  Write the password somewhere down to make 
  sure you won't forget it!!!
  XAMPP: Password:
  XAMPP: Password (again):
  XAMPP:  Setting new MySQL root password.
  XAMPP:  Change phpMyAdmin's authentication method.
  XAMPP:  The FTP password for user 'daemon' is 
  still set to 'xampp'.
  XAMPP: Do you want to change the password? [yes]
  XAMPP: Password:
  XAMPP: Password (again):
  XAMPP: Reload ProFTPD...ok.
  XAMPP:  Done.
  root@c37:/opt/lampp#
  
• Choose secure and different passwords for each service. Return to the XAMPP security page:
  

  xampp_linux_welcome.png
• In the Menu, under XAMPP, selcect 'Security'. You see:
  

  xampp_linux_security.png

Preparations for the installation of Website@School

• In /opt/lampp/htdocs, create a directory for the Website@School program; for example was:
  mkdir /opt/lampp/htdocs/was.
• Copy the websiteatachool-<version>.zip to the directory and unzip.
• Create the Website@School data directory in /opt/lampp/, for example wasdata. Chmod 700 and chown deamon.root /opt/lampp/wasdata

  	
  root@c36:/opt/lampp# pwd
  /opt/lampp
  root@c36:/opt/lampp# mkdir wasdata
  root@c36:/opt/lampp# chmod 700 wasdata
  root@c36:/opt/lampp# chown daemon.root wasdata
  root@c36:/opt/lampp# ls -l
  [snip]
  drwx------  2 daemon root      4096 2013-12-23   14:22 wasdata
  [snip]
  root@c36:/opt/lampp#
  
• Browse to http://localhost/.
• In the XAMPP menu under Tools, select phpMyAdmin. Click [Databases]. At 'Create database' enter, for example, localwas. Do not use this common name.
  Click [Create]. In the phpMyAdmin left menu the database is added.
• Copy websiteatschool-<version>.zip and the manual to /opt/lampp/htdocs/. Unzip both.
• Go http://localhost/was/program/install.php. You see the first install page.
• Start the installaton. Please see chapter Installation, section 2. The installation.
• At the 'Database' window use: Server: localhost Username: root Password: ********* Database name: localwas
• NOTE: You have to download the config.php file and copy it to /opt/lampp/htdocs/. Next set ownership to daemon.root and file permissions to read-only for deamon.root (chmod 400):

  root@c36:/opt/lampp/htdocs# pwd
  /opt/lampp/htdocs
  root@c36:/opt/lampp/htdocs# chown daemon.root config.php
  root@c36:/opt/lampp/htdocs# chmod 400 config.php
  root@c36:/opt/lampp/htdocs# ls -l
  [snip]
  -r--------  1 daemon root   722 2013-12-23 15:34 config.php
  [snip]
  root@c36:/opt/lampp/htdocs#
  

Testing

3.2 Mac (not ready)

Please help us with instructions!

3.3 Windows (not ready)

Please help us with instructions!

3.3.1 Known issues

Bert reports he cannot install Website@School because of:

Fatal error: Maximum execution time of 30 seconds exceeded in C:\wamp\www\program\lib\database\mysql.class.php on line 295

It is true that the last step in the installation takes quite some time. Maybe it can be solved in a future release by letting the program ask for extra exection time.

The installation fails because 30 seconds apparentlly is not enough to complete the installation. Reasons can be: - The installation takes time because of the huge amount of Demonstration data (The Exemplum Primary School, users, Areas, sections, pages, modules, etc).
- The PC is too slow for the default 'max_execution_time' of the file php.ini, which is set to 30 seconds.

Workarounds:
- Raise 'max_execution_time' in php.ini.
- Install without Demonstration Data
- Faster PC

---

After a 'successful' installation of Website@School with XAMPP for Linux 5.5.19-0 or later, the website is visible, but the login screen is white and contains no data. Reason:

A fix until the release of Website@School 0.90.6b:

• In file ../program/lib/usermanager.class.php, go to line 427 and 726 and look for password_hash( (do not forget the brace!).
  Change 'password' in, for example, 'pazzword'. Save.
• Do exactly the same in ../program/lib/loginlib.php on lines 869, 1035, 1114, 1144 and 1176. Save.

The login screen is now accessible.

4. To conclude

No conclusions so far.

(top)

Author: Dirk Schouten <dirk (at) websiteatschool (dot) eu>

Last updated: 2015-02-03