Maintenance Mode PasswordMaintenance Mode Password

What

After starting/restarting Pure it will go into maintenance mode after:

• New installation: If this is the first time Pure is started, it will enter maintenance mode to run the required installation jobs.
• Upgrading Pure: After deploying a new version Pure will enter maintenance mode if there are any upgrade jobs that needs to be run. If this is a minor upgrade Pure might skip maintenance mode and go directly to the login page.
• Enabling something new in Pure (like Courses module) that requires a Pure restart, Pure will enter maintenance mode, because Pure requires some migrations to be run before it will work. 

How

A password is auto-generated every time which must be used to enter maintenance mode and continue the restart.

• Copy the password from the console.log file.
• Open the URL http://<your server>/admin/prestartup/maintenance.xhtml in a browser and enter the password
• Follow guide
  • Pure maintenance mode (upgrade) 
  • Pure maintenance mode (installation) 

In some cases the maintenance mode password is not accepted:

When entering the password I get an error message stating wrong password

• Verify password
• It has been seen that a whitespace can get introduced, when pasting the code. If there is whitespace before and after the code it will give an error. 
• Try using another browser.

When entering the password nothing happens, the maintenance page just refreshes, there is no indication of an error 
This could be due to cookie handling (SameSite) preventing the start of a new session. This in combination with the browser (version) that was used. 

• Try using a different browser.
• Long term fix to have this working in all browsers - If there is a proxy/apache server in front of Pure you should check that the Tomcat is correctly configured with Reverse proxy.

When entering the password nothing happens, the page seems frozen and no indication of an error 
This has been seen with Internet Explorer on Windows Server when running in "Protected Mode", but browser plugins or special settings in other browsers might also cause this. Note that IE11 is not supported from 5.15 and onward. See Supported platforms for more information.

• Try using another browser.  

More information  

Chrome related login issues and SameSite information 
SameSite cookie explained (external ressource)