OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Controlling virtual machine states

You can stop, start, restart, and unpause virtual machines from the web console.

To control virtual machines from the command-line interface (CLI), use the virtctl client.

Starting a virtual machine

You can start a virtual machine from the web console.

Procedure

  1. Click Workloads → Virtualization from the side menu.

  2. Click the Virtual Machines tab.

  3. Find the row that contains the virtual machine that you want to start.

  4. Navigate to the appropriate menu for your use case:

    • To stay on this page, where you can perform actions on multiple virtual machines:

      1. Click the Options menu kebab located at the far right end of the row.

    • To view comprehensive information about the selected virtual machine before you start it:

      1. Access the Virtual Machine Overview screen by clicking the name of the virtual machine.

      2. Click Actions.

  5. Select Start Virtual Machine.

  6. In the confirmation window, click Start to start the virtual machine.

When you start virtual machine that is provisioned from a URL source for the first time, the virtual machine has a status of Importing while OpenShift Virtualization imports the container from the URL endpoint. Depending on the size of the image, this process might take several minutes.

Restarting a virtual machine

You can restart a running virtual machine from the web console.

To avoid errors, do not restart a virtual machine while it has a status of Importing.
Procedure

  1. Click Workloads → Virtualization from the side menu.

  2. Click the Virtual Machines tab.

  3. Find the row that contains the virtual machine that you want to restart.

  4. Navigate to the appropriate menu for your use case:

    • To stay on this page, where you can perform actions on multiple virtual machines:

      1. Click the Options menu kebab located at the far right end of the row.

    • To view comprehensive information about the selected virtual machine before you restart it:

      1. Access the Virtual Machine Overview screen by clicking the name of the virtual machine.

      2. Click Actions.

  5. Select Restart Virtual Machine.

  6. In the confirmation window, click Restart to restart the virtual machine.

Stopping a virtual machine

You can stop a virtual machine from the web console.

Procedure

  1. Click Workloads → Virtualization from the side menu.

  2. Click the Virtual Machines tab.

  3. Find the row that contains the virtual machine that you want to stop.

  4. Navigate to the appropriate menu for your use case:

    • To stay on this page, where you can perform actions on multiple virtual machines:

      1. Click the Options menu kebab located at the far right end of the row.

    • To view comprehensive information about the selected virtual machine before you stop it:

      1. Access the Virtual Machine Overview screen by clicking the name of the virtual machine.

      2. Click Actions.

  5. Select Stop Virtual Machine.

  6. In the confirmation window, click Stop to stop the virtual machine.

Unpausing a virtual machine

You can unpause a paused virtual machine from the web console.

Prerequisites

  • At least one of your virtual machines must have a status of Paused.

    You can pause virtual machines by using the virtctl client.
Procedure

  1. Click Workloads → Virtualization from the side menu.

  2. Click the Virtual Machines tab.

  3. Find the row that contains the virtual machine that you want to unpause.

  4. Navigate to the appropriate menu for your use case:

    • To stay on this page, where you can perform actions on multiple virtual machines:

      1. In the Status column, click Paused.

    • To view comprehensive information about the selected virtual machine before you unpause it:

      1. Access the Virtual Machine Overview screen by clicking the name of the virtual machine.

      2. Click the pencil icon that is located on the right side of Status.

  5. In the confirmation window, click Unpause to unpause the virtual machine.