Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

  • Scope to be declared by this IdP

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

  • idp.authn.LDAP.ldapURL

  • idp.authn.LDAP.baseDN

  • idp.authn.LDAP.dnFormat

AD_USE_GC

Whether to use the Global Catalog. Influence the contents of:

  • idp.authn.LDAP.ldapURL

  • idp.authn.LDAP.baseDN

AD_USER

AD User. Influence idp.authn.LDAP.bindDN

AD_PASS

AD Password, Influences idp.LDAP.Credential