Docs
  • Home
  • Antsle One Setup
  • Antsle Nano Setup
  • Antsle Two Setup
  • Get Started
    • edgeLinux Installation
      • Installing edgeLinux on Oracle VirtualBox
    • Log in to the edgeLinux OS
    • Name Your Antsle/Nano
    • Setting Up Your Tech Stack
      • WordPress
      • Gitlab
      • Jenkins
  • Antlets
    • Antlets Overview
    • Create and Manage an Antlet
    • Antlet Details
    • Access Antlets
    • Virtual Drives
    • Backing Up Antlets
      • Self-Managed Restoration (Beta)
  • Templates
    • Templates Overview
    • Install OS from .iso
    • Import VM Images
    • Using the LEMP-Stack
    • Using Nextcloud
    • Using OPNsense
  • Networking
    • Networking Overview
    • Configure IP Addresses
    • Bridged Networking / Virtual NIC
    • Wifi on the Antsle Nano
    • Port Forwarding
    • Load Balancing
    • SDN: Software Defined Networking
  • System
    • Antsle Distributed Storage - ADS
    • Multi-Node
    • Secure (HTTPS) Access to Antman
    • Secure FTP (SFTP) Access
    • USB Drives
    • Docker Support
    • LDAP/SSO
    • antMan REST API
    • The antMan Terraform Provider
    • Access Your HDD (or SSD) Add-on
    • Setting Up Shared Storage Volume
    • edgeLinux OS
    • Windows License
  • antHill and Account Management
  • Troubleshooting
    • Reset edgeLinux on a Pi or Antsle Nano
    • Known Issues
  • FAQs
  • Protector Mode
Powered by GitBook
On this page
  • Overview
  • Virtual Machines and Bare-Metal Containers
  • Storage
  • Internal IP address assignment
  • How to Migrate from edgeLinux 1 (based on Gentoo) to edgeLinux 2.0
  • Step 1 - Get your systems ready
  • Step 2 - Back up any antlets that you want to keep
  • Step 3 - Do a fresh install of our OS
  • Step 4 - Activate new Antsle Server
  • Step 5 - Restore the backups to your new server

Was this helpful?

  1. System

edgeLinux OS

PreviousSetting Up Shared Storage VolumeNextWindows License

Last updated 2 years ago

Was this helpful?

Overview

edgeLinux OS is a type-1 , specialized for the needs of Antsle. You can see the system requirements on the .

It is based on CentOS and is a custom operating system with everything that’s needed to manage your virtual servers. It orchestrates the networking, backups, storage, etc. It has zero overhead on top of that. The result is a blazing fast hypervisor.

Virtual Machines and Bare-Metal Containers

edgeLinux OS supports two types of virtualization to create your antlets. While each antlet is a complete Virtual Private Server (VPS), LXC antlets use OS-based virtualization, a.k.a. containerization (popularized by docker), whereas KVM antlets use hardware-based virtualization with QEMU and KVM. For most cases, use LXC-based antlets because they create the least overhead and save resources including electricity. In that way, your Antsle is a green datacenter.

Storage

For storage, we use mirrored ZFS pools. ZFS is an advanced, feature rich file system designed to never allow any data loss or inconsistent state on the storage media. Combined with mirroring, our ZFS-based storage architecture offer excellent fault-tolerance and flexibility. We just thought your data is important – so we better keep it safe.

We use a ZFS pool (zpool) named “antlets” to store your antlets as well as the templates the antlets are created from. Try a zfs list or zfs list -t all to inspect the layout of ZFS file systems. The HDD add-on resides on a separate zpool named hdd.

Each antlet gets its own ZFS file system in the antlets pool, so it’s completely separated from the rest of the system (including other antlets). Mirroring, compression etc is all handled by ZFS inside edgeLinux OS and is completely transparant to the antlets themselves. In plain English: each and every antlet gets isolation, mirroring and compression for free, without having to take care of it in any way.

Internal IP address assignment

We have an integrated, internal DHCP server in edgeLinux OS, and each antlet will pull it's IP address from that DHCP server - unless you . This DHCP server will assign IP addresses based on Mac addresses:

b2:61:6e:73:6c:0a will receive 10.1.1.10
b2:61:6e:73:6c:0b will receive 10.1.1.11
b2:61:6e:73:6c:0c will receive 10.1.1.12
b2:61:6e:73:6c:0d will receive 10.1.1.13
...

In our pre-defined templates, we're always using those Mac addresses, and through our template XMLs we make sure that one of these MACs will be assigned.

How to Migrate from edgeLinux 1 (based on Gentoo) to edgeLinux 2.0

This is a new migration process and currently in beta. We cannot guarantee that your system will be in the state that you left it previously or that all your antlets will run on your new installation. This will not save any of the following:

  • Custom configurations that you did to your Antsle server,

  • Your port forwarding rules

  • Your snapshots

  • Virtual drives that are not on the main antlets zpool (those need to be backed up separately).

Step 1 - Get your systems ready

Check your settings tab in antMan, your version of antMan should should be 2.2.1 (or higher). Why is this important? Any antlet backups taken before this version can not be restored on edgeLinux 2.0. If your antMan is not up to date then run upgrade-antman in your console before taking backups in step two.

Step 2 - Back up any antlets that you want to keep

If you have any templates you want to keep, just create an antlet out of them and back them up as well

Important note: If your antlet has a virtual drive on a different zpool that will not be included in the back up. Read our docs article on backing up antlets for workarounds.

Step 3 - Do a fresh install of our OS

Step 4 - Activate new Antsle Server

At the on-boarding screen, select “this is Antsle hardware” and follow the prompts. This will give your new installation the same serial number and license as the original.

You must also register the Antsle on antHill when prompted in the on-boarding process. This will allow antHill to make the connection between your backups and this new server.

Step 5 - Restore the backups to your new server

Next log in to and make sure that your server is activated and visible there. antHill is the central hub and will allow you to restore backups across multiple Antsle servers.

or read our for a guide on how to back up and restore antlets. This tutorial assumes you will use the Antsle Cloud as your storage backend. Backups come with antMan Essential, Grow or Scale. You can see our plans and pricing . Once backups are enabled you can back up your antlets.

and follow the .

Restore backups from the "Heal antlets" section in antMan. Hop right over to the 0:45 time stamp at where we show you how to heal your antlets.

hypervisor
download page
create a bridge
antHill.antsle.com
Watch this 1 minute video
docs article
here
Download here
instructions in the docs for installation
this video