Updating Open Labyrinth

Using GitHub

If you clone OpenLabyrinth to the web-server folder using GitHub, then follow the next steps:

1. Connect to your server using the user name that has root access.
   

2) Make a backup of the Open-Labyrinth directory (just in case):
```sudo cp -rp /var/www/Open-Labyrinth /var/www/Open-Labyrinth.20130808```

3) Change directory to OpenLabyrinth instance. For example:
```cd /var/www/Open-Labyrinth```

4) If this is the production server, and you're following the suggested branching model make sure you're on the master branch:
```sudo git branch```
You should see an asterisk beside master if you're on the master branch.
```* master```

5) Also make sure that that the Git filemode option is disabled in the configuration or just run this command:
```sudo git config core.filemode false```

6) Do the upgrade to the file system. Run GitHub command:
```sudo git pull```

**Note:**
If you have the following error (```error: Your local changes.... Aborting```) after running GitHub command, then run command
```sudo git stash save```.
After that repeat step 5.

7) To update the database just open the next URL in a web browser :
http://PATH_TO_YOUR_OPENLABYRINTH/updateDatabase

If you are not authorized in OpenLabyrinth, you will be redirected to the login page. After you have completed the authorization, you will be redirected to the update module.

8) After successful update of the database you will see the next message:
_"Database has been successfully updated"_

If update package does not include any updates to the database, you will see the next message:
_"New updates to the database were not found"_

If you come across the error in folder permissions, then read the next page: [How do I make files and folders writable for the web server?](https://github.com/olab/Open-Labyrinth/wiki/How-do-I-make-files-and-folders-writable-for-the-web-server%3F)

Update manually (for advanced users)

If you clone OpenLabyrinth not to the web-server folder and then manually copy project folder to your web-server folder, then follow the next steps:

1. Open the folder which contains OpenLabyrinth from GitHub.
   

2) Run GitHub command:
```git pull```

3) Copy all folders and files from this folder to folder on your web-server except the next folders and files:

_Folders:_
-www/installation
-www/application/config (copy only new files, don't replace old one)

_Files:_
-www/install.php

4) To update the database just open the next URL in a web browser:
http://PATH_TO_YOUR_OPENLABYRINTH/updateDatabase

If you aren't authorized in OpenLabyrinth, you will be redirected to the login page. After you have completed the authorization in OpenLabyrinth, you will be redirected to the update module.

5) After successful update of the database you will see the next message:
_"Database has been successfully updated"_

If update package does not include any updates to the database, you will see the next message:
_"New updates to the database were not found"_

If you come across the error in folder permissions, then read the next page: [How do I make files and folders writable for the web server?](https://github.com/olab/Open-Labyrinth/wiki/How-do-I-make-files-and-folders-writable-for-the-web-server%3F)

Upgrade minor versions

The following upgrading instructions are cumulative. That is, if you want to upgrade from version A to version C and there is version B between A and C, you need to follow the instructions for both A and B.

Upgrade from v3.4.x to v3.5.x (currently this is a release-candidate)

1. Check system requirements:
   • PHP 5.5.0 or higher
2. Install Composer (https://getcomposer.org). When Composer has been installed, run composer install in the root directory of the project (/var/www/Open-Labyrinth, but not in /var/www/Open-Labyrinth/www).
3. Run php vendor/bin/phinx migrate in the same directory.

Upgrade from v3.3.x to v3.4.x

1. Check system requirements:
   • PHP 5.4.0 or higher
   • MySQL server 5.5.3 or higher
   • MySQL client libraries are version 5.5.3 or higher. If you’re using mysqlnd, 5.0.9 or higher.
2. Please copy www/installation/h5p folder and paste it to www/files/
3. Make sure that folder www/files/h5p has mode 0775. Execute chmod -R 775 www/files/h5p if required.