# Artifacts

## What is an Artifact?

An artifact is simply a smaller component or informational property of a larger object, resource, or service that acts in a manner to produce or determine an intended output. It can also be defined as the logic that defines what elements of a deployment have to be installed and how. These informational pieces are created to be used for the deployment and operation of a system.

## Airctl and Helpers

The following artifacts are used to aid in the implementation and configuration of the different airctl elements.

* *airctl-.tar.gz*: This compressed file contains the airctl binary. This is the primary CLI tool used for management of the Platform9 Self Managed Cloud Platform (SMCP)
* *airctl-scripts-.tar.gz*: This compact file contains all the associated scripts used by airctl
* install.sh: Script to install the downloaded artifacts to proper location on the node
* nodelet.tar.gz: This file contains the nodelet package needed for the management cluster creation. We have nodelet-deb.tar.gz for ubuntu 22.04 OS.

## Offline Packages

The following artifacts are primarily employed for offline (or air-gapged) edge cloud installations.

* *hostagent-.tar.gz*: This file contains the yum or apt repo information for the platform9 agents running on the hosts. Platform9 automatically deploys this and sets up the repository.
  * Note: Depending on the OS of the nodes being onboarded, users might have to specify different variant of this in the airctl-config.yaml
    * Centos7.9: hostagent-.tar.gz
    * RHEL 8.5, RHEL 8.6: hostagent-8-.tar.gz
    * Rocky linux 9.2: hostagent-9-.tar.gz
    * Ubuntu 22.04: hostagent-ubuntu-.tar.gz
* *docker-.tar.gz*: Similar to the file above, it can be installed using Platform9 *airctl* command.
  * Note: Depending on the OS of the nodes being onboarded, users might have to specify different variant of this in the airctl-config.yaml
    * Centos7.9: docker-.tar.gz
    * RHEL 8.5, RHEL 8.6: docker-8-.tar.gz
    * Rocky linux 9.2: docker-9-.tar.gz
    * Ubuntu 22.04: docker-ubuntu-.tar.gz
* *docker-imgs-.tar.gz*: This file contains all the docker images that Platform9 initially requires. Airctl can add it to the cache of every host.
* *pf9-kube-.tar.gz*: This file contains the packages needed for a Kubernetes multi-version implementation
* nodelet-imgs-.tar.gz: It contains the images needed for the management base kubernetes cluster creation.
* kubedu-imgs-.tar.gz: It contains the images needed to bring up the SMCP management plane.
* k8s--.tar.gz: This file contains the images needed for specific kube versions and addons which we upload to DU registry for the workload cluster nodes.

## Installed File Locations

Once setup, all the installed files are located under the `/opt/pf9/airctl` directory.

{% tabs %}
{% tab title="Bash" %}

```bash
[centos@test-pf9-du-host-airgap-c7-3246245-310 airctl]$ ls -la
total 1062408
drwxr-xr-x. 7 centos root          4096 May  2 11:45 .
drwxr-xr-x. 8 pf9    pf9group       121 May  2 11:58 ..
-rwxr-xr-x. 1 centos centos   126097165 Apr 30 11:18 airctl
drwxr-xr-x. 7 centos centos        4096 May  2 12:25 conf
-rw-rw-r--. 1 centos centos   160695185 May  2 11:45 docker-8-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos   151283967 May  2 11:45 docker-9-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos    48595990 May  2 11:45 docker-ubuntu-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos   139954392 May  2 11:45 docker-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos   130617606 May  2 11:44 hostagent-8-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos   122842610 May  2 11:45 hostagent-9-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos   116555543 May  2 11:45 hostagent-ubuntu-v-5.10.0-3242354.tar.gz
-rw-rw-r--. 1 centos centos    91233770 May  2 11:44 hostagent-v-5.10.0-3242354.tar.gz
drwxr-xr-x. 2 centos root          4096 May  2 11:44 imgs
drwxr-xr-x. 2 centos root            54 May  2 11:37 nodelet
drwxr-xr-x. 2 centos root            29 May  2 11:37 pf9-kube
drwxr-xr-x. 2 centos centos         281 Apr 30 11:16 scripts
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.platform9.com/self-managed-cloud-platform/5.13/sso-configuration/artifacts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.