3.2. Using the CLI tools

Procedure

1. Navigate to the Virtualization Overview page in the web console.
2. Click the Download virtctl link to download the virtctl binary for your operating system.

3. Install virtctl:

   • For RHEL and other Linux operating systems:

     1. Decompress the archive file:

        $ tar -xvf <virtctl-version-distribution.arch>.tar.gz

     2. Run the following command to make the virtctl binary executable:

        $ chmod +x <path/virtctl-file-name>

     3. Move the virtctl binary to a directory in your PATH environment variable.

        You can check your path by running the following command:

        $ echo $PATH

     4. Set the KUBECONFIG environment variable:

        $ export KUBECONFIG=/home/<user>/clusters/current/auth/kubeconfig

   • For Windows:

     1. Decompress the archive file.
     2. Navigate the extracted folder hierarchy and double-click the virtctl executable file to install the client.

     3. Move the virtctl binary to a directory in your PATH environment variable.

        You can check your path by running the following command:

        C:\> path

   • For macOS:

     1. Decompress the archive file.

     2. Move the virtctl binary to a directory in your PATH environment variable.

        You can check your path by running the following command:

        echo $PATH

Procedure

1. Enable the OpenShift Virtualization repository by using the subscription-manager CLI tool to run the following command:

   # subscription-manager repos --enable cnv-4.19-for-rhel-8-x86_64-rpms

2. Install the kubevirt-virtctl RPM package by running the following command:

   # yum install kubevirt-virtctl