novajoin-install(1)

NAME
novajoin-install - Configure a novajoin server

SYNOPSIS
novajoin-install [OPTION]...

DESCRIPTION
Configures a machine as a novajoin server. The machine must first be configured as an IPA client. It does not need to be running on a nova controller. The installer configures nova to use the novajoin service as a dynamic metadata provider, configures the novajoin notification and REST services and configures IPA to grant access to a role that allows management of hosts. There are four ways to provide authentication for the IPA integration: 1. kinit before running the script and use the --no-kinit option.

2. Set the Kerberos principal with --principal and pass the password on the command-line using --password.

3. Set the Kerberos principal with --principal and pass the password in a file using --password-file.

4. Let the installer prompt the user for the password.

OPTIONS
Nova join Install Options -h, --help show this help message and exit

--no-kinit
    Assume the user has already done a kinit (principal and password not required)

--user USER
    User that nova services run as

--principal PRINCIPAL
    Kerberos principal to use to setup IPA integration

--password PASSWORD
    password for the Kerberos principal

--password-file PASSWORDFILE
    path to file containing password for the Kerberos principal

--keystone-auth-url KEYSTONE_AUTH_URL
    Keystone auth URL (ex http://192.168.0.1:5000/v3)

--nova-password NOVA_PASSWORD
    Nova service user password

--precreate
    Pre-create the IPA host with a One-Time Password (OTP)

PRECREATE OPTIONS
These are additional options available when precreate is requested.

--server SERVER
    IPA server

--realm REALM
    IPA realm name

--domain DOMAIN
    IPA domain name

--hostname HOSTNAME
    Hostname of IPA host to create

--otp-file OTP_FILENAME
    File to write OTP to instead of stdout

EXIT STATUS
0 if the installation was successful 1 if an error occurred

SEEALSO
novajoin-server(1), novajoin-notify(1)