Installing to Disk

BurmillaOS comes with a simple installer that will install BurmillaOS on a given target disk. To install BurmillaOS on a new disk, you can use the ros install command. Before installing, you’ll need to have already booted BurmillaOS from ISO. Please be sure to pick the burmillaos.iso from our release page.

Installing BurmillaOS

The ros install command orchestrates the installation from the burmilla/os container. You will need to have already created a cloud-config file and found the target disk.

Cloud-Config

The easiest way to log in is to pass a cloud-config.yml file containing your public SSH keys. To learn more about what’s supported in our cloud-config, please read our documentation.

The ros install command will process your cloud-config.yml file specified with the -c flag. This file will also be placed onto the disk and installed to /var/lib/rancher/conf/. It will be evaluated on every boot.

Create a cloud-config file with a SSH key, this allows you to SSH into the box as the rancher user. The yml file would look like this:

#cloud-config
ssh_authorized_keys:
  - ssh-rsa AAA...

You can generate a new SSH key for cloud-config.yml file by following this article.

Copy the public SSH key into BurmillaOS before installing to disk.

Now that our cloud-config.yml contains our public SSH key, we can move on to installing BurmillaOS to disk!

$ sudo ros install -c cloud-config.yml -d /dev/sda
INFO[0000] No install type specified...defaulting to generic
Installing from burmilla/os:v2.0.0
Continue [y/N]:

For the cloud-config.yml file, you can also specify a remote URL, but you need to make sure you can get it:

$ sudo ros install -c https://link/to/cloud-config.yml

You will be prompted to see if you want to continue. Type y.

Unable to find image 'burmilla/os:v2.0.0' locally
v2.0.0: Pulling from burmilla/os
...
...
...
Status: Downloaded newer image for burmilla/os:v2.0.0
+ DEVICE=/dev/sda
...
...
...
+ umount /mnt/new_img
Continue with reboot [y/N]:

Starting from BurmillaOS v3.0.x, ros install uses the boot mode in which the ISO was booted: in UEFI mode the disk is partitioned as GPT with an EFI system partition, in BIOS mode a single MBR partition is used. See Upgrading to v3 for details. BurmillaOS v2.0.x supports BIOS boot only.

After installing BurmillaOS to disk, you will no longer be automatically logged in as the rancher user. You’ll need to have added in SSH keys within your cloud-config file.

Installing a Different Version

By default, ros install uses the same installer image version as the ISO it is run from. The -i option specifies the particular image to install from. To keep the ISO as small as possible, the installer image is downloaded from DockerHub and used in System Docker. For example for BurmillaOS v2.0.0 the default installer image would be burmilla/os:v2.0.0.

You can use ros os list command to find the list of available BurmillaOS images/versions.

$ sudo ros os list
burmilla/os:v2.0.0 local

Alternatively, you can set the installer image to any image in System Docker to install BurmillaOS. This is particularly useful for machines that will not have direct access to the internet.

Caching Images

Some configurations included in cloud-config require images to be downloaded from Docker to start. After installation, these images are downloaded automatically by BurmillaOS when booting. An example of these configurations are:

• rancher.services_include
• rancher.console
• rancher.docker

If you want to download and save these images to disk during installation, they will be cached and not need to be downloaded again upon each boot. You can cache these images by adding -s when using ros install:

$ ros install -d <disk> -c <cloud-config.yaml> -s

SSH into BurmillaOS

After installing BurmillaOS, you can ssh into BurmillaOS using your private key and the rancher user.

$ ssh -i /path/to/private/key rancher@<ip-address>

Installing with no Internet Access

If you’d like to install BurmillaOS onto a machine that has no internet access, it is assumed you either have your own private registry or other means of distributing docker images to System Docker of the machine. If you need help with creating a private registry, please refer to the Docker documentation for private registries.

In the installation command (i.e. sudo ros install), there is an option to pass in a specific image to install. As long as this image is available in System Docker, then BurmillaOS will use that image to install BurmillaOS.

$ sudo ros install -c cloud-config.yml -d /dev/sda -i <Image_Name_in_System_Docker>
INFO[0000] No install type specified...defaulting to generic
Installing from <Image_Name_in_System_Docker>
Continue [y/N]: