Manual:CHR ProxMox installation: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
No edit summary
 
(11 intermediate revisions by one other user not shown)
Line 18: Line 18:
* Make sure that VM storage is on local storage (this way there will no need to work with LVM config side, and disk image can be moved later on to LVM or other desired storage if needed).
* Make sure that VM storage is on local storage (this way there will no need to work with LVM config side, and disk image can be moved later on to LVM or other desired storage if needed).
* Log into ProxMox host via SSH and navigate to VM image directory. Default local storage is located in: ''var/lib/vz/images/(VM_ID)''
* Log into ProxMox host via SSH and navigate to VM image directory. Default local storage is located in: ''var/lib/vz/images/(VM_ID)''
* via scp, wget or any other tool download CHR raw image (.img file) into this directory.
* Via scp, wget or any other tool download CHR raw image (.img file) into this directory.
* Now convert chr raw image to qcow2 format via qemu-img tool:
* Now convert the CHR raw image to qcow2 format using qemu-img tool:
''qemu-img convert -f raw -O qcow2 chr-6.40.3.img vm-(VM_ID)-disk-1.qcow2''
<pre>qemu-img convert -f raw -O qcow2 chr-6.40.3.img vm-(VM_ID)-disk-1.qcow2</pre>


==== Bash script approach ====
==== Bash script approach ====


If you have access to ProxMox host then CHR VM can also be created quickly via bash script. Below example of one such script.  
If you have access to ProxMox host then CHR VM can also be created quickly via BASH script. Below example of one such script.


What this script does:
What this script does:
* Stores tmp files in: "/root/temp" dir
* Stores tmp files in: ''/root/temp'' dir.
* Downloads raw image archive from MikroTik AWS download page.
* Downloads raw image archive from MikroTik download page.
* Converts image file to qcow format
* Converts image file to qcow format.
* Creates basic VM that is attached to MGMT bridge.
* Creates basic VM that is attached to MGMT bridge.


Line 47: Line 47:
else
else
     echo "-- Creating temp dir!"
     echo "-- Creating temp dir!"
     mkdir /home/root/temp
     mkdir /root/temp
fi
fi
# Ask user for version
# Ask user for version
Line 59: Line 59:
     echo "-- Downloading CHR $version image file."
     echo "-- Downloading CHR $version image file."
     cd  /root/temp
     cd  /root/temp
     echo "
     echo "---------------------------------------------------------------------------"
---------------------------------------------------------------------------"
     wget https://download.mikrotik.com/routeros/$version/chr-$version.img.zip
     wget https://download2.mikrotik.com/routeros/$version/chr-$version.img.zip
     unzip chr-$version.img.zip
     unzip chr-$version.img.zip
     echo "
     echo "---------------------------------------------------------------------------"
---------------------------------------------------------------------------
 
"
fi
fi
# List already existing VM's and ask for vmID
# List already existing VM's and ask for vmID
echo "== Printing list of VM's on this hypervisor!
echo "== Printing list of VM's on this hypervisor!"
 
"
qm list
qm list
echo ""
echo ""
Line 104: Line 98:
   --cores 1 \
   --cores 1 \
   --virtio0 local:$vmID/vm-$vmID-disk-1.qcow2
   --virtio0 local:$vmID/vm-$vmID-disk-1.qcow2
echo "
echo "############## End of Script ##############"
 
############## End of Script ##############"
 
</pre>
</pre>


==== Useful tips ====
==== Useful tips ====


* Useful snippet to clean sh file from Windows formatting that may interfere with script if it's edited on Windows workstation: "sed -i -e 's/\r$//' *.sh"
* Useful snippet to clean up the BASH script from Windows formatting that may interfere with script if it's edited on a Windows workstation:
<pre>sed -i -e 's/\r$//' *.sh</pre>

Latest revision as of 11:30, 20 December 2021

  • Create a new guest with the system disk and other devices as required.
  • Then you have to manually upload the CHR disk (in qcow format) on the ProxMox host.
  • Use scp or any other comparable tool as that will use SSH for the upload and it does not require any additional configuration.
  • Either copy the file to the server and then manually edit the VM's .conf file or replace previously created system image file used for booting the guest.
  • Local storage on ProxMox is in /var/lib/vz directory. There should be a subdirectory called images with a directory for each VM (named by the VM number). You can copy the files directly there.
  • For adding the existing file to the VM, edit the VM's .conf file directly. Look in /etc/pve/qemu-server/ for a file with the VM number followed by .conf.

Note: It's a good idea to create a second test VM so you can refer to it's .conf file to make sure you get the syntax right


Alternative approach

  • Create Basic VM via ProxMox web GUI.
  • Make sure that VM storage is on local storage (this way there will no need to work with LVM config side, and disk image can be moved later on to LVM or other desired storage if needed).
  • Log into ProxMox host via SSH and navigate to VM image directory. Default local storage is located in: var/lib/vz/images/(VM_ID)
  • Via scp, wget or any other tool download CHR raw image (.img file) into this directory.
  • Now convert the CHR raw image to qcow2 format using qemu-img tool:
qemu-img convert -f raw -O qcow2 chr-6.40.3.img vm-(VM_ID)-disk-1.qcow2

Bash script approach

If you have access to ProxMox host then CHR VM can also be created quickly via BASH script. Below example of one such script.

What this script does:

  • Stores tmp files in: /root/temp dir.
  • Downloads raw image archive from MikroTik download page.
  • Converts image file to qcow format.
  • Creates basic VM that is attached to MGMT bridge.
#!/bin/bash

#vars
version="nil"
vmID="nil"

echo "############## Start of Script ##############

## Checking if temp dir is available..."
if [ -d /root/temp ] 
then
    echo "-- Directory exists!"
else
    echo "-- Creating temp dir!"
    mkdir /root/temp
fi
# Ask user for version
echo "## Preparing for image download and VM creation!"
read -p "Please input CHR version to deploy (6.38.2, 6.40.1, etc):" version
# Check if image is available and download if needed
if [ -f /root/temp/chr-$version.img ] 
then
    echo "-- CHR image is available."
else
    echo "-- Downloading CHR $version image file."
    cd  /root/temp
    echo "---------------------------------------------------------------------------"
    wget https://download.mikrotik.com/routeros/$version/chr-$version.img.zip
    unzip chr-$version.img.zip
    echo "---------------------------------------------------------------------------"
fi
# List already existing VM's and ask for vmID
echo "== Printing list of VM's on this hypervisor!"
qm list
echo ""
read -p "Please Enter free vm ID to use:" vmID
echo ""
# Create storage dir for VM if needed.
if [ -d /var/lib/vz/images/$vmID ] 
then
    echo "-- VM Directory exists! Ideally try another vm ID!"
    read -p "Please Enter free vm ID to use:" vmID
else
    echo "-- Creating VM image dir!"
    mkdir /var/lib/vz/images/$vmID
fi
# Creating qcow2 image for CHR.
echo "-- Converting image to qcow2 format "
qemu-img convert \
    -f raw \
    -O qcow2 \
    /root/temp/chr-$version.img \
    /var/lib/vz/images/$vmID/vm-$vmID-disk-1.qcow2
# Creating VM
echo "-- Creating new CHR VM"
qm create $vmID \
  --name chr-$version \
  --net0 virtio,bridge=vmbr0 \
  --bootdisk virtio0 \
  --ostype l26 \
  --memory 256 \
  --onboot no \
  --sockets 1 \
  --cores 1 \
  --virtio0 local:$vmID/vm-$vmID-disk-1.qcow2
echo "############## End of Script ##############"

Useful tips

  • Useful snippet to clean up the BASH script from Windows formatting that may interfere with script if it's edited on a Windows workstation:
sed -i -e 's/\r$//' *.sh