ERROR: Unrecognised option '--foreman-admin-username' 1.22

Problem:
It appear that the documentation needs to be updated for 1.22.

ERROR: Unrecognised option ‘–foreman-admin-username’

I think all of these have changed:
–foreman-admin-username
–foreman-admin-email
–foreman-admin-first-name
–foreman-admin-last-name
–foreman-admin-password

https://theforeman.org/manuals/1.22/index.html#3.2ForemanInstaller
Under Option

When I run foreman-installer --help I get:

--foreman-initial-admin-email  Initial E-mail address of the admin user (current: UNDEF)
--foreman-initial-admin-first-name  Initial first name of the admin user (current: UNDEF)
--foreman-initial-admin-last-name  Initial last name of the admin user (current: UNDEF)
--foreman-initial-admin-password  Initial password of the admin user, default is randomly generated (current: "RKkYUM3gCJwzFBq4")
--foreman-initial-admin-username  Initial username for the admin user account, default is admin (current: "admin")
--foreman-initial-location    Name of an initial location (current: UNDEF)
--foreman-initial-organization  Name of an initial organization (current: UNDEF)

Foreman and Proxy versions:
foreman-installer-1.22.0-1.el7.noarch

Thanks!

It looks like more options changed as well. These are all different now.
–foreman-server-port
–foreman-server-ssl-ca
–foreman-server-ssl-cert
–foreman-server-ssl-certs-dir
–foreman-server-ssl-chain
–foreman-server-ssl-crl
–foreman-server-ssl-key
–foreman-server-ssl-port
–foreman-server-ssl-protocol

Thanks!

Thanks for pointing these out, looks like indeed the manual hasn’t been updated with the changed options. Would you be interested in opening a PR to update it?
The source for it lies at https://github.com/theforeman/theforeman.org/blob/gh-pages/_includes/manuals/1.22/3.2.2_installer_options.md and the list of options can be easily generated by running kafo-export-params -c /etc/foreman-installer/scenarios.d/foreman.yaml -f html.

@tbrisker this should be part of the release procedure and there’s a script to get these. We should include it in https://github.com/theforeman/tool_belt/blob/master/procedures/foreman/release.md.erb as a step for the manual.
https://github.com/theforeman/theforeman.org/blob/gh-pages/scripts/installer/get-params

1 Like

opened a pr so we don’t miss this in the next releases. @jwilliam would you be interested in running the script and opening a pr to fix 1.22?
https://github.com/theforeman/tool_belt/pull/187

I am pretty new at some of this. It took me a while to figure out that PR was (Pull Request).
I am not sure what really needs to be done?

Oh, I’m sorry i wasn’t clear enough :slight_smile:
Updating the docs is a great way to make your first contribution to the project which is why i suggested it - I’ll happily guide you through it if you want to do it, but it’s also perfectly fine if you don’t have the time for it.

To update it, you will need to fork the https://github.com/theforeman/theforeman.org/ repo on github and clone it to your local machine and make sure you have docker set up. after that, to generate the updated options, you need to run scripts/installer/get-params 1.22 from the cloned repo. This will generate two html files under the scripts/installer folder containing the installer help and options, which should then be copied into _includes/manuals/1.22/3.2.2_installer_options.md in the relevant sections.