Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
documentation:latest:installsles [2017/11/20 14:52] xguimard Spelling errors |
documentation:latest:installsles [2019/01/28 12:04] (current) |
||
---|---|---|---|
Line 8: | Line 8: | ||
* lemonldap-ng: metapackage, contains no file but dependencies on other packages | * lemonldap-ng: metapackage, contains no file but dependencies on other packages | ||
* lemonldap-ng-doc: contains HTML documentation and project docs (README, etc.) | * lemonldap-ng-doc: contains HTML documentation and project docs (README, etc.) | ||
- | * lemonldap-ng-fr-doc: French translation for documentation | ||
* lemonldap-ng-conf: contains default configuration (DNS domain: example.com) | * lemonldap-ng-conf: contains default configuration (DNS domain: example.com) | ||
* lemonldap-ng-test: contains sample CGI test page | * lemonldap-ng-test: contains sample CGI test page | ||
Line 28: | Line 27: | ||
Different repositories are necessary for LemonLDAP::NG dependencies: | Different repositories are necessary for LemonLDAP::NG dependencies: | ||
* Suse official repositories | * Suse official repositories | ||
- | * 2 repositories on [[https://build.opensuse.org/|OpenSuse Build Service]] | + | * 2 repositories on [[https://build.opensuse.org/|openSUSE Build Service]] |
* Additional packages available on repository.linagora.org or lemonldap-ng.org | * Additional packages available on repository.linagora.org or lemonldap-ng.org | ||
* Suse SDK repository is advised for building packages (yast2 -> Software -> Software Repositories -> Add --> Extensions and modules from Registration Server) | * Suse SDK repository is advised for building packages (yast2 -> Software -> Software Repositories -> Add --> Extensions and modules from Registration Server) | ||
Line 37: | Line 36: | ||
</code> | </code> | ||
- | You can add the OpenSuse Build Service repositories with the following commands: | + | You can add the openSUSE Build Service repositories with the following commands: |
<code> | <code> | ||
zypper addrepo http://download.opensuse.org/distribution/leap/42.1/repo/oss/suse/ leap42 | zypper addrepo http://download.opensuse.org/distribution/leap/42.1/repo/oss/suse/ leap42 | ||
Line 73: | Line 72: | ||
rpm --import rpm-gpg-key-ow2 | rpm --import rpm-gpg-key-ow2 | ||
</code> | </code> | ||
- | |||
===== Install packages ===== | ===== Install packages ===== | ||
Line 137: | Line 135: | ||
<code shell> | <code shell> | ||
- | sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/{*.conf,*.ini,for_etc_hosts} /var/lib/lemonldap-ng/conf/lmConf-1 /var/lib/lemonldap-ng/test/index.pl | + | sed -i 's/example\.com/ow2.org/g' /etc/lemonldap-ng/{*.conf,*.ini,for_etc_hosts} /var/lib/lemonldap-ng/conf/lmConf-1 |
</code> | </code> | ||
Line 145: | Line 143: | ||
apachectl restart | apachectl restart | ||
</code> | </code> | ||
- | |||
- | ==== Reload virtual host ==== | ||
- | |||
- | To allow the manager to reload the configuration, register the reload virtual host name in the hosts of the server: | ||
- | <code shell> | ||
- | echo "127.0.0.1 reload.example.com" >> /etc/hosts | ||
- | </code> | ||
- | |||
- | <note tip>Adapt the reload virtual host name to the domain you configured.</note> | ||
- | |||
- | ==== Upgrade ==== | ||
- | |||
- | If you upgraded LL::NG, check all [[upgrade|upgrade notes]]. | ||
- | |||
- | For apache configuration, you may have to remove the old symbolic link, if not done by the RPM: | ||
- | <code shell> | ||
- | rm -f /etc/apache2/vhosts.d/z-lemonldap-ng.conf | ||
- | </code> | ||
- | |||
- | Your old Apache configuration should have been saved, you need to port your specificities in new Apache configuration files: | ||
- | <code shell> | ||
- | vi /etc/lemonldap-ng/apache2.conf.rpmsave | ||
- | </code> | ||
- | |||
- | The upgrade process will also have migrate old configuration files into ''/etc/lemonldap-ng/lemonldap-ng.ini''. This includes the application list which is now set in the ''applicationList'' parameter from ''[portal]'' section, for example: | ||
- | <file ini> | ||
- | [portal] | ||
- | applicationList={ 'Menu' => { type => 'category', 'Example' => { type => 'category', 'test1' => { type => 'application', options => { name => 'Application Test 1', uri => 'http://test1.example.com/', description => 'A simple application displaying authenticated user', logo => 'wheels.png', display => 'auto', }, },'test2' => { type => 'application', options => { name => 'Application Test 2', uri => 'http://test2.example.com/', description => 'The same simple application displaying authenticated user', logo => 'wheels.png', display => 'auto', }, }, },'Administration' => { type => 'category', 'manager' => { type => 'application', options => { name => 'WebSSO Manager', uri => 'http://manager.example.com/', description => 'Configure LemonLDAP::NG WebSSO', logo => 'tools.png', display => 'on', }, },'sessions' => { type => 'application', options => { name => 'Sessions explorer', uri => 'http://manager.example.com/sessions.pl', description => 'Explore WebSSO sessions', logo => 'tools.png', display => 'on', }, }, },'Documentation' => { type => 'category', 'localdoc' => { type => 'application', options => { name => 'Local documentation', uri => 'http://manager.example.com/doc/', description => 'Documentation supplied with LemonLDAP::NG', logo => 'docs.png', display => 'on', }, },'officialwebsite' => { type => 'application', options => { name => 'Offical Website', uri => 'http://wiki.lemonldap.objectweb.org/xwiki/bin/view/NG/Presentation', description => 'Official LemonLDAP::NG Website', logo => 'web.png', display => 'on', }, }, }, }, } | ||
- | </file> | ||
- | |||
- | <note important>You should now use the Manager to configure all [[portalmenu#categories_and_applications|applications and categories]], and then comment or remove the ''applicationList'' parameter from ''/etc/lemonldap-ng/lemonldap-ng.ini''.</note> | ||
==== DNS ==== | ==== DNS ==== | ||
- | Configure your DNS server to resolve names with your server IP. | + | Configure your DNS server to resolve names with your server IP: |
- | + | * auth.<your domain>: main portal, must be public | |
- | <note tip> | + | * manager.<your domain>: manager, only for adminsitrators |
- | For tests with ''example.com'', launch the following : | + | * test1.<your domain>, test2.<your domain>: sample applications |
- | <code shell> | + | |
- | cat /etc/lemonldap-ng/for_etc_hosts >> /etc/hosts | + | |
- | </code> | + | |
- | </note> | + | |
Follow the [[start#configuration|next steps]] | Follow the [[start#configuration|next steps]] |