This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
spip-saml/inc/simplesamlphp/docs/simplesamlphp-install-repo.txt

59 lines
2.0 KiB
Plaintext

Installing SimpleSAMLphp from the repository
============================================
These are some notes about running SimpleSAMLphp from the repository.
Installing from github
----------------------
Go to the directory where you want to install SimpleSAMLphp:
cd /var
Then do a git clone:
git clone git@github.com:simplesamlphp/simplesamlphp.git simplesamlphp
Initialize configuration and metadata:
cd /var/simplesamlphp
cp -r config-templates/* config/
cp -r metadata-templates/* metadata/
Install the external dependencies with Composer (you can refer to [getcomposer.org](http://getcomposer.org/) to get detailed
instructions on how to install Composer itself):
php composer.phar install
Upgrading
---------
Go to the root directory of your simpleSAMLphp installation:
cd /var/simplesamlphp
Ask git to update to the latest version:
git fetch origin
git pull origin master
Install or upgrade the external dependencies with Composer ([get composer](http://getcomposer.org/)):
php composer.phar install
Migrating from Subversion
-------------------------
If you installed SimpleSAMLphp from subversion, and want to keep updated on the development, you will have to migrate
your installation to git. First, follow the steps to get a fresh install from github in a different directory. Skip the
steps regarding configuration and metadata initialization, and copy all the files you might have modified instead (not
only configuration and metadata, but also any custom modules or templates). Finally, proceed to install Composer and
install all the dependencies with it. You may want to add all your custom files to the '.gitignore' file.
If you really want to use subversion instead of git, or it is impossible for you to migrate (you cannot install git, for
example), you might want to do a fresh install like the one described here, but using github's subversion interface.
Refer to [github's documentation](https://help.github.com/articles/support-for-subversion-clients) for detailed
instructions on how to do that.