Uploaded image for project: 'OpenShift Bugs'
  1. OpenShift Bugs
  2. OCPBUGS-44853

[enterprise-4.17] Issue in file virt/getting_started/virt-using-the-cli-tools.adoc

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: Minor Minor
    • None
    • 4.17.z
    • Documentation
    • None
    • None
    • False
    • Hide

      None

      Show
      None

      Description of problem:

          The documentation indicates that the "virtctl addinterface" and "virtctl removeinterface" commands exist. However, with an OCP-Virt 4.17.4 cluster (running CNV 4.17.1), which is the latest, the command does not exist.

      Version-Release number of selected component (if applicable):

          OCP 4.17.4 / CNV 4.17.1

      How reproducible:

          Running the "virtctl addinterface" command results in an error:
      unknown command "addinterface" for "virtctl"

      Steps to Reproduce:

          1. Download the virtctl binary from the OCP Console
          2. Try to run the command "virtctl addinterface" as described in the documentation
          3. Receive the error that the command does not exist in virtctl
          

      Actual results:

          Error

      Expected results:

          The interface should be added *OR* the documentation should be updated to remove references to the "addinterface" and "removeinterface" commands.

      Additional info:

      $ virtctl --help  # No mention of "addinterface" or "removeinterface"
      virtctl controls virtual machine related operations on your kubernetes cluster.Available Commands:
        addvolume         add a volume to a running VM
        adm               Administrate KubeVirt configuration.
        completion        Generate the autocompletion script for the specified shell
        console           Connect to a console of a virtual machine instance.
        create            Create a manifest for the specified Kind.
        credentials       Manipulate credentials on a virtual machine.
        expand            Return the VirtualMachine object with expanded instancetype and preference.
        expose            Expose a virtual machine instance, virtual machine, or virtual machine instance replica set as a new service.
        fslist            Return full list of filesystems available on the guest machine.
        guestfs           Start a shell into the libguestfs pod
        guestosinfo       Return guest agent info about operating system.
        help              Help about any command
        image-upload      Upload a VM image to a DataVolume/PersistentVolumeClaim.
        memory-dump       Dump the memory of a running VM to a pvc
        migrate           Migrate a virtual machine.
        migrate-cancel    Cancel migration of a virtual machine.
        pause             Pause a virtual machine
        permitted-devices List the permitted devices for vmis.
        port-forward      Forward local ports to a virtualmachine or virtualmachineinstance.
        removevolume      remove a volume from a running VM
        restart           Restart a virtual machine.
        scp               SCP files from/to a virtual machine instance.
        soft-reboot       Soft reboot a virtual machine instance
        ssh               Open a SSH connection to a virtual machine instance.
        start             Start a virtual machine.
        stop              Stop a virtual machine.
        unpause           Unpause a virtual machine
        usbredir          Redirect an USB device to a virtual machine instance.
        userlist          Return full list of logged in users on the guest machine.
        version           Print the client and server version information.
        vmexport          Export a VM volume.
        vnc               Open a vnc connection to a virtual machine instance.Use "virtctl <command> --help" for more information about a given command.
      Use "virtctl options" for a list of global command-line options (applies to all commands).
      
          
      $ virtctl version
      Client Version: version.Info{GitVersion:"v1.3.1-109-g804f8d51b6", GitCommit:"804f8d51b68441c4adcd0dd5b78181fccd2110c3", GitTreeState:"clean", BuildDate:"2024-10-24T21:21:21Z", GoVersion:"go1.22.7 (Red Hat 1.22.7-1.el9_5) X:strictfipsruntime", Compiler:"gc", Platform:"linux/amd64"}
      Server Version: version.Info{GitVersion:"v1.3.1-109-g804f8d51b6", GitCommit:"804f8d51b68441c4adcd0dd5b78181fccd2110c3", GitTreeState:"clean", BuildDate:"2024-10-28T10:48:48Z", GoVersion:"go1.22.7 (Red Hat 1.22.7-1.el9_5) X:strictfipsruntime", Compiler:"gc", Platform:"linux/amd64"}
      

              ocp-docs-bot OCP DocsBot
              rhn-support-msecaur Matthew Secaur
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: