Installing updates

To install software updates please follow these steps:

1. Access your Web File Share installation and log in as superuser (The default login name of the superuser is “admin”).
2. Open “Control Panel”
3. Go to “System configuration” » “Software update”
4. (Important!) In most cases, the software updates install easily with just a click from the Web File Share control panel section. However, if your Web File Share installation is under production and people depend on its functionality, we strongly recommend you to make a full backup of it before installing the update. If the update's installation fails, you will need to restore this backup to get Web File Share back online.
5. If PHP will not be able to replace a file, because of its permission settings, the update will fail and the Web File Share installation may become unusable. To avoid this, please try to set the permissions of the the entire Web File Share installation folder so that PHP can replace all files without problems. You will be able to set the permissions back, after installing the update. Also: make sure the MySQL user that Web File Share is configured with, has temporary ALTER and DROP permissions. You can remove this permission after you are done with the updates.
6. Click “Check for updates” and wait while Web File Share shows the result.
7. Read carefully the update's description and notes.
8. Click “Download update” and wait for the update to download.
9. Click “Install update” to install the update.
10. Read the update log carefully and check for error messages. If you encounter errors that you do not know how to fix, drop us a quick message.

If you are having troubles with file permissions on Linux servers, please contact your server administrator to help you make sure PHP has write access over the Web File Share application files.

If you are using Microsft IIS web server, you need to right click the Web File Share installation folder and add the system user “IUSR_<computer-name>” (Internet guest account) user to the list of users who have access to the folder, enabling the “Modify” and “Write” permissions.

If you ignored the advice about creating a backup, tried to install an update and failed, leaving your Web File Share installation unusable, here are the steps to fix it:

(You can still make a backup of the broken Web File Share installation folder and its database now, to avoid loosing your user accounts, settings and documents by mistake!)

1. You need a Web File Share installation kit that matches the Web File Share version you were last running, before it got broken. It is important that you have the exact same version, because you are going to replace the application files and these need to match the MySQL database structure.
2. Move the folder “system/data” (and any other file that you might have customized and the update did not overwrite) from the broken installation to a safe location.
3. Delete the Web File Share installation folder (after making sure you have the folder “system/data” in a safe location)
4. Extract the contents of the Web File Share installation kit mentioned at step #1, at the exact same location of your old installation. It is very important to have the application files in the same location as before and not in some other folder.
5. Replace the newly extracted “system/data” folder with the old one, the one you saved to a safe location at step #2
6. Access your Web File Share installation using the browser and make sure things work as they used to, before installing the update.
7. Make a backup of your now working Web File Share installation and follow the above update installation guide, without skipping any step ;)