Getting Started

This guide provides step-by-step instructions for installing and configuring the Fentrica baseVIRTUAL on a Debian-based Linux system.

System Requirements

Required packages:

• Avahi Libraries
• Boost Libraries
• Docker & Docker Compose

Installing Docker

Configuring the Docker APT Repository

Before installing Docker, configure the Docker APT repository:

apt-get install curl

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null

apt-get update

Installing Docker and Docker Compose

Install the required Docker packages:

apt-get install --no-install-recommends docker-ce docker-ce-cli containerd.io docker-compose

Applying Configuration and License

The baseVIRTUAL configuration and license files are provided by the Fentrica Support Team. Extract the provided archive to /var/larvaio:

tar -C /var -Jxf ADONIS_BLUE-x86-64-mock-sn.tar.xz

Installing the Fentrica Daemon Service

The Fentrica Daemon Service (larva-daemon) is responsible for:

• Managing baseVIRTUAL software updates
• Performing operating system-related tasks, such as reboots

Installing Required Dependencies

Before installing the daemon, ensure the necessary dependencies are installed:

apt-get install libavahi-client3 libavahi-common3 libboost-filesystem1.74.0

Download and Install Larva-Daemon

Download the latest larva-daemon package:

wget https://larva-daemon.s3.eu-central-1.amazonaws.com/releases/0.3.9/larva-daemon-x86-64-0.3.9-76c22d6.deb

Install the package:

dpkg -i larva-daemon-x86-64-0.3.9-76c22d6.deb

Starting the Daemon Service

To enable automated maintenance of the baseVIRTUAL, start the daemon service:

systemctl start larva-daemon

This background service will download and execute the necessary Docker containers required to run the complete baseVIRTUAL.

Monitoring the Daemon Service

Check the service status using:

journalctl -t larva-daemon -f

Accessing the Controller

If the setup is successful, you will be able to access the baseVIRTUAL user interface via HTTP.

Browser Access

1. Open a web browser (Firefox, Safari, or Chrome)
2. Enter the server's IP address or hostname

Default Credentials

Important: Change the default passwords immediately after first login for security.

See System Users for details on role permissions.

Connecting to Fentrica Cloud

1. Log in to the controller's web interface
2. Navigate to the System tab
3. Enable Fentrica Cloud connection
4. Continue configuration via Fentrica Cloud

Important: If Fentrica Cloud Services are used, ensure that under the System section, "Fentrica Cloud" is enabled and that the baseVIRTUAL is connected to Fentrica Cloud Services.

Support

For any issues or additional guidance, please contact the Fentrica Support Team.