Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Copy cloud-in-a-box guide to new location #758

Merged
merged 1 commit into from
Jan 15, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/cloud-in-a-box/images/broken-disk-setup.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cloud-in-a-box/images/disk-layout.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cloud-in-a-box/images/issue.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/cloud-in-a-box/images/netdata-high-load.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
467 changes: 467 additions & 0 deletions docs/cloud-in-a-box/index.md

Large diffs are not rendered by default.

98 changes: 98 additions & 0 deletions docs/cloud-in-a-box/running-on-a-virtual-machine.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
# Running on a virtual machine

## KVM

### Nested virtualization

You likely want to run virtual machines on top of your Cloud in a Box.
The host machine has to support and enabled nested virtualization.

To enable nested virtualization the CPU configuration of the VM has to be `host-passthrough` or `host-model`

* [Enabling nested virtualization in Fedora](https://docs.fedoraproject.org/en-US/quick-docs/using-nested-virtualization-in-kvm/)

The linked guide can be used in other distributions as well.

### Disk space saving

When using Cloud in a Box in a VM, you can utilize the qcow2 disk image or similar technology to save space.
In that case, the base installation requires just around 70 GB instead of a full 1 TB.
(*The drive still needs to be made with a capacity of at least 1TB; however, the actual disk space usage is lower.*)

Also in case you want to experiment a bit more and "hack around" using the manual installation
you can make disk snapshots when turned off after the Ubuntu installs, `bootstrap.sh` and `deploy.sh` to speed up your
progress.

If you use qemu, you can use following command to do snapshots.

```bash
sudo virsh snapshot-create-as --domain cib bootstrap "run of bootstrap.sh" --disk-only --diskspec sda,snapshot=external,file=/var/lib/libvirt/images/ub2022_cib_boostrap.qcow2 --atomic
```

### QEMU guest agent

When running inside QEMU, it may be worth it to install the QEMU guest agent.

```bash
sudo apt -y install qemu-guest-agent
sudo systemctl enable qemu-guest-agent
sudo systemctl start qemu-guest-agent
```

## VMware vSphere/ESXi

When running Cloud in a Box on a VMware vSphere/ESXi virtual machine, you can use the below specs to configure the virtual machine:

### Guest OS:

* Compatibility set to current running vSphere/ESXi version
* Guest OS family set to "Linux"
* Guest OS version set to "Ubuntu Linux (64-bit)"


### Hardware:

* 32GB RAM
* 8 vCores
* SCSI Controller 0 set to LSI Logic Parallel
* SCSI Disk with 500GB
* CDROM/DVD drive mounted with ubuntu-autoinstall-cloud-in-a-box-1.iso image
* Firmware set to "EFI" (VM Options > Boot Options > Firmware > choose EFI)

This configuration has been successfully tested with VMware ESXi 7.0 U1.


## VirtualBox

When running Cloud in a Box on a VirtualBox, you can use the the blow specs for configure the virtual machine:

### General:

* Type Linux
* Version Ubuntu (64-bit)

### System:

* 32GB RAM
* 8 Processors
* Enable PAE/NX
* Enable Nested VT-x/AMD-v
* Extended Feature: Enable EFI (special OSes only)

### Storage:

* Controller: SATA
* Type AHCI
* Use Host I/O Cache
* Disc Size 600 GB

* Controller: IDE
* Optical Drive: IDE Secondary Device
* Live CD/DVD
* Insert the ubuntu-autoinstall-cloud-in-a-box-1.iso image

* Boot Order: Set Optical as first boot device

This configuration has been successfully tested with VirtualBox 6.1.50 using an Ubuntu 22.04 Host with HWE Kernel 6.5.0
The more CPU, RAM and Disc the better, as this is the bare minimum for a basic installation.