The SWITCHwayf is published under a BSD license and provided "as-is".
See Files tab
General Update Instructions¶
In order to upgrade use the following instructions:
- Make a backup of the directory where the currently active version of the SWITCHwayf is installed, e.g. with
cp -a SWITCHwayf SWITCHwayf.bak
- Get the ZIP archive of the new version and move it into the same directory as the WAYF script of the currently deployed version.
Download the latest version from Files
- Unzip the archive, e.g. with the command:
unzip -d #DD# SWITCHwayf_x.y_YYYYMMDD.zip
This step will overwrite all files except those whose names start with 'custom-'.
Alternatively, create a new directory, move the ZIP archive in that directory, unzip it and then copy the config.php and all custom-.* files from the current SWITCHwayf installation over to the new directory.
- Have a look at config.dist.php and compare this file with your current config.php in order to identify new configuration options.
Since version 1.18 the script 'update-config.php' can be used to merge an existing configuration (from config.php) with the default configuration (config.dist.php) into a new configuration file (config.new.php). This allows easily getting a clean configuration file while keeping the current settings.
Run the script with:
Ensure that the user has the necessary write privileges to create the file config.new.php. Also note that all comments you might have added in the current.php will not be copied over.
- Ensure that the permissions for the files:
- $WAYFLogFile (typically /var/log/apache2/wayf.log) are set such that the web server user (e.g. www-data, www or httpd) has write permissions for them.
- If SAML2 metadata is used by SWITCHwayf, you might have to run the following command to bootstrap the metadata reading process again:
The GIT repository is world-readable. Checking out SWITCHwayf from GIT ensures that you always have the latest code version. We promise to check in only code that executes, however, for a production setup one should always first test checked out code before using it.