KVM

  • 2 minute(s) read
Prev Next

Installing the CTERA Edge Filer in a KVM Environment

Installing the CTERA Edge Filer involves creating and configuring a virtual machine and then performing an initial configuration, described in First Time Setup.

Contact CTERA Networks, and request the latest qcow2 CTERA Edge Filer disk image.

Warning

The CTERA Edge Filer installation must be done using the qcow2 file and not by cloning an existing CTERA Edge Filer.

You can install the CTERA Edge Filer on KVM via the OpenStack console or another console. The following instructions describe how to install a CTERA Edge Filer directly in KVM.

You require a Linux machine with KVM virtualization and Virtual Machine Manager (virt-manager) installed and running and the *.qcow2 image file located on the machine.

To install the CTERA Edge Filer:

  1. Log in to the KVM machine.

  2. Copy the KVM image file, <version>.qcow2 to a folder on the KVM machine where version is the CTERA Edge Filer version.

  3. In the folder where you copied the KVM image file, create the data disk for the CTERA Edge Filer using the following command: qemu-img create -f qcow2 data.qcow2 <diskSize> where diskSize is the size of the data disk, based on the license.

    • For an EV16 license, the maximum is 16TB.
    • For an EV32 license, the maximum is 32TB.
    • For an EV64 license, the maximum is 64TB.
    • For an EV128 license, the maximum is 128TB.
    • For an EV256 license, the maximum is 256TB.

  4. Change the permissions for the data disk using the following command: chmod 777

  5. Retrieve the name of the network bridge to use in the virt-install command.

  6. Create the CTERA Edge Filer using the following command: virt-install --name <name> --vcpus <cpus> --memory <memory> --disk path=<version>.qcow2 --disk path=data.qcow2 --network bridge=virbr0 --os-variant centos-stream9 --import --noautoconsole
    where:
    name is the name assigned to the CTERA Edge Filer VM.
    cpu is the number of vCPUs.
    memory is the memory requirement in MB.
    version is the CTERA Edge Filer version.

The server is created and started up.

To get the virtual machine IP address:

  1. Access the virtual machine.
    The following login screen is displayed:
    image.png
  2. Login in with the username setup and no password, as instructed.
    Using DHCP, after a few seconds, the IP address to access the CTERA Edge Filer is displayed in the top right of the console.
    image.png
    Otherwise, set a static IP address, as described below.
  3. Continue with First Time Setup.

To set a static IP address:

  1. Access the virtual machine.
    The following login screen is displayed:
    image.png
  2. Login in with the username setup and no password, as instructed.
    The console is displayed.
    image.png
  3. Click in the console to transfer the keyboard control to the console and, if necessary, use the arrow keys to scroll to Network settings.
  4. Press Enter.
    image.png
  5. Select Static IP mode and press OK.
  6. Complete the configuration for static mode by entering the static IP, netmask, default CTERA Edge Filer IP and the primary and secondary DNS server IPs.
  7. Press OK.