joseivanlopez / agama-product-selection.md

Last active November 13, 2025 07:42

Product Selection

What to do when applying a config:

if the product is unknown (invalid, missing):
- add product issue
- keeps the current config and proposal (if any)
- report 400

PUT: the config must indicate a valid product.

joseivanlopez / agama-ui-hooks.md

Last active November 5, 2025 14:56

api.ts
/api/system

queries.ts

hooks/system.ts
hooks/l10n/system.ts
hooks/storage/system.ts

joseivanlopez / agama-organization.md

Last active October 31, 2025 07:34

Current files tree

agama
    CONTRIBUTING.md
    PACKAGING.md
    LICENSE
    PULL_REQUEST_TEMPLATE.md
    README.md
 SECURITY.md

joseivanlopez / agama-new-storage-api.md

Last active October 22, 2025 10:52

New Storage API

Current D-Bus API

org.opensuse.Agama.Storage1                     interface -                     -
.Finish                                         method    -                     -
.GetConfig                                      method    -                     -
.GetConfigModel                                 method    -                     -
.Install method - -

joseivanlopez / agama-state.md

Last active October 6, 2025 12:11

Agama Status

The new API of Agama offers an end-point to retrieve the status of the installation (GET /status).

The status contains the installation state and the progress of each scope in a single JSON file.

Installation State

The installation can be in one of the following states:

joseivanlopez / agama-new-api.md

Last active September 26, 2025 06:27

New HTTP API

The new API is designed around 3 main concepts: system, config and proposal.

system: represents the current status of the running system.
config: represents the configuration for installing the target system.
proposal: represents what is going to be done in the target system.

The config contains elements that can modify the system, the proposal or both. For example, the dasd config changes the system, and the storage config changes the proposal. In other cases like network, the config can affect to both system and proposal.

joseivanlopez / agama-reprobe.md

Last active July 4, 2025 06:54

Agama and Probing

This document analyzes when Agama probes the system and what problems the current approach has, and proposes a possible solution.

When Agama needs to Probe

After selecting a product: a complete probe (software, storage, etc).
After registering a product: a complete probe but keeping some settings (a.k.a., reprobe). For example, storage settings should not be lost.
After editing iSCSI, DASD, zFCP: a storage reprobe.

joseivanlopez / search-iscsi.md

Last active May 28, 2025 14:47

‎‎

joseivanlopez / agama-search-conditions.md

Last active May 7, 2025 10:43

Format for search conditions (storage schema)

Property, operator and value

{ property: "size", operator: "greater", value: "1 GiB" }

Problems:

joseivanlopez / storage_queries.md

Last active May 7, 2025 15:03

Challenges to solve with queries and hooks in storage

How to organize the model queries

In storage we have a JSON structure (model) and we need:

To get part of the model (e.g., a specific disk).
To get calculated information (e.g., whether a disk is the boot device).
To modify parts of the model (e.g., add a partition to a disk).

José Iván López joseivanlopez