AIL-framework/other_installers/LXD/README.md

AIL-framework-LXD

This installer is based on the LXD container manager and can be used to install AIL on Linux. It also supports the installation of Lacus a crawler for the AIL framework.

Requirements

• LXD 5.19
• jq 1.6

Usage

Make sure you have all the requirements installed on your system.

Interactive mode

Run the INSTALL.sh script with the --interactive flag to enter the interactive mode, which guides you through the configuration process:

bash INSTALL.sh --interactive

Non-interactive mode

If you want to install AIL without the interactive mode, you can use the following command:

bash INSTALL.sh [OPTIONS]

The following options are available:

Flag	Default Value	Description
-i, --interactive	N/A	Activates an interactive installation process.
--project <project_name>	AIL-<creation_time>	Name of the LXD project for organizing and running the containers.
--ail-name <container_name>	AIL-<creation_time>	The name of the container responsible for running the AIL application.
--no-lacus	false	Determines whether to install the Lacus container.
--lacus-name <container_name>	LACUS-<creation_time>	The name of the container responsible for running the Lacus application.
--partition <partition>	<none>	Dedicated partition for LXD-project storage.

Configuration

If you installed Lacus, you can configure AIL to use it as a crawler. For further information, please refer to the HOWTO.md

Using Images to run AIL

If you want to use images to install AIL, you can download them from the ail-project image website

After downloading the images, you can import them into LXD using the following command:

lxc image import <path_to_image> --alias <image_alias>

Now you can use the image to create a container:

lxc launch <image_alias> <container_name>

To log into the container you need to know the automatically generated password. You can get it with the following command:

lxc exec <container_name> --  bash -c "grep '^password=' /home/ail/ail-framework/DEFAULT_PASSWORD | cut -d'=' -f2"

If you also want to use Lacus, you can do the same with the Lacus image. After that, you can configure AIL to use Lacus as a crawler. For further information, please refer to the HOWTO.md.

Building the images locally

If you want to build the images locally, you can use the build.sh script:

bash build.sh [OPTIONS]

Flag	Default Value	Description
--ail	false	Activates the creation of the AIL container.
--lacus	false	Activates the creation of the Lacus container.
--ail-name <container_name>	AIL	Specifies the name of the AIL container. The default is a generic name "AIL".
--lacus-name <container_name>	Lacus	Specifies the name of the Lacus container. The default is a generic name "Lacus".
-o, --outputdir <directory>	<none>	Sets the output directory for the LXD image files.
-s, --sign	false	Enables the signing of the generated LXD image files.