Skip to main content
Version: 0.3.0

Node-Wizard Installation

Node-Wizard Requirements​

  1. Host OS is Ubuntu 24.04, 22.04, 20.04, Rocky Linux 9.2 or RHEL 9.2
  2. Network Bridge
    1. Node-Wizard assumes a network bridge exists on the host.
    2. bridge used needs internet access.

Install Node-Wizard as system service​

The file naming convention is node-wizard-<version>-<distribution>. In this guide we will assume version 0.3.0 and Ubuntu 22.04. Please see Node-Wizard Release for alternative versions and distributions.

  1. Download a release tarball from Download

  2. Extract Node-Wizard

    tar -xvf node-wizard-0.3.0-ubuntu22.tgz;

  3. Create the Node-Wizard systemd service by running the included installer, deploy-node-wizard.sh.
    You will be asked to specify the following for VMs

    • A gateway IP address
    • A list of name servers
    • A bridge name that will be attached
    • Virsh pool name configured for Ceph RBD pool (optional)

    The network configuration will be used for VMs, not for the host machine. See basic VM network settings for more information.

Supported Parameters for deploy-node-wizard.sh:

  • -a Deploy all : default
  • -d Deploy node-wizard and check package dependencies. Skip version and Ubuntu ISO checking.
  • -i Specify the path of env_node.json instead of using default values. eg) -i /tmp/env_node.json
  • -h print usage
cd node-wizard-0.3.0;
sudo ./deploy-node-wizard.sh;
note

The deploy-node-wizard.sh will print a token. This token is necessary to add this kvm host to node-client.

Verify Node-Wizard is running​

  1. To verify the installation of Node-Wizard, check that the status of the systemd service is in an active running state. 
    sudo systemctl status node-wizard.service

Node-Wizard location​

  1. The Node-wizard binary is located at /root/bin/node_wizard/node-wizard.

GuestOS Installer​

  • To create a VM with the following guest OSes, the corresponding installer ISO files need to be placed at /storage/VM/iso directory
  • GuestOS
    • Ubuntu 20.04: ubuntu-20.04.4-live-server-amd64.iso
    • Ubuntu 22.04: ubuntu-22.04.2-live-server-amd64.iso
    • Ubuntu 24.04: ubuntu-24.04.1-live-server-amd64.iso
    • RedHat 9.2: rhel-9.2-x86_64-dvd.iso
    • Rocky 9.2: Rocky-9.2-x86_64-dvd.iso
    • SUSE Linux: SLE-15-SP5-Full-x86_64-GM-Media1.iso
    • Windows Server 2019: Windows_Server2019.iso / virtio-win.iso
  • To download these files, please see GuestOS download page