Console password reset for Puppet Enterprise 2019.0.0 and 2019.0.1

I can’t log in to the console as the admin user, and am getting an incorrect username/console error. When I follow the documentation to reset the console admin password for PE 2019.0, I get an invalid option error.

Note: If you need to reset the password in the most recent version of Puppet Enterprise, the steps are in our documentation.

Error messages and logs

When you run puppet infra console_password --password=<MY_PASSWORD>, it outputs an error message containing could not parse application option, invalid option --password=....

The puppet infra console_password command was added in PE 2019.0.2, so the instructions won’t work for PE 2019.0.0 and 2019.0.1. Our documentation covers the latest version of 2019.0 (2019.0.4).

Version and installation information

PE version: 2019.0.0, 2019.0.1

Note: PE 2019.0 is end of life. Upgrade to a supported version of PE as soon as possible. For details, see the Puppet Enterprise lifecycle policy.

Solution

To reset the console admin password in these specific PE versions, run the set_console_admin_password.rb utility script. You must run the script in the command line on the server where the console component is installed. It cannot be run on the master in a split installation.

1. Log into the console node as root (the master in a monolithic installation).

2. Run the set_console_admin_password.rb script:

   /opt/puppetlabs/puppet/bin/ruby /opt/puppetlabs/server/bin/set_console_admin_password.rb <NEW_PASSWORD>

   If successful, the command does not produce any output.

3. Log into the console. Enter the password directly. If you copy and paste the password, you might add special characters such as line breaks that might cause issues with either the password reset script or the console login form.

   If you can’t log in, run the above command again to ensure that the password you set matches the one you’re entering.