Installing the Appliance Base Image¶
The Appliance Base Image can install the Anapaya Appliance on bare metal or as a
VM running on a hypervisor. The minimal system requirements are described in the
Computing resources guide.
The base image is provided in two different formats: (1) a qcow2
image purposed
for a fast setup of VM’s and (2) an ISO
image that can be used to provision bare
metal machines.
The images are hosted on cloudsmith.io. To download them, two pieces of information are required:
Access token
The access token is provided to you by Anapaya as part of your software license.
Base image version
The version of the base image needs to be specified. It consists of three parts: the anapaya system version, the anapaya scion version and a counter for the base image version. For example,
sys_v2.1.0-scion_v0.32.3-1
is an unique version identifying an appliance base image. It specifies theanapaya-system
package version 2.1.0 and theanapaya-scion
package version 0.32.1. The last number is a build counter which is increased if there are multiple builds per version combination.
To download the qcow2
image, use the following command:
# BIOS Version wget https://dl.cloudsmith.io/$ACCESS_TOKEN/anapaya/stable/raw/names/anapaya-appliance-base-bios-qcow2/versions/latest/anapaya-appliance-base-bios-$VERSION.qcow2 # UEFI Version wget https://dl.cloudsmith.io/$ACCESS_TOKEN/anapaya/stable/raw/names/anapaya-appliance-base-uefi-qcow2/versions/latest/anapaya-appliance-base-uefi-$VERSION.qcow2
To download the ISO
image, use the following command:
wget https://dl.cloudsmith.io/$ACCESS_TOKEN/anapaya/stable/raw/names/anapaya-appliance-base/versions/latest/anapaya-appliance-base-$VERSION.iso
Note
The variables ($VERSION
, $ACCESS_TOKEN
) in the commands can either be
replaced directly or set as environment variables.
Note
The Anapaya Appliance Base Image is a full system image that includes all the necessary modules to bootstrap an Anapaya Appliance instance. The system image is hardened by Anapaya. However, the configuration and hardening of the host or hypervisor that hosts the Anapaya Appliance is the responsibility of the user. Please refer to the corresponding vendor guidelines and best practices.
Install the base image on a hypervisor¶
Copy the
qcow2
image to the hypervisor and install it according to the platform documentation.Allocate resources to the Anapaya Appliance (at least 4G of RAM and 2-4 vCPUs) and then boot the VM.
Install the base image on bare metal¶
Create bootable USB installer on Ubuntu¶
Insert a USB drive and find its device name path (e.g.
/dev/sdb
) by running the following command (look for type disk):lsblk
Unmount the USB device in case it is mounted, by running:
sudo umount /dev/<usb-dev>
Burn the ISO to the USB drive
sudo dd bs=4M if=<path-to-iso> of=/dev/<usb-dev> status=progress oflag=sync conv=fsync
Note
If your machine is running Windows or macOS or you prefer a GUI, you can download a tool
such as Etcher, to burn the ISO
image to a
USB drive to complete this step.
Configure the installer¶
In this optional step, you can configure the installer such that no interaction is required after initiating the boot.
To store the base installer user configuration on the USB drive, mount the third partition of the USB device, by running:
sudo mount /dev/<usb-dev>3 /mnt
Create an installer configuration file at
/mnt/anapaya-user-config.yaml
containing the boot disk name, and a parameterpoweroff_final
to make the machine power off, once the installation has been completed.disk: sda poweroff_final: true
There are a few more parameters that can be configured depending on your setup. Only set the listed parameters if you are sure you need to change the default value.
installer parameters:
# Hostname: the target system's hostname. hostname: anapaya-appliance # User: the default user name user: anapaya # Password: the default user password. password: anapaya # InteractiveNetworkSetup: If non-interactive network setup, the installer configures IPv4 DHCP on all interfaces. interactive_network_setup: false # Disk: the system's disk name to install the software (default not set). # When no disk is configured, it implies interactive storage setup which is the # default behavior. # Based on the disk size, the layout would be as follow: # - < 12GB: not supported # - < 20GB: 8GB root lvm partition, leftover space for the var lvm partition # - < 40GB: 16GB root lvm partition, leftover space for the var lvm partition # - >= 40GB: 24GB root lvm partition, leftover space for the var lvm partition disk: sde # PowerOffPreBoot: when `true`, it will shutdown the system before the first boot. poweroff_preboot: false # PowerOffFinal: when `true`, it will shutdown the system after the installation has completed. poweroff_final: false
Unmount the third partition, by running:
sudo umount /dev/<usb-dev>3 /mnt
Boot from the installer¶
Insert the USB media into the target system and initiate the boot sequence by powering on the machine.
Note
It might be necessary to change the boot order preference settings in the BIOS of the machine to favour USB devices.
If you added a configuration to the installer, the installation will start automatically, otherwise you need to select the installation target disk manually. During the installation process, the machine will restart a few times.
Note
During the final step of the installation, the OS is booted and a login prompt appears. To check the installation progress you can authenticate with the default credentials, or the credentials that were configured and run:
watch cloud-init status
After the installation has completed, the machine shuts itself down.
Next steps¶
You are now ready to provision the Anapaya Appliance. You can login via SSH or
use the management API that is exposed on all interfaces. The default
credentials are anapaya:anapaya
.
Warning
Make sure to immediately change the SSH and API credentials. Otherwise the security of your device might be compromised.
A good place to start is the Connecting to the Appliance section. If you are already familiar with the appliance configuration, you can also use the Appliance Configuration Reference to set up and configure the appliance.