diff --git a/redirects.yaml b/redirects.yaml index 256e59a01da..997bd428be5 100644 --- a/redirects.yaml +++ b/redirects.yaml @@ -430,7 +430,8 @@ download/intel-joule/?: "/download/iot/" download/intel-joule-desktop/?: "/download/iot/" download/samsung-artik-5-10/?: "/download/iot/" download/samsung-artik-5-10-server/?: "/download/iot/" -download/iot/kvm/?: "/download/kvm" +download/iot/kvm/?: "/core/docs/getting-started" +download/kvm/?: "/core/docs/getting-started" download/iot/up-squared-iot-grove-server/?: "/download/up-squared-iot-grove-server" download/releasenotes.*/?: "https://wiki.ubuntu.com/Releases" download/server/download/?: "/download/server" diff --git a/templates/download/kvm.html b/templates/download/kvm.html deleted file mode 100644 index 30e3c6e3f09..00000000000 --- a/templates/download/kvm.html +++ /dev/null @@ -1,127 +0,0 @@ -{% extends "download/_base_download.html" %} - -{% block title %}Install Ubuntu Core on KVM{% endblock %} -{% block meta_copydoc %}https://docs.google.com/document/d/1FHIArLpuAyLe2gnDwymefvzc4Lg8dSGvN8QAl8wX18Q/edit{% endblock meta_copydoc %} - -{% block content %} -
-
-
-

Install Ubuntu Core on KVM

-
-
-
-
-
-
-

Install Ubuntu Core

-

We will walk you through the steps of installing Ubuntu Core 20 on your Linux desktop in a virtual machine.

-
-
-

Minimum requirements

-
    -
  • An Ubuntu SSO account with an SSH key
  • -
  • A computer running Ubuntu Desktop
  • -
-
-
-
-
-
- -
-
-

Installation instructions

-
    - {% include "download/iot/_setup-ubuntu-sso.html" %} -
  1. -

    - - Download Ubuntu Core -

    -
    - -
    -
  2. -
  3. -

    - - Install KVM -

    -
    -
      -
    1. -

      Install the qemu-kvm package with the following command:

      -
      sudo apt install qemu-kvm ovmf
      -
    2. -
    3. -

      Then, run the kvm-ok command to check KVM status and your hardware:

      -
      kvm-ok
      -
    4. -
    5. -

      The message should say:

      -
      INFO: /dev/kvm exists
      -KVM acceleration can be used
      -

      This is the best outcome — it means that Ubuntu Core will run fast on your system, taking advantage of hardware acceleration in your CPU.

      -
    6. -
    -
    -
  4. -
  5. -

    - - Launch KVM -

    -
    -

    You can now launch a virtual machine with KVM, using the following command:

    -
    qemu-system-x86_64 -smp 2 -m 2048 -net nic,model=virtio -net user,hostfwd=tcp::8022-:22,hostfwd=tcp::8090-:80 -vga qxl -drive file=/usr/share/OVMF/OVMF_CODE.fd,if=pflash,format=raw,unit=0,readonly=on -drive file=ubuntu-core-20-amd64.img,cache=none,format=raw,id=disk1,if=none -device virtio-blk-pci,drive=disk1,bootindex=1 -machine accel=kvm
    -

    - Note: this command sets up port redirections: -

      -
    • localhost:8022 is redirecting to port 22 of the virtual machine for accessing it through SSH
    • -
    • localhost:8090 is redirecting to its port 80
    • -
    -

    -

    - Note: this command is required for graphics such as mir-kiosk: -

      -
    • -vga qxl sets the paravirtual graphics driver qxl
    • -
    -

    -

    You should now see a window, with your Ubuntu Core virtual machine booting inside it.

    -
    -
  6. - {% include "download/iot/_first-boot-setup.html" %} -
  7. -

    - - Login -

    -
    -

    Once setup is done, you can login with SSH into Ubuntu Core, using the following command:

    -
    ssh -p 8022 <Ubuntu SSO user name>@localhost
    -

    Your username is your Ubuntu SSO user name, shown to you at the end of the account configuration step.

    -
    -
  8. -
-
-
- -{% with strip="p-strip--light" %}{% include "download/iot/_boot-tips-strip.html" %}{% endwith %} - -{% with board="virtual machine" %} - {% include "download/iot/_install-snaps-strip.html" %} -{% endwith %} - -{% include "download/shared/_get-ebook-security.html"%} - -{% with first_item="_core_learn_more", second_item="_core_contribute", third_item="_iot_further_reading" %}{% include "shared/contextual_footers/_contextual_footer.html" %}{% endwith %} - -{% endblock content %}