Difference between revisions of "Meteobridge VM on PROXMOX"

From meteobridge
Jump to: navigation, search
(Created page with " First step is that you download the KVM/QEMU compatible disk image [https://admin.meteobridge.com/files/meteobridge-mbx86-v1.0-16G.img.gz here]. File is in "gzip" format and...")
 
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
  
First step is that you download the KVM/QEMU compatible disk image [https://admin.meteobridge.com/files/meteobridge-mbx86-v1.0-16G.img.gz here]. File is in "gzip" format and needs to be decompressed first. Result is a rawdisk image file of about 16GB in size named "meteobridge-mbx86-v1.0-16G.img".
+
When there is a PROXMOX VE installed on your machine you can use the Meteobridge VM raw image (used for KVM) to setup a Meteobridge within your PROXMOX environment.  
Next steps are related to build the Meteobridge VM within KVM based on the downloaded disk image.
+
  
* Access the KVM Virtual Machine Manager and define a new VM.
+
First step is to create a new Meteobridge VM within your PROXMOX environment.
* Select mode "Import existing disk image".<BR>[[File:kvm1.png|top|300px]] &nbsp;&nbsp; [[File:kvm2.png|top|300px]]
+
* Direct your browser to the PROXMOX Web GUI and press "Create VM" button.<BR>[[File:pm1.png|top|800px]]
* To provide an existing storage path, press the "Browse..." button.
+
* Insert "Meteobridge" as the name of the new VM and notice the VM ID (here "100") as you will need this later on to generate a disk image for this specific VM.
* Select a storage pool from the left. "default" might be a good choice unless you have not defined a specific one for your VMs. Having selected the VM pool your will see a list of already defined VMs. You also see the physical location of the VM pool. Here it is "/var/lib/libvirt/images".<BR>[[File:kvm3.png|top|300px]] &nbsp;&nbsp; [[File:kvm4.png|top|450px]]
+
* Goto "OS" tab and select "Do not use any media" and set "Guest OS" type to "Other".<BR>[[File:pm2.png|top|400px]] &nbsp;&nbsp; [[File:pm3.png|top|400px]]
* No go to your command shell and generate a new folder for Meteobridge in your VM pool. On linux doing so looks like this (you may need to be root to do so, therefore the preceding "sudo"): <pre>sudo mkdir /var/lib/libvirt/images/Meteobridge</pre>
+
* Goto "Memory" tab and insert 256 MB as memory size. This is enough for Meteobridge and it will not benefit from more.
* Next the downloaded and decompressed Meteobridge disk image file needs to be copied into this folder. <pre>sudo cp /path-to-where-you-downloaded-the-file/meteobridge-mbx86-v1.0.img /var/lib/libvirt/images/Meteobridge/</pre>
+
* Settings on the other tabs can stay at default values. Goto "Confirm" tab to check that all settings are like in the example below. Then press "Finish".<BR>[[File:pm4.png|top|400px]] &nbsp;&nbsp; [[File:pm5.png|top|400px]]
* To make the newly created directory available press the reload circles besides the "Volumes" label. In the example "Meteobridge" now appears as a new volume.
+
* As a result a new VM named "Meteobridge" with a dedicated VM ID (here "100") is created. You may need to click onto the "pve" row to make the newly created VM visible.<BR>[[File:pm6.png|top|800px]]
* Press "Browse Local" button and navigate with help of the "Filesystem" entry down to the Meteobridge VM image file. For orientation you see the stepping down into folders on the top line. When you finally reach the image file, select it and press "Open".<BR>[[File:kvm5.png|top|420px]] &nbsp;&nbsp; [[File:kvm6.png|top|450px]]
+
 
* Being back to the calling menu, please insert "other" into the search bar. A dialog presenting item "Generic default (generic)" will pop up. Double click the entry.
+
Now it is time to attach the Meteobridge image file to the created VM.
* Now you are back to the calling menu with the information filled in as in the example below. Press "Forward".<BR>[[File:kvm8.png|top|400px]] &nbsp;&nbsp; [[File:kvm7.png|top|400px]]
+
* First step is to bring the Meteobridge Image onto your PROXMOX environment. We recommend to login via SSH on the PROXMOX VE as user "root" and then to download the Meteobridge raw image via wget on the command line.
* KVM now needs some additional information for setting up the VM. Select 256 MB for RAM and 1 processor (this will be perfectly fine for Meteobridge). Then press "Forward".
+
<pre>wget -O meteobridge.img.gz https://admin.meteobridge.com/files/meteobridge-mbx86-v1.0-16G.img.gz</pre>
* Last step is to give the new VM a name, please check that "Bridge" is selected as network option (should be default) and "Customize configuration before install" to do some additionel settings later on. Then press "Finish".<BR>[[File:kvm10.png|top|400px]] &nbsp;&nbsp; [[File:kvm9.png|to|400px]]
+
* The downloaded compressed image needs to be uncompressed. This will take some time and results into a 16GB image file.
* It will only take a few seconds to build and start the VM. You will see the VM starting into the GRUB boot loader and then booting automatically. The booting is done when Meteobridge VM does tell you the IP where to reach the Meteobridge GUI in your LAN.<BR>[[File:kvm11.png|top|400px]] &nbsp;&nbsp; [[File:kvm12.png|top|400px]]
+
<pre>gunzip meteobridge.img.gz</pre>
* When you have a weather station connected via USB then you need to tell the host that this USB connection should be handed over to the Meteobridge VM. THis is done via the "Virtual Machine - Redirect USB device" option in the menu. In the example a Meteostick which makes use of a FTDI converter is used. Therefore, the FTDI entry is selected.<BR>[[File:kvm13.png|top|400px]] &nbsp;&nbsp; [[File:kvm14.png|top|300px]]
+
* Next step is to make the disk image available for your Meteobridge VM. You do that by issuing the following command (if your Meteobridge VM ID is not "100" replace "100" in the command below with the proper VM ID:
* Now you can direct your browser to the IP shown at the end of the console boot messages to start working with Meteobridge. HTTP default user is "meteobridge" and password is "meteobridge" too.
+
<pre>qm disk import 100 meteobridge.img local-lvm -format raw</pre>
 +
* PROXMOX will create the new disk and it will be named "unused0:local-lvm:vm-100-disk-1" or alike.
 +
 
 +
Now you can exit the command line and continue the setup with the Web GUI.
 +
* Select "Hardware" section of the Meteobridge VM. You will see an "Unused Disk 0" which is exactly the one just created via the command line.<BR>[[File:pm7.png|top|800px]]
 +
* Double click on the "Unused Disk" entry and you will see disk details. Click onto "Add" to add this disk to your Meteobridge VM.<BR>[[File:pm8.png|top|400px]]
 +
* As a result two disks will show up as being attached to your Meteobridge VM.
 +
* Select the disk "ide0" (which has been initially added to the Meteobridge VM as default) and detach this disk by clicking the "Detach" button.<BR>[[File:pm9.png|top|800px]]
 +
* PROXMOX will ask you to confirm this operation, Press "Yes".<BR>[[File:pm10.png|top|300px]]
 +
* Having done so the Meteobridge VM now only has one disk attached, the one you have imported by your command line interaction. Next step is to change the boot order. You can do that via the menu entry "Options". Double click "Boot Order" to apply changes.<BR>[[File:pm11.png|top|800px]]
 +
* Make sure that only "ide1" is enabled for boot and press "OK".<BR>[[File:pm12.png|top|400px]]
 +
* Check in the overview that boot order settings have been applied correctly.<BR>[[File:pm13.png|top|800px]]
 +
* Last thing to do is to make the weather station connected via USB to your server available to the Meteobridge VM. Add "USB Device" at the "Hardware" section.<BR>[[File:pm16.png|top|800px]]
 +
* In case of a Meteostick select "Use USB Vendor/Device ID" option and select "FT232R USB UART" which is the USB-serial converter used by the Meteostick. Confirm selection by pressing "Add". <BR>[[File:pm17.png|top|400px]]
 +
* Now select "Console" operation and press "Start". Meteobridge VM will start into GRUB and will boot a few seconds later.<BR>[[File:pm14.png|top|800px]]
 +
* When boot has finished you will see the hint in the log that Meteobridge is now operational and it will also tell you the IP where to access the Web GUI of Meteobridge.<BR>[[File:pm15.png|top|800px]]
 +
* Now you can direct your browser to this IP to start working with Meteobridge. HTTP default user is "meteobridge" and password is "meteobridge", too.

Latest revision as of 13:18, 20 May 2024

When there is a PROXMOX VE installed on your machine you can use the Meteobridge VM raw image (used for KVM) to setup a Meteobridge within your PROXMOX environment.

First step is to create a new Meteobridge VM within your PROXMOX environment.

  • Direct your browser to the PROXMOX Web GUI and press "Create VM" button.
    Pm1.png
  • Insert "Meteobridge" as the name of the new VM and notice the VM ID (here "100") as you will need this later on to generate a disk image for this specific VM.
  • Goto "OS" tab and select "Do not use any media" and set "Guest OS" type to "Other".
    Pm2.png    Pm3.png
  • Goto "Memory" tab and insert 256 MB as memory size. This is enough for Meteobridge and it will not benefit from more.
  • Settings on the other tabs can stay at default values. Goto "Confirm" tab to check that all settings are like in the example below. Then press "Finish".
    Pm4.png    Pm5.png
  • As a result a new VM named "Meteobridge" with a dedicated VM ID (here "100") is created. You may need to click onto the "pve" row to make the newly created VM visible.
    Pm6.png

Now it is time to attach the Meteobridge image file to the created VM.

  • First step is to bring the Meteobridge Image onto your PROXMOX environment. We recommend to login via SSH on the PROXMOX VE as user "root" and then to download the Meteobridge raw image via wget on the command line.
wget -O meteobridge.img.gz https://admin.meteobridge.com/files/meteobridge-mbx86-v1.0-16G.img.gz
  • The downloaded compressed image needs to be uncompressed. This will take some time and results into a 16GB image file.
gunzip meteobridge.img.gz
  • Next step is to make the disk image available for your Meteobridge VM. You do that by issuing the following command (if your Meteobridge VM ID is not "100" replace "100" in the command below with the proper VM ID:
qm disk import 100 meteobridge.img local-lvm -format raw
  • PROXMOX will create the new disk and it will be named "unused0:local-lvm:vm-100-disk-1" or alike.

Now you can exit the command line and continue the setup with the Web GUI.

  • Select "Hardware" section of the Meteobridge VM. You will see an "Unused Disk 0" which is exactly the one just created via the command line.
    Pm7.png
  • Double click on the "Unused Disk" entry and you will see disk details. Click onto "Add" to add this disk to your Meteobridge VM.
    Pm8.png
  • As a result two disks will show up as being attached to your Meteobridge VM.
  • Select the disk "ide0" (which has been initially added to the Meteobridge VM as default) and detach this disk by clicking the "Detach" button.
    Pm9.png
  • PROXMOX will ask you to confirm this operation, Press "Yes".
    Pm10.png
  • Having done so the Meteobridge VM now only has one disk attached, the one you have imported by your command line interaction. Next step is to change the boot order. You can do that via the menu entry "Options". Double click "Boot Order" to apply changes.
    Pm11.png
  • Make sure that only "ide1" is enabled for boot and press "OK".
    Pm12.png
  • Check in the overview that boot order settings have been applied correctly.
    Pm13.png
  • Last thing to do is to make the weather station connected via USB to your server available to the Meteobridge VM. Add "USB Device" at the "Hardware" section.
    Pm16.png
  • In case of a Meteostick select "Use USB Vendor/Device ID" option and select "FT232R USB UART" which is the USB-serial converter used by the Meteostick. Confirm selection by pressing "Add".
    Pm17.png
  • Now select "Console" operation and press "Start". Meteobridge VM will start into GRUB and will boot a few seconds later.
    Pm14.png
  • When boot has finished you will see the hint in the log that Meteobridge is now operational and it will also tell you the IP where to access the Web GUI of Meteobridge.
    Pm15.png
  • Now you can direct your browser to this IP to start working with Meteobridge. HTTP default user is "meteobridge" and password is "meteobridge", too.