From 739dbba28949fb90f54c6f6d76039715ffeeb27c Mon Sep 17 00:00:00 2001 From: Ancor Gonzalez Sosa Date: Mon, 13 May 2024 10:37:27 +0200 Subject: [PATCH 1/2] Small fixes for README --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 91f13228f0..1a4ff7d281 100644 --- a/README.md +++ b/README.md @@ -36,14 +36,14 @@ Agama is a new Linux installer born in the core of the YaST team. It is designed ## Why a New Installer -This new project follows two main motivations: to overcome some of the limitations of YaST and to serve as installer for new projects like SUSE ALP (Adaptable Linux Platform). +This new project follows two main motivations: to overcome some of the limitations of YaST and to serve as installer for new projects, like those based on SUSE Linux Framework One. YaST is a mature installer and control center for SUSE and openSUSE operating systems. With more than 20 years behind it, YaST is a competent and flexible installer able to cover uncountable use cases. But time goes by, and the good old YaST is starting to show its age in some aspects: * The architecture of YaST is complex and its code-base has too much technical debt. * Designing and building rich and modern user interfaces is a real challenge. * Sharing logic with other tools like Salt or Ansible is very difficult. -* Some in-house solutions like libyui makes more difficult to contribute to the project. +* Some in-house solutions like [libyui](https://github.com/libyui/libyui) make more difficult to contribute to the project. ## Running Agama @@ -73,7 +73,7 @@ mDNS (sometimes called Avahi, Zeroconf, Bonjour) for hostname resolution. Theref > hostname resolutions and point you to a wrong Agama instance which could for example steal your > root password! -If you have troubles or you want to know more about this feature, check our [Avahi/mDNS] (./doc/avahi.md) documentation. +If you have troubles or you want to know more about this feature, check our [Avahi/mDNS](./doc/avahi.md) documentation. ## Other Resources From 4f98d9fbe741e8a22a4ca554f211252c7ceb8353 Mon Sep 17 00:00:00 2001 From: Ancor Gonzalez Sosa Date: Mon, 13 May 2024 10:41:22 +0200 Subject: [PATCH 2/2] Correct heading levels at avahi.md --- doc/avahi.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/doc/avahi.md b/doc/avahi.md index 659fcaa995..87e4f6af69 100644 --- a/doc/avahi.md +++ b/doc/avahi.md @@ -1,4 +1,4 @@ -#### Avahi/mDNS +# Avahi/mDNS Agama's Live ISO is configured to use mDNS (sometimes called Avahi, Zeroconf, Bonjour) for hostname resolution. The reason is that it might be quite difficult to find out which URL should be used for @@ -12,7 +12,7 @@ This document explains how this feature works and offers a few hints for fix pot > hostname resolutions and point you to a wrong Agama instance which could for example steal your > root password! -##### Firewall Configuration +## Firewall Configuration If you cannot connect to a server using the `.local` domain then maybe the firewall is blocking the traffic. Then you need to enable the mDNS traffic using @@ -25,7 +25,7 @@ firewall-cmd --zone=public --add-service=mdns firewall-cmd --permanent --zone=public --add-service=mdns ``` -##### Using mDNS +## Using mDNS The Live ISO by default uses the `agama.local` hostname. To connect to the running instance simply type `https://agama.local` in your browser. In most @@ -62,13 +62,13 @@ ping agama.local ssh root@agama.local ``` -##### Fallback +## Fallback The mDNS approach is just an addition, one more possibility how to connect to the machine. If it does not work for you then you can always use the old good classic IP address approach. -##### Service Advertising +## Service Advertising The Agama Live ISO also uses Avahi service advertising. With this you can easily search for all running Agama instances in the local network: @@ -79,7 +79,7 @@ avahi-browse -t -r _agama._sub._https._tcp The command will print the found servers and their hostnames and IP addresses. -##### Notes +## Notes - mDNS works only in the same local network, it does not work over internet or separate network segments. @@ -87,4 +87,3 @@ The command will print the found servers and their hostnames and IP addresses. - On mobile phones with Android OS mDNS is supported since Android version 12. (but this might be vendor dependent...). -