Installing updates

To install software updates please follow these steps:

  1. Access your FileRun 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 FileRun control panel section. However, if your FileRun 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 FileRun back online.
  5. If PHP will not be able to replace a file, because of its permission settings, the update will fail and the FileRun installation may become unusable. To avoid this, please try to set the permissions of the the entire FileRun installation folder so that PHP can replace all files without problems. You will be able to set the permissions back, after installing the update.
  6. Click “Check for updates” and wait while FileRun 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 FileRun application files.

If you are using Microsft IIS web server, you need to right click the FileRun 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 FileRun installation unusable, here are the steps to fix it:

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

  1. You need a FileRun installation kit that matches the FileRun 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 FileRun installation folder (after making sure you have the folder “system/data” in a safe location)
  4. Extract the contents of the FileRun 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 FileRun 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 FileRun installation and follow the above update installation guide, without skipping any step ;)