wiki/guidelines/openqa_manual_install/index.html

1790 lines
56 KiB
HTML
Raw Permalink Normal View History

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="The wiki for the Rocky Linux Testing Team.">
<meta name="author" content="Alan Marshall">
<link rel="canonical" href="https://testing.rocky.page/guidelines/openqa_manual_install/">
<link rel="prev" href="../release_criteria/r9/9.0_qa_testing_go_no_go/">
<link rel="next" href="../../sop/">
<link rel="icon" href="../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.20">
<title>Manual Install of openQA for rockylinux - Testing Wiki</title>
<link rel="stylesheet" href="../../assets/stylesheets/main.66ac8b77.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="teal" data-md-color-accent="teal">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#intended-audience" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../.." title="Testing Wiki" class="md-header__button md-logo" aria-label="Testing Wiki" data-md-component="logo">
<img src="../../assets/icon-white.svg" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
Testing Wiki
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
Manual Install of openQA for rockylinux
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="teal" data-md-color-accent="teal" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3 3.19.09m3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95 2.06.05m-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31Z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="teal" data-md-color-accent="teal" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5c-.84 0-1.65.15-2.39.42L12 2M3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29L3.34 7m.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14L3.36 17M20.65 7l-1.77 3.79a7.023 7.023 0 0 0-2.38-4.15l4.15.36m-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29L20.64 17M12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44L12 22Z"/></svg>
</label>
</form>
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
<div class="md-search__suggest" data-md-component="search-suggest"></div>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://git.resf.org/testing/wiki" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
</div>
<div class="md-source__repository">
testing/wiki
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--integrated" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../.." title="Testing Wiki" class="md-nav__button md-logo" aria-label="Testing Wiki" data-md-component="logo">
<img src="../../assets/icon-white.svg" alt="logo">
</a>
Testing Wiki
</label>
<div class="md-nav__source">
<a href="https://git.resf.org/testing/wiki" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
</div>
<div class="md-source__repository">
testing/wiki
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../.." class="md-nav__link">
<span class="md-ellipsis">
Testing Team Wiki
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../members/" class="md-nav__link">
<span class="md-ellipsis">
Members
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
<div class="md-nav__link md-nav__container">
<a href="../../documentation/" class="md-nav__link ">
<span class="md-ellipsis">
Documentation
</span>
</a>
<label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3">
<span class="md-nav__icon md-icon"></span>
Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../documentation/qa_test_cases/" class="md-nav__link">
<span class="md-ellipsis">
QA:Test Cases
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_3" >
<label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="0">
<span class="md-ellipsis">
Wiki Development Guides
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_3">
<span class="md-nav__icon md-icon"></span>
Wiki Development Guides
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../documentation/dev_guides/wiki_development_boxes/" class="md-nav__link">
<span class="md-ellipsis">
Development Box Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../documentation/dev_guides/commit_signing/" class="md-nav__link">
<span class="md-ellipsis">
Git Commit Signing
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../documentation/dev_guides/openqa_access/" class="md-nav__link">
<span class="md-ellipsis">
openQA - Access
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../documentation/dev_guides/openqa_cli_post_examples/" class="md-nav__link">
<span class="md-ellipsis">
openQA - openqa-cli POST Examples
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../documentation/dev_guides/openqa_clone_job_examples/" class="md-nav__link">
<span class="md-ellipsis">
openQA - openqa-clone-job Examples
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../documentation/dev_guides/openqa_clone_custom_git_refspec_examples/" class="md-nav__link">
<span class="md-ellipsis">
openQA - openqa-clone-custom-git-refspec Examples
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
<div class="md-nav__link md-nav__container">
<a href="../" class="md-nav__link ">
<span class="md-ellipsis">
Guidelines
</span>
</a>
<label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
Guidelines
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2" >
<label class="md-nav__link" for="__nav_4_2" id="__nav_4_2_label" tabindex="0">
<span class="md-ellipsis">
Release Criteria & Status
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2">
<span class="md-nav__icon md-icon"></span>
Release Criteria & Status
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../release_criteria/release_criteria/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux Release Criteria & Status
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2_2" >
<label class="md-nav__link" for="__nav_4_2_2" id="__nav_4_2_2_label" tabindex="0">
<span class="md-ellipsis">
Rocky Linux 8
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_4_2_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2_2">
<span class="md-nav__icon md-icon"></span>
Rocky Linux 8
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../release_criteria/r8/8_release_criteria/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 8 Release Criteria
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../release_criteria/r8/8.6_qa_testing_summary/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 8.6 QA and Testing Summary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../release_criteria/r8/8.6_qa_testing_go_no_go/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 8.6 GO / NO-GO Status
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2_3" >
<label class="md-nav__link" for="__nav_4_2_3" id="__nav_4_2_3_label" tabindex="0">
<span class="md-ellipsis">
Rocky Linux 9
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_4_2_3_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2_3">
<span class="md-nav__icon md-icon"></span>
Rocky Linux 9
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../release_criteria/r9/9_release_criteria/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 9 Release Criteria
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../release_criteria/r9/9.0_qa_testing_summary/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 9.0 QA and Testing Summary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../release_criteria/r9/9.0_qa_testing_go_no_go/" class="md-nav__link">
<span class="md-ellipsis">
Rocky Linux 9.0 GO / NO-GO Status
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
openQA Manual Install
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
openQA Manual Install
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#intended-audience" class="md-nav__link">
<span class="md-ellipsis">
Intended Audience
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#introduction" class="md-nav__link">
<span class="md-ellipsis">
Introduction
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#webui" class="md-nav__link">
<span class="md-ellipsis">
WebUI
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#step-by-step-install-guide" class="md-nav__link">
<span class="md-ellipsis">
Step-by-step Install Guide
</span>
</a>
<nav class="md-nav" aria-label="Step-by-step Install Guide">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#helpers" class="md-nav__link">
<span class="md-ellipsis">
Helpers
</span>
</a>
<nav class="md-nav" aria-label="Helpers">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#createhdds" class="md-nav__link">
<span class="md-ellipsis">
Createhdds
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#openqa-cli" class="md-nav__link">
<span class="md-ellipsis">
openqa-cli
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#scripts" class="md-nav__link">
<span class="md-ellipsis">
Scripts
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#using-templates" class="md-nav__link">
<span class="md-ellipsis">
Using Templates
</span>
</a>
<nav class="md-nav" aria-label="Using Templates">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#challenge" class="md-nav__link">
<span class="md-ellipsis">
Challenge
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#machines" class="md-nav__link">
<span class="md-ellipsis">
Machines
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#medium-types" class="md-nav__link">
<span class="md-ellipsis">
Medium Types
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#test-suites" class="md-nav__link">
<span class="md-ellipsis">
Test Suites
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#job-groups" class="md-nav__link">
<span class="md-ellipsis">
Job Groups
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#needles" class="md-nav__link">
<span class="md-ellipsis">
Needles
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#upstream-documentation" class="md-nav__link">
<span class="md-ellipsis">
Upstream Documentation
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#glossary" class="md-nav__link">
<span class="md-ellipsis">
Glossary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#history-briefly" class="md-nav__link">
<span class="md-ellipsis">
History (briefly)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#attribution" class="md-nav__link">
<span class="md-ellipsis">
Attribution
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#references" class="md-nav__link">
<span class="md-ellipsis">
References
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#revision-history" class="md-nav__link">
<span class="md-ellipsis">
Revision History
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
<div class="md-nav__link md-nav__container">
<a href="../../sop/" class="md-nav__link ">
<span class="md-ellipsis">
SOP
</span>
</a>
<label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
SOP
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../sop/openqa_sop_operator_access/" class="md-nav__link">
<span class="md-ellipsis">
SOP: openQA Operator Access Request
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../sop/openqa_sop_operator_removal/" class="md-nav__link">
<span class="md-ellipsis">
SOP: openQA Operator Access Removal
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../sop/openqa_sop_system_upgrades/" class="md-nav__link">
<span class="md-ellipsis">
SOP: openQA System Upgrades
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../sop/sop_repocompare/" class="md-nav__link">
<span class="md-ellipsis">
SOP: Repocompare
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<a href="https://git.resf.org/testing/wiki/_edit/main/docs/guidelines/openqa_manual_install.md" title="Edit this page" class="md-content__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4v-2m10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1 2.1 2.1Z"/></svg>
</a>
<h1>openQA Manual Install</h1>
<h4 id="intended-audience">Intended Audience<a class="headerlink" href="#intended-audience" title="Permanent link">&para;</a></h4>
<p>Those who wish to use the openQA automated testing system configured for Rocky Linux tests. If so, you will need a PC or server with hardware virtualisation running an up-to-date Fedora Linux.</p>
<h3 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permanent link">&para;</a></h3>
<p>This guide explains the use of the openQA automated testing system to test various aspects of Rocky Linux releases either at the pre-release stage or thereafter.</p>
<p>openQA is an automated test tool that makes it possible to test the whole installation process. It uses virtual machines which it sets up to reproduce the process, check the output (both serial console and GUI screen) in every step and send the necessary keystrokes and commands to proceed to the next step. openQA checks whether the system can be installed, whether it works properly, whether applications work and whether the system responds as expected to different installation options and commands.</p>
<p>Rocky Linux openQA tests can be found in the <a href="https://github.com/rocky-linux/os-autoinst-distri-rocky">os-autoinst-distri-rocky</a> repository</p>
<p>openQA can run numerous combinations of tests for every revision of the operating system, reporting the errors detected for each combination of hardware configuration, installation options and variant of the operating system.</p>
<h3 id="webui">WebUI<a class="headerlink" href="#webui" title="Permanent link">&para;</a></h3>
<p>The web UI is a very useful feature of the openQA system since it provides an easily accessed view of the progress and details of openQA tests either on the local machine or remotely or both. It is intended to be intuitive and self-explanatory.</p>
<p>Some pages use queries to select what should be shown. The query parameters are generated on clickable links, for example starting from the index page or the group overview page clicking on single builds. On the query pages there can be UI elements to control the parameters, for example to look for older builds or show only failed jobs, or other settings. Additionally, the query parameters can be tweaked by hand if you want to provide a link to specific views.</p>
<h2 id="step-by-step-install-guide">Step-by-step Install Guide<a class="headerlink" href="#step-by-step-install-guide" title="Permanent link">&para;</a></h2>
<p>openQA can be installed only on a Fedora (or OpenSUSE) server or workstation. The following install procedure was tested on Fedora 40 Server. You can use either a local terminal or an ssh login from another host on the lan.</p>
<p><div class="highlight"><pre><span></span><code># install Packages
# for openqa
sudo dnf install -y openqa openqa-httpd openqa-worker fedora-messaging python3-jsonschema
sudo dnf install -y perl-REST-Client.noarch
# and for createhdds
sudo dnf install -y libguestfs-tools libguestfs-xfs python3-fedfind python3-libguestfs
sudo dnf install -y libvirt libvirt-daemon-config-network libvirt-python3 virt-install withlock
# configure httpd:
cd /etc/httpd/conf.d/
sudo cp openqa.conf.template openqa.conf
sudo cp openqa-ssl.conf.template openqa-ssl.conf
sudo setsebool -P httpd_can_network_connect 1
sudo systemctl restart httpd
# configure the web UI
sudoedit /etc/openqa/openqa.ini
[global]
branding=plain
download_domains = rockylinux.org
[auth]
method = Fake
sudo dnf install postgresql-server
sudo postgresql-setup --initdb
# enable and start services
sudo systemctl enable postgresql --now
sudo systemctl enable httpd --now
sudo systemctl enable openqa-gru --now
sudo systemctl enable openqa-scheduler --now
sudo systemctl enable openqa-websockets --now
sudo systemctl enable openqa-webui --now
sudo systemctl enable fm-consumer@fedora_openqa_scheduler --now
sudo systemctl enable libvirtd --now
sudo setsebool -P httpd_can_network_connect 1
sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --reload
sudo systemctl restart httpd
# to create API key in local web interface at http://localhost
# or on remote system http://&lt;ip addr&gt;
# Click Login, then Manage API Keys, create a key and secret.
# insert key and secret
sudoedit /etc/openqa/client.conf
[localhost]
key = ...
secret = ...
# create workers
sudo systemctl enable openqa-worker@1 --now
# then ...@2 ...etc as desired. Look in webui workers to check shown idle.
# as a rule of thumb, you can have about half the number of workers as cores
# get Rocky tests
cd /var/lib/openqa/tests/
sudo git clone https://github.com/rocky-linux/os-autoinst-distri-rocky.git rocky
sudo chown -R geekotest:geekotest rocky
cd rocky
# when working in /var/lib/openqa nearly all commands need sudo.
sudo git config --global --add safe.directory /var/lib/openqa/share/tests/rocky
sudo git checkout develop
# or whichever branch has the latest updates for your tests
sudo ./fifloader.py -l -c templates.fif.json
sudo git clone https://github.com/rocky-linux/createhdds.git ~/createhdds
sudo mkdir -p /var/lib/openqa/share/factory/hdd/fixed
# will need about 200GB disk space available for ongoing tests
cd /var/lib/openqa/factory/hdd/fixed
# start a long running process that provides hdd image files for ongoing tests
~/createhdds/createhdds.py -t -b stg all
# get Rocky iso files for testing from staging repository
sudo mkdir -p /var/lib/openqa/share/factory/iso/fixed
cd /var/lib/openqa/factory/iso/fixed
sudo curl -LOR https://dl.rockylinux.org/stg/rocky/9/isos/x86_64/Rocky-9.3-x86_64-boot.iso
sudo curl -LOR https://dl.rockylinux.org/stg/rocky/9/isos/x86_64/Rocky-9.3-x86_64-minimal.iso
sudo curl -LOR https://dl.rockylinux.org/stg/rocky/9/isos/x86_64/Rocky-9.3-x86_64-dvd.iso
sudo curl -LOR https://dl.rockylinux.org/stg/rocky/9/isos/x86_64/CHECKSUM
sha256sum -c CHECKSUM
# fix ownership, add &lt;user&gt; to group, reboot
cd /var/lib/openqa/factory/
sudo chown -R geekotest:geekotest ./
sudo usermod -aG geekotest &lt;user&gt;
sudo init 6
# post tests and view progress on webui
cd /var/lib/openqa/tests/rocky/
sudo ./fifloader.py -c -l templates.fif.json
sudo openqa-cli api -X POST isos ISO=Rocky-9.3-x86_64-minimal.iso ARCH=x86_64 DISTRI=rocky FLAVOR=minimal-iso VERSION=9.3 BUILD=&quot;$(date +%Y%m%d.%H%M%S).0&quot;-minimal
sudo openqa-cli api -X POST isos ISO=Rocky-9.3-x86_64-boot.iso ARCH=x86_64 DISTRI=rocky FLAVOR=boot-iso VERSION=9.3 BUILD=&quot;$(date +%Y%m%d.%H%M%S).0&quot;-boot
and for a full build (this will post 95 jobs)
sudo openqa-cli api -X POST isos ISO=Rocky-9.3-x86_64-dvd.iso ARCH=x86_64 DISTRI=rocky FLAVOR=dvd-iso VERSION=9.3 BUILD=&quot;$(date +%Y%m%d.%H%M%S).0&quot;-dvd-iso
sudo openqa-cli api -X POST isos ISO=Rocky-9.3-x86_64-dvd.iso ARCH=x86_64 DISTRI=rocky FLAVOR=universal VERSION=9.3 BUILD=&quot;$(date +%Y%m%d.%H%M%S).0&quot;-universal
</code></pre></div>
You can watch progress of these tests on the webui on any browser on the same lan as the test host at </p>
<p><code>http://&lt;ip_addr_of_test_host&gt;/tests</code></p>
<p>If you click "login" in the top right corner you will be able to control tests from the webui.</p>
<p>At this point the multi-vm tests will fail or be skipped. This is because at the moment your system is configured for single vm deployment and it can be used as such. Pause your installation here if you wish to get some practice using openQA before progressing further (recommended).</p>
<p>Installation of facilities for multi-vm testing, which is substantially more complicated, will be described in this document in a later revision (watch this space).</p>
<h3 id="helpers">Helpers<a class="headerlink" href="#helpers" title="Permanent link">&para;</a></h3>
<h4 id="createhdds">Createhdds<a class="headerlink" href="#createhdds" title="Permanent link">&para;</a></h4>
<p><code>Createhdds</code> is used to prepare <code>.img</code> and <code>.qcow2</code> files for some of the Rocky tests. If you ran the above procedure you will have noticed that it produces a number of files in <code>/var/lib/openqa/factory/hdd/fixed</code> determined by the files provided in <a href="https://github.com/rocky-linux/createhdds">createhdds</a>.</p>
<h4 id="openqa-cli">openqa-cli<a class="headerlink" href="#openqa-cli" title="Permanent link">&para;</a></h4>
<p>Tests are normally posted using <code>openqa-cli</code> as you have already used above. Test parameters are listed and explained in the <a href="https://github.com/rocky-linux/os-autoinst-distri-rocky/blob/develop/VARIABLES.md">openQA VARIABLES definition document</a></p>
<h4 id="scripts">Scripts<a class="headerlink" href="#scripts" title="Permanent link">&para;</a></h4>
<p><a href="https://github.com/rocky-linux/os-autoinst-distri-rocky/tree/develop/scripts">helper scripts</a> -
<code>cancel-build.sh</code> is especially useful when you discover that you have initiated a large build and got it wrong... d'oh.</p>
<h3 id="using-templates">Using Templates<a class="headerlink" href="#using-templates" title="Permanent link">&para;</a></h3>
<h4 id="challenge">Challenge<a class="headerlink" href="#challenge" title="Permanent link">&para;</a></h4>
<p>One of the challenges that arises when testing an operating system, especially when doing continuous testing, is that there is always a certain combination of jobs, each one with its own settings, that needs to be run for every revision. These combinations can be different for different <code>FLAVORs</code> of the same revision, like running a different set of jobs for each architecture. This combinational problem can go one step further if openQA is being used for different kinds of tests, like running some simple pre-integration tests for some snapshots combined with more comprehensive post-integration tests for release candidates.</p>
<p>This section describes how an instance of openQA <em>could</em> be configured using the options in the admin area of the webUI to automatically create all the required jobs for each revision of your operating system that needs to be tested. <em>If</em> you were starting from scratch (the difficult way), you would probably go through the following order:</p>
<ol>
<li>Define machines in 'Machines' menu</li>
<li>Define medium types (products) you have in 'Medium types' menu</li>
<li>Specify various collections of tests you want to run in the 'Test suites' menu</li>
<li>Define job groups in 'Job groups' menu for groups of tests</li>
<li>Select individual 'Job groups' and decide what combinations make sense and need to be tested</li>
</ol>
<p>If you followed the install guide above then the cloned Rocky tests from <a href="https://github.com/rocky-linux/os-autoinst-distri-rocky">os-autoinst-distri-rocky</a> will have pre-configured the admin area of the webUI. You may find it useful to consult when reading the following sections.</p>
<p>Machines, mediums, test suites and job templates can all set various configuration variables. The job templates within the job groups define how the test suites, mediums and machines should be combined in various ways to produce individual 'jobs'. All the variables from the test suite, medium, machine and job template are combined and made available to the actual test code run by the 'job', along with variables specified as part of the job creation request. Certain variables also influence openQAs and/or os-autoinsts own behavior in terms of how it configures the environment for the job.</p>
<p>The configuration is set up from <code>/var/lib/openqa/tests/rocky/templates.fif.json</code></p>
<h4 id="machines">Machines<a class="headerlink" href="#machines" title="Permanent link">&para;</a></h4>
<p>You need to have at least one machine set up to be able to run any tests. These machines represent virtual machine types that you want to test. Realistically to make tests actually happen, you have to have a number of <code>openQA workers</code> connected that can fulfill these specifications.</p>
<ul>
<li><code>Name</code> User defined <code>string</code> - only needed for operator to identify the machine configuration.</li>
<li><code>Backend</code> What <code>backend</code> should be used for this <code>machine</code> Recommended value is <code>qemu</code> as it is the most tested one, but other options such as <code>kvm2usb</code> or <code>vbox</code> are also possible.</li>
<li>
<p><code>Variables</code> Most machine variables influence os-autoinsts behavior in terms of how the test machine is set up. A few important examples:</p>
<ul>
<li><code>QEMUCPU</code> can be <code>qemu32</code> or <code>qemu64</code> and specifies the architecture of the virtual CPU</li>
<li>
<p><code>QEMUCPUS</code> is an <code>integer</code> that specifies the number of cores you wish to be used</p>
</li>
<li>
<p><code>USBBOOT</code> when set to <code>1</code> the image will be loaded through an emulated USB stick.</p>
</li>
</ul>
</li>
</ul>
<h4 id="medium-types">Medium Types<a class="headerlink" href="#medium-types" title="Permanent link">&para;</a></h4>
<ul>
<li><code>product</code><ul>
<li>A medium type <code>product</code> in openQA is a simple description without any definite meaning. It basically consists of a <code>name</code> and a set of <code>variables</code> that define or characterise this product in os-autoinst.</li>
</ul>
</li>
</ul>
<p>Some example variables are:</p>
<ul>
<li><code>ISO_MAXSIZE</code> contains the maximum size of the <code>product</code>. There is a test that checks that the current size of the product is less or equal than this variable.</li>
<li><code>DVD</code> if it is set to <code>1</code> this indicates that the medium is a DVD.</li>
<li><code>LIVECD</code> if it is set to <code>1</code> this indicates that the medium is a live image (can be a <code>CD</code> or <code>USB</code>)</li>
<li><code>GNOME</code> this variable, if it is set to <code>1</code> indicates that it is a <code>GNOME</code> only distribution.</li>
<li><code>RESCUECD</code> is set to <code>1</code> for rescue CD images.</li>
</ul>
<h4 id="test-suites">Test Suites<a class="headerlink" href="#test-suites" title="Permanent link">&para;</a></h4>
<p>A test suite consists of a name and a set of test variables that are used inside this particular test together with an optional description. The test variables can be used to parameterise the actual test code and influence the behaviour according to the settings.</p>
<p>Some sample variables are:</p>
<ul>
<li><code>DESKTOP</code> possible values are <code>kde</code> <code>gnome</code> <code>lxde</code> <code>xfce</code> or <code>textmode</code>. Used to indicate the desktop selected by the user during the test.</li>
<li><code>ENCRYPT</code> encrypt the home directory via <code>YaST</code></li>
<li><code>HDDSIZEGB</code> hard disk size in GB.</li>
<li><code>HDD_1</code> path for the pre-created hard disk</li>
<li><code>RAIDLEVEL RAID</code> configuration variable</li>
</ul>
<h4 id="job-groups">Job Groups<a class="headerlink" href="#job-groups" title="Permanent link">&para;</a></h4>
<p>The job groups are the place where the actual test scenarios are defined by the selection of the medium type, the test suite and machine together with a priority value.</p>
<p>The priority value is used in the scheduler to choose the next job. If multiple jobs are scheduled and their requirements for running them are fulfilled the ones with a lower priority value are triggered. The id is the second sorting key of two jobs with equal requirements and same priority value the one with lower id is triggered first.</p>
<p>Job groups themselves can be created over the web UI as well as the REST API. Job groups can optionally be nested into categories. The display order of job groups and categories can be configured by drag-and-drop in the web UI.</p>
<p>The scenario definitions within the job groups can be created and configured by different means:</p>
<ul>
<li>A simple web UI wizard which is automatically shown for job groups when a new medium is added to the job group.</li>
<li>An intuitive table within the web UI for adding additional test scenarios to existing media including the possibility to configure the priority values.</li>
<li>The scripts <code>openQA-load-templates</code> and <code>openQA-dump-templates</code> to quickly dump and load the configuration from custom plain-text dump format files using the REST API.</li>
<li>Using declarative schedule definitions in the YAML format using REST API routes or an online-editor within the web UI including a syntax checker.</li>
</ul>
<h3 id="needles">Needles<a class="headerlink" href="#needles" title="Permanent link">&para;</a></h3>
<p>Needles are very precise and the slightest deviation from the specified display will be detected. This means that every time there is a new release, very small changes occur in layout of displays resulting in many new or modified needles being required. There is always a significant amount of work needed by the Test Team to produce the automatic tests for a new version.</p>
<p>A very useful feature of the webui is the online needle editor. When a test fails for a missing needle, the needle editor can be activated by clicking the icon and a new needle can be created, usually by copying a similar needle together with the current screenshot. The needle files are saved in the <code>/var/lib/openqa/tests/rocky/needles directory</code></p>
<h3 id="upstream-documentation">Upstream Documentation<a class="headerlink" href="#upstream-documentation" title="Permanent link">&para;</a></h3>
<p><a href="http://open.qa/docs/">Starter Guide</a> and <a href="https://github.com/os-autoinst/openqa/blob/master/docs/Installing.asciidoc">Upstream documentation</a> are useful for reference but since they are a mixture of advice and instructions relating to openSUSE and Fedora which have substantial differences between them it is not always clear which are significant for Rocky. However, as an rpm based distribution, Rocky Linux use is loosely related to the <a href="https://fedoraproject.org/wiki/OpenQA">Fedora</a> version.</p>
<h3 id="glossary">Glossary<a class="headerlink" href="#glossary" title="Permanent link">&para;</a></h3>
<p>The following terms are used within the context of openQA:-</p>
<ul>
<li>
<p>test module</p>
<ul>
<li>An individual test case in a single perl module <code>.pm</code> file, e.g. <code>sshxterm</code> If not further specified a test module is denoted with its short <code>name</code> equivalent to the filename including the test definition. The full <code>name</code> is composed of the test group, which itself is formed by the top-folder of the test module file, and the short name, e.g. <code>x11-sshxterm</code> (for <code>x11/sshxterm.pm</code>)</li>
</ul>
</li>
<li>
<p>test suite</p>
<ul>
<li>
<p>A collection of test modules, e.g. <code>textmode</code> All test modules within one test suite are run serially</p>
</li>
<li>
<p>One run of individual test cases in a row denoted by a unique number for one instance of openQA, e.g. one installation with subsequent testing of applications within <code>gnome</code></p>
</li>
</ul>
</li>
<li>
<p>test run</p>
<ul>
<li>Equivalent to job</li>
</ul>
</li>
<li>test result<ul>
<li>The result of one job, e.g. <code>passed</code> with the details of each individual test module</li>
</ul>
</li>
<li>
<p>test step</p>
<ul>
<li>the execution of one test module within a job</li>
</ul>
</li>
<li>
<p>distri</p>
<ul>
<li>A test distribution but also sometimes referring to a <code>product</code> (CAUTION: ambiguous, historically a "GNU/Linux distribution"), composed of multiple test modules in a folder structure that composes test suites, e.g. <code>rocky</code> (test distribution, short for <code>os-autoinst-distri-rocky</code>)</li>
</ul>
</li>
<li>
<p>product</p>
<ul>
<li>The main <code>system under test (SUT)</code> e.g. <code>rocky</code> also called <code>Medium Types</code> in the web interface of openQA</li>
</ul>
</li>
<li>
<p>job group</p>
<ul>
<li>Equivalent to product, used in context of the webUI</li>
</ul>
</li>
<li>
<p>version</p>
<ul>
<li>One version of a product, dont confuse with <code>build</code></li>
</ul>
</li>
<li>
<p>flavor</p>
<ul>
<li>Keyword for a specific variant of a product to distinguish differing variants, e.g. <code>dvd-iso</code></li>
</ul>
</li>
<li>
<p>arch</p>
<ul>
<li>An architecture variant of a product, e.g. <code>x86_64</code></li>
</ul>
</li>
<li>
<p>machine</p>
<ul>
<li>Additional variant of machine, e.g. used for <code>64bit</code> <code>bios</code> <code>uefi</code> etc.</li>
</ul>
</li>
<li>
<p>scenario</p>
<ul>
<li>A composition of <code>&lt;distri&gt;-&lt;version&gt;-&lt;flavor&gt;-&lt;arch&gt;-&lt;test_suite&gt;@&lt;machine&gt;</code> e.g. <code>Rocky-9-dvd-x86_64-gnome@64bit</code></li>
</ul>
</li>
<li>
<p>build</p>
<ul>
<li>Different versions of a product as tested, can be considered a <code>sub-version</code> of <code>version</code>, e.g. <code>Build1234</code> CAUTION: ambiguity: either with the prefix <code>build</code> included or not</li>
</ul>
</li>
</ul>
<h3 id="history-briefly">History (briefly)<a class="headerlink" href="#history-briefly" title="Permanent link">&para;</a></h3>
<p>openQA started with OS-autoinst: automated testing of Operating Systems
The OS-autoinst project aims at providing a means to run fully automated tests, especially to run tests of basic and low-level operating system components such as bootloader, kernel, installer and upgrade, which can not easily be tested with other automated testing frameworks. However, it can just as well be used to test firefox and openoffice operation on top of a newly installed OS.
openQA is a test-scheduler and web-front for openSUSE and Fedora using OS-autoinst as a backend.
openQA originated at openSuse and was adopted by Fedora as the automated test system for their frequent distribution updates. Maintenance activity is fairly intense and is ongoing at various levels of users. openQA was adopted by Rocky Linux Test Team as the preferred automated testing system for the ongoing releases of it's distribution.
openQA is free software released under the GPLv2 license.</p>
<h3 id="attribution">Attribution<a class="headerlink" href="#attribution" title="Permanent link">&para;</a></h3>
<p>This guide is heavily inspired by the numerous upstream documents in which installation and usage of OS-autoinst and openQA are described.</p>
<h3 id="references">References<a class="headerlink" href="#references" title="Permanent link">&para;</a></h3>
<p>Since Rocky Linux use of openQA is drawn from upstream Fedora and hence openSUSE this document contains <strong>many</strong> passages which are edited versions of upstream documentation and that use is hereby gratefully acknowledged. As with many open source projects, we build on previous work.</p>
<h3 id="revision-history">Revision History<a class="headerlink" href="#revision-history" title="Permanent link">&para;</a></h3>
<p>v1.0 - 2024/04/30 - First Issue</p>
<aside class="md-source-file">
<span class="md-source-file__fact">
<span class="md-icon" title="Last update">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1-2.1-2M12.5 7v5.2l4 2.4-1 1L11 13V7h1.5M11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2v1.8Z"/></svg>
</span>
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">April 30, 2024</span>
</span>
</aside>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
Back to top
</button>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Copyright &copy; 2023 Rocky Enterprise Software Foundation
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../..", "features": ["navigation.expand", "navigation.indexes", "navigation.instant", "navigation.sections", "navigation.top", "navigation.tracking", "navigation.path", "search.highlight", "search.suggest", "toc.integrate", "content.action.edit"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.dd8806f2.min.js"></script>
</body>
</html>