# Setup leap Micro

[leap Micro](https://get.opensuse.org/leapmicro/5.3/) is a transactional linux distribution using openSUSE packages from [openSUSE Leap](https://get.opensuse.org/leap/15.4/).
It roughly follows [SLE Micro](https://www.suse.com/products/micro/) (commercial)

## Upgrade to next version

[There is a tool for this now](https://github.com/openSUSE/opensuse-migration-tool): `opensuse-migration-tool`

Do as `root`:

```
transactional-update shell
zypper --releasever=5.x dup
exit
reboot; exit
```

## Troubleshooting

### ceph csi can't load modules

The ceph csi containers can not load modules on this distribution yet (ZSTD compressed ko files).
As there are exactly two modules to load a file `ceph.conf` in `/etc/modules-load.d` will do
```
rbd
ceph
```

### Can not create /mnt/local-disks

In flatcar linux it was no issue to mount local disks for K8s in `/mnt/local-disks`.  
In leap Micro `/mnt` is read only so no `local-disks` folder can be created.

```bash
btrfs subvolume create /opt/mnt
# edit /etc/fstab and copy the mount line for opt, change the subvol to /opt/mnt and the mount point to/mnt
# UUID=... /mnt btrfs defaults,subvol=@/opt/mnt 0 0
vi /etc/fstab
mount /mnt
```