...
This document describes installation and update of the IdP Installer, while the https://shibboleth.atlassian.net/wiki/spaces/IDP5/pages/3255435265/Jetty-BaseInstallation Jetty on Windows Installation topic describes the Jetty Installer.
...
Because the installation uses exactly the same process as a manual install sequence, from V5 onwards it is quite safe to intermix “manual” upgrades and MSI-based upgrades. Of course, the version displayed by the “Programs and Features” settings will display the last MSI version installed. Always use the Status command or web service to display the current IdP version when in doubt, or check the log at startup.
When upgrading from V4, when the previous version is uninstalled this will include any bundled jetty-base. If you are not deploying your own servlet container, then you will need to install the jetty-base Installer as well, do . Do this after you update the the IdP from V4 to V5 (since this update will remove the old jetty).
After an IdP update, you will need to stop and restart the web server you are using (and as always, it’s best to stop the container prior to any updates).
Note that any compatibility issues with installed plugins are logged by the underlying installer but will not be visible through the GUI when using the Windows installer to upgrade. This is another reason why moving to the standard installation package/process going forward is advisable (which does not preclude using the supplied Jetty installer if you wish to keep using that).
New Installations
A new install requires information in order to proceed. This can be gathered by GUI or specified on the msiexec
command line as (Windows Installer) properties, see below.
...
Code Block |
---|
msiexec /i msifile.msi [/qn] PROPERTY1=VALUE1 .... |
The properties are
MSI Property | PropertyDrivenInstallation Property | Description |
---|---|---|
INSTALLDIR | idp.target.dir | Where the IdP is going to be installed. |
DNSNAME | idp.host.name | The DNS name of the host used to create the self signed certificates |
IDP_SCOPE | idp.scope |
|
CONFIGURE_AD | Whether to write a merge file for the ldap properties (ldap.merge.properies) configured for ActiveDirectory | |
AD_DOMAIN | The AD Domain. Influence the contents of
| |
AD_USE_GC | Whether to use the Global Catalog. Influence the contents of:
| |
AD_USER | AD User. Influence idp.authn.LDAP.bindDN | |
AD_PASS | AD Password, Influences idp.LDAP.Credential |