7.27 start-domain Command

Use the --start-domain command to create and start an Oracle Linux KVM guest.

Syntax

vm_maker --start-domain { guest_name | XML-config-file | --all } 
  [ --no-discovery ] [ --keep ] [ --locked ] [ --ssh-key key_file ] 
  [ --secure-boot { enable | disable }] [ --console ] [ --console-log { enable | disable }]

Options

• guest_name: The name of an existing guest to start.
• XML-config-file: The full file name of the XML configuration file for creating a new guest.
• --all: Starts all existing domains on the host.
• --no-discovery: Optionally specifies to skip network discovery and bridge creation when creating a new guest.
• --keep: Indicates that the guest should not be removed even if the first boot fails.
• --locked: If specified in conjunction with the --ssh-key option, password-based authentication is disabled for the root user, and access to the guest requires key-based authentication. Otherwise, the option forces users to choose a new password when they log in for the first time.
• --ssh-key: Optionally specifies the location of a file containing an SSH public key, which is used for authenticating the root user.

• --secure-boot: Optionally controls the KVM Guest Secure Boot feature.

  KVM Guest Secure Boot leverages the UEFI boot framework in Oracle Linux KVM to restrict which binaries can boot the KVM guest. Exadata support for UEFI in KVM is introduced in Oracle Exadata System Software release 24.1.0. Consequently, KVM Guest Secure Boot is available only on new UEFI boot-enabled KVM guests starting with Oracle Exadata System Software release 24.1.0.

  • --secure-boot enable: Enables KVM Guest Secure Boot on the KVM guest. This is the default for all new UEFI boot-enabled KVM guests.
  • --secure-boot disable: Creates the KVM guest with KVM Guest Secure Boot disabled.
• --console: Optionally causes vm_maker to display console messages when starting existing guests.

• --console-log: Optionally specifies how logging of console output is handled:

  • --console-log enable: Console output is written to a log file.
  • --console-log disable: Console output is not written to a log file.