docs(web): expand technician guide with practical details

- Add download link + curl workaround for antivirus blocking
- Note that curl only downloads, xetup + Enter needed to run
- Split preflight checks into separate section with details
- Explain Product Key priority (OA3 > GVLK) and when to fill in
- Document config load/save buttons for per-client presets
- Add adminx9 account explanation (autologon for reboot cycle)
- Warn about Atera MFA popup during SW install
- Note that partial failures don't stop deployment - check summary
- Add troubleshooting section: Deploy.log path + local report.html

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
X9 Dev 2026-04-28 12:01:44 +02:00
parent 3c2e7865a8
commit d00ef65737

View file

@ -133,10 +133,29 @@
<div class="phase"> <div class="phase">
<div class="phase-header"> <div class="phase-header">
<span class="phase-num">Spusteni</span> <span class="phase-num">Stazeni</span>
<h2>Spust xetup.exe jako Administrator</h2> <h2>Stahni xetup.exe</h2>
</div> </div>
<p>Stahni <code>xetup.exe</code> na cilovy pocitac a spust s pravy administratora. Aplikace provede predbezne kontroly (admin prava, winget, sit, disk) a zobrazi je hned na uvod.</p> <p>Stahni <a href="https://xetup.x9.cz/dl" style="color:var(--blue)">xetup.x9.cz/dl</a> na cilovy pocitac.</p>
<p>Antivirus (hlavne Windows Defender) <code>xetup.exe</code> casto smazne nebo zablokuje. V tom pripade otevri <strong>prikazovy radek</strong> (cmd) a stahni pres curl:</p>
<p><code>curl -Lo xetup.exe https://xetup.x9.cz/dl</code></p>
<p>Curl soubor jenom stahne &ndash; pak je treba spustit rucne:</p>
<p><code>xetup</code> + Enter</p>
</div>
<div class="phase">
<div class="phase-header">
<span class="phase-num">Spusteni</span>
<h2>Predbezne kontroly</h2>
</div>
<p>Xetup po spusteni overi, ze je vse pripraveno:</p>
<p>
<strong>Admin prava</strong> &ndash; musi bezet jako Administrator (UAC dialog)<br>
<strong>Winget</strong> &ndash; musi byt dostupny (soucast Windows 10 1709+ / Windows 11)<br>
<strong>Sit</strong> &ndash; internetove pripojeni musi fungovat<br>
<strong>Disk</strong> &ndash; dostatek mista na disku
</p>
<p>Pokud neco neprojde, xetup to zobrazi cervene a nepusti dal.</p>
</div> </div>
<div class="phase"> <div class="phase">
@ -148,10 +167,11 @@
<p> <p>
<strong>Jmeno PC</strong> &ndash; napr. <code>NB-KLIENT-01</code> (prazdne = neprejmenovat)<br> <strong>Jmeno PC</strong> &ndash; napr. <code>NB-KLIENT-01</code> (prazdne = neprejmenovat)<br>
<strong>Popis PC</strong> &ndash; napr. <code>PC recepce</code><br> <strong>Popis PC</strong> &ndash; napr. <code>PC recepce</code><br>
<strong>Product Key</strong> &ndash; prazdne = automaticky OA3 nebo GVLK fallback<br> <strong>Product Key</strong> &ndash; prazdne = pouzije se automaticky klic z BIOS/UEFI (OA3) nebo GVLK fallback pro KMS. Vyplnuj jen kdyz mas konkretni MAK/retail klic.<br>
<strong>Profil</strong> &ndash; default / admin / user<br> <strong>Profil</strong> &ndash; default / admin / user (ovlivnuje taskbar pinned apps)<br>
<strong>Kroky</strong> &ndash; odskrtni co nechces spustit <strong>Kroky</strong> &ndash; odskrtni co nechces spustit
</p> </p>
<p>Mas pripraveny <code>config.json</code> pro klienta? Klikni <strong>Nacist config...</strong> a formular se vyplni sam. Nastaveni muzes take ulozit pres <strong>Ulozit config...</strong> pro pristi pouziti.</p>
<p>Klikni <strong>SPUSTIT</strong>.</p> <p>Klikni <strong>SPUSTIT</strong>.</p>
</div> </div>
@ -162,6 +182,8 @@
</div> </div>
<p>Aplikace prochazi kroky automaticky a zobrazuje zive logy. <strong>Nech to bezet, nic nezavirej.</strong></p> <p>Aplikace prochazi kroky automaticky a zobrazuje zive logy. <strong>Nech to bezet, nic nezavirej.</strong></p>
<p>Nektere kroky (prejmenovani PC, Windows Update) vyzaduji restart. Xetup v tom pripade <strong>sam restartuje pocitac</strong>, po restartu se <strong>sam znovu spusti</strong> a pokracuje od mista kde skoncil. Tohle se muze opakovat vicekrat &ndash; je to ocekavane chovani.</p> <p>Nektere kroky (prejmenovani PC, Windows Update) vyzaduji restart. Xetup v tom pripade <strong>sam restartuje pocitac</strong>, po restartu se <strong>sam znovu spusti</strong> a pokracuje od mista kde skoncil. Tohle se muze opakovat vicekrat &ndash; je to ocekavane chovani.</p>
<p>Pro automaticky restart xetup vytvori skryty ucet <code>adminx9</code> (bez hesla, clen Administrators) a nastavi na nej autologon. Po dokonceni deploymetu se autologon vypne a ucet zustane pro budouci spravu.</p>
<p><strong>Pozor na Atera:</strong> behem instalace SW se muze objevit prihlasovaci/MFA okno Atera &ndash; je treba ho potvrdit, jinak instalace ceka.</p>
</div> </div>
<div class="phase"> <div class="phase">
@ -170,6 +192,7 @@
<h2>Hotovo</h2> <h2>Hotovo</h2>
</div> </div>
<p>Jakmile se zobrazi okno <strong>&bdquo;xetup &mdash; hotovo&ldquo;</strong> se seznamem kroku a pocitadlem, vse probehlo. V tu chvili odejde emailovy report na <code>net@x9.cz</code>.</p> <p>Jakmile se zobrazi okno <strong>&bdquo;xetup &mdash; hotovo&ldquo;</strong> se seznamem kroku a pocitadlem, vse probehlo. V tu chvili odejde emailovy report na <code>net@x9.cz</code>.</p>
<p><strong>Zkontroluj summary</strong> &ndash; zelena = OK, cervena = selhalo. Deployment pokracuje i kdyz nektery krok selze, takze "hotovo" neznamena "vse OK".</p>
<p>Pocitac se za 60 sekund automaticky restartuje. Muzes take kliknout <strong>Restartovat ted</strong>.</p> <p>Pocitac se za 60 sekund automaticky restartuje. Muzes take kliknout <strong>Restartovat ted</strong>.</p>
</div> </div>
@ -177,6 +200,12 @@
<p><strong>Dokud nevidis okno &bdquo;hotovo&ldquo;, xetup jeste bezi.</strong> Muze probihat dalsi kolo Windows Update nebo ceka na dokonceni instalace SW.</p> <p><strong>Dokud nevidis okno &bdquo;hotovo&ldquo;, xetup jeste bezi.</strong> Muze probihat dalsi kolo Windows Update nebo ceka na dokonceni instalace SW.</p>
<p>Sit musi byt aktivni po celou dobu &ndash; winget stahuje aplikace, na konci odchazi report.</p> <p>Sit musi byt aktivni po celou dobu &ndash; winget stahuje aplikace, na konci odchazi report.</p>
</div> </div>
<div class="note">
<p><strong>Kdyz neco selze:</strong></p>
<p>Log: <code>C:\Windows\Setup\Scripts\Deploy.log</code> &ndash; kompletni prubeh vcetne chybovych hlasek.</p>
<p>Report: <code>C:\X9\report.html</code> &ndash; lokalni kopie emailoveho reportu (ulozi se vzdy, i kdyz SMTP nefunguje).</p>
</div>
</div> </div>
<footer> <footer>