# Příručka pro &knutclient;

Daniel Prynych

    Daniel.Prynych@alo.cz

2001 2002 Daniel Prynych
&FDLNotice;
01/12/2002
0.02.00

&knutclient; je grafická klientská aplikace pro UPS systém NUT.

Tento dokument popisuje aplikaci Knutclient verze 0.6.0

KDE kdeutils KNutClient NUT UPS

## Úvod

&knutclient; je program který umožňuje sledovat stav UPS-ek systému NUT.

## Použití &knutclient;

Hlavní okno aplikace &knutclient;.

&knutclient; je klientská grafická aplikace pro systém NUT "Network UPS Tools". Umožňuje sledovat stav UPS-ek a zobrazovat hodnoty proměnných které vybraná UPS-ka a její ovladač podporují.

Od verze 0.6 &knutclient; podporuje spouštění okamžitých příkazů, a možnost změny RW proměnných.

Hlavní okno aplikace &knutclient;

Hlavní okno programu je rozděleno na dvě části.

Levé část "Hlavní panel" obsahuje následující údaje indikující stav vybrané UPS-ky. Provoz na síť, provoz na baterie, přetížení, nutnost vyměnit baterii, vybití baterie, kalibraci baterie, údaj o dobu běhu po odpojení sítě (RUNTIME) a pod. Déle jsou zde neměnné údaje, to jsou údaje které se za provozu nemění a jsou proto přečteny jen jednou při výběru UPS-ky, například jméno UPS-ky, její sériové číslo, výrobce a pod.

Pravá část obsahuje analogové panely (měřáky), které udávají hodnotu proměnných veličin jako je vstupní napětí, zatížení UPS-ky, kapacitu UPS-ky, teplotu UPS-ky, napětí baterie apod.

Knutclient obsahuje nástrojovou lištu (toolbar) ze standardními tlačítky a tlačítko pro výběr sledované UPS-ky.

### Více o vlastnostech knutclient;

Pro spojení se serverovou části NUT-u (upsd) používá &knutclient; dva možné protokoly, TCP nebo UDP.Po vybraní UPS-ky v nástrojové liště se &knutclient; pokusí přečíst data, pokud se mu to nepodaří, pokus opakuje a to maximálně 10 krát. &knutclient; poté čte data v pravidelných intervalech. Při prvním čtení čte všechny vybrané proměnné, v dalších již jen proměnné které zobrazují analogové panely, RUNTIME a stav UPS-ky. Proměnné zobrazující jméno UPS-ky, výrobce, sériové číslo a pod se tedy čtou jen jednou protože se nepředpokládá jejich změna. Pokud je pro spojení použit protokol UDP a čtení dat se nezdaří program se je pokusí přečíst ještě jednou, předtím než nahlásí chybu. Při použití protokolu UDP není možno spouštět jak okamžité příkazy, tak měnit RW proměnné.

Chyby vznikající za běhu programu se zobrazují ve stavové lište.

Chyby vznikající jako odezva na činnost uživatele jsou zobrazeny ve zvláštním okně.

## Popis příkazů

### Hlavní okno aplikace &knutclient;

#### Menu Soubor

Soubor Zobrazení Ups proměnných a příkazů

  Vypíše Ups proměnné pro zvolenou UPS-ku

Soubor Spuštění okamžitých příkazů

  Provede na UPS daný okamžitý příkaz

Soubor Nastavení UPS RW proměnných

  Provede změnu UPS RW proměnné

Ctrl q Soubor Ukončit

  Ukončí činnost programu

#### Menu Nastavení

Nastavení Zobrazovat nástrojovou lištu

  Zapne/Vypne zobrazení nástrojové lišty (Toolbar)

Nastavení Zobrazovat stavovou lištu

  Zapne/Vypne zobrazování nástrojové lišty

Nastavení Nastavit &knutclient;

  Aktivuje konfigurační dialog

### Okamžité příkazy

Okamžité příkazy jsou vykonávány přímo na na UPS-ce, NUT server předává požadavek na příkaz příslušnému ovladači (driveru) a ten pak příkaz vyvolá na UPS-ce. Okno pro ovládaní Vám nabízí ty příkazy, které příslušný ovladač (driver) podporuje. Tlačítkem OK je vybraný příkaz proveden. Tlačítkem Zrušit je okno zavřeno.

Příkaz

  Zde je možno vybrat příkaz který je pak následně vykonán

### Uživatelsky měnitelné (RW) proměnné

Uživatelsky měnitelné (RW) proměnné jsou skupinou proměnných které muže měnit přímo uživatel, většina z nich je přímo ekvivalentní nastavení příslušné UPS-ky. Uživatelsky měnitelné proměnné jsou dvojího typu znakové (CHAR) a výčtové (ENUM). Znakové proměnné jsou prostý řetězec znaků o definované maximální délce. Výčtové proměnné je seznam povolených hodnot na které muže být proměnná nastavená.

Uživatelsky měnitelné proměnná není změněna na serveru NUT-u (upsd) ale sever pouze dá příslušnému ovladači (driveru) příkaz ke změně, ten ihned provede změnu nastavení UPS-ky. Tato činnost není okamžitá a může trvat i několik sekund.

Tlačitkem OK je změna proměnné vykonána. Tlačítkem Zrušit je okno zavřeno. Tlačitkem Implicitní můžeme obnovit současnou hodnotu proměnné.

Proměnná

  Zde je možno vybrat proměnnou která bude změněna

Hodnota

  Zde je možno u znakové proměnné zadat, nebo u výčtové proměnné vybrat její hodnotu. Nabídkové pole se automaticky mění podle typu proměnné.

### Nastavení aplikace &knutclient;

Okno pro nastavení má pět částí Nastavení, UPS, Panel Písma a Analog.

#### Nastavení

Část NASTAVENÍ slouží pro nastavení počtu sloupců analogových panelů, barvy pozadí hlavního okna, vstupního napětí (120/230)V, frekvence vstupního napětí (50/60)Hz a povolení použití hodnot Xfer (LowXfer a HighXfer)

&knutclient;

Počet sloupců

  Určuje maximální počet sloupců pro analogové panely

Použít vlastní barvu pozadí

  Dovoluje zvolit vlastní barvu pozadí pro základní okno.

Barva pozadí

  Umožňuje zvolit barvu pozadí

Použít dialog "Jste si jistý"

  Při aktivaci, se při ukončení programu objeví dialog "Jste si jistý" který vyžaduje potvrzení, jinak se program neukončí.

Vstupní napětí

  Umožňuje vybrat vstupní napětí 230/120V. Položka nemá význam pokud je zároveň zvolena položka Použít High-Low XFER.

Vstupní frekvence

  Umožňuje vybrat vstupní frekvenci 50/60Hz. Položka nemá význam pokud je zároveň zvolena položka Použít High-Low XFER.

Použít High-Low XFER

  Nastaví vstupní napětí a vstupní frekvenci na základě hodnot v proměnných NUT-u LOWXFER a HIGHXFER. Tyto proměnné udávají rozpětí hodnot vstupního napětí, které muže UPS-ka ještě bezpečně zpracovat. Na základě těchto hodnot &knutclient; nastaví vstupní napětí a vstupní frekvenci pro panely které je používají. Například vstupní napětí, vstupní frekvence apod.

#### UPS

Část UPS slouží pro nastavení seznamu UPS-ek a jejich parametrů. Levá část obsahuje seznam UPS-ek. Pravá část tlačítka pro přidávání, změnu parametrů a smazání záznamu o UPS-kách.

&knutclient;

Přidat

  Přidá do seznamu další UPS-ku a nastaví její parametry.

Úpravy

  Změní parametry vybrané UPS-ky

Smazat

  Smaže UPS-ku v seznamu

##### Nastavení parametrů

Toto okno slouží k nastavení parametrů UPS-ky.

Název

  Určuje jméno UPS-ky pro program &knutclient;

Adresa UPS

  Určuje adresu UPS tak jak ji používá NUT. To jest ve tvaru jmeno_ups@adresa_pc, pokud není jmeno_ups definováno, je automaticky použita první ups v seznamu systému NUT daného pc. Blíže v dokumentaci k systému NUT. Příklad : victron@ns.alo.cz, localhost, apc700@192.168.1.12

Zpoždění (ms)

  Určuje interval mezi dvěma přenosy dat (čteni dat) ze systému NUT

Port

  Nastaví port na který se &knutclient; připojí.

Protokol

  Určuje zda spojení bude uskutečněno protokolem TCP nebo UDP.

Uživatelské jméno

  Určuje uživatelské jméno (USERNAME) které &knutclient; použije při prokázaní totožnosti uživatele serveru to jest, programu upsd

Heslo

  Určuje heslo (PASSWORD) pro pro prokázaní totožnosti uživatele.

Uložit NUT heslo do konfiguračního souboru

  Při zvolení této volby bude heslo uloženo do konfiguračního souboru. V konfiguračním souboru je heslo uloženo nezašifrovaně. Pokud nebude tato volba zvolena bude heslo po ukončení programu zapomenuto.

UPS Proměnné

  Umožňuje vybrat proměnné které budou zobrazeny na analogových panelech v pravé části hlavního okna. Maximálně je možno zobrazit 10 analogových panelů.

Parametry Uživatelské jméno a Heslo mají význam jen pri použití okamžitých příkazů a změnách RW proměnných, při sledování stavu UPS-ky není uživatelské jméno a heslo potřebné. Heslo (PASSWORD) a uživatelské jméno (USERNAME) mají své ekvivalenty v systému NUT v souboru upsd.users.

#### Panel

Část PANEL slouží pro určení které informační části hlavního panelu budou zobrazené

&knutclient;

Přetížení

  Povoluje/zakazuje zobrazení přetížení.

Baterie je vybitá

  Povoluje/zakazuje zobrazení vybití baterie.

Vyměnit baterie

  Povoluje/zakazuje zobrazení nutnosti výměny baterie.

Kalibrace UPS

  Povoluje/zakazuje zobrazení kalibrace UPS.

Výrobce + Model

  Povoluje/zakazuje zobrazení výrobce a modelu UPS-ky.

Výrobce

  Povoluje/zakazuje zobrazení výrobce UPS-ky.

Model

  Povoluje/zakazuje zobrazení modelu UPS-ky.

Sériové č.

  Povoluje/zakazuje zobrazení sériového čísla UPS-ky.

Verze Firmvare

  Povoluje/zakazuje zobrazení verze firmware UPS-ky.

Runtime

  Povoluje/zakazuje zobrazení doby po kterou je UPS-ka schopna po výpadku napájení dodávat el. proud.

Použít vlastní barvu pozadí

  Dovoluje zvolit vlastní barvu pozadí pro hlavní panel.

Barva pozadí

  Umožňuje zvolit barvu pozadí pro hlavní panel.

#### Písma

Část PÍSMA slouží pro výběr používaných písmen.

&knutclient;

Použít vlastní písma

  Povoluje/zakazuje možnost vybrat vlastní písma pro Hlavni panel a Analogové panely.

Hlavní panel / Analogové panely

  Určuje pro který panel se bude vybírat písmo.

Požadované písmo

  Vybírá písma pro zadaný typ panelu. Má význam jen tehdy pokud je vybrána položka Použít vlastní písmo.

#### Analog

Část Analog slouží pro nastavení barev na analogových panelech.

&knutclient;

Použít vlastní barvu pozadí

  Dovoluje zvolit vlastní barvu pozadí pro analogový panel.

Barva pozadí

  Umožňuje zvolit barvu pozadí pro analogový panel

Použít vlastní barvy

  Dovoluje zvolit vlastní barvy pro následující části analogového panelu.

Barva ručičky

  Umožňuje zvolit barvu ručičky pro analogový panel. Standardní barva je černá.

Barva OK rozsahu

  Umožňuje zvolit barvu podbarvení stupnice pro rozsah správných (OK) hodnot. Standardní barva je zelená.

Barva rozsahu varování

  Umožňuje zvolit barvu podbarvení stupnice pro rozsah varovaní. Standardní barva je žlutá.

Barva rozsahu chyby

  Umožňuje zvolit barvu podbarvení stupnice pro rozsah chyby. Standardní barva je červená.

Barva stupnice

  Umožňuje zvolit barvu stupnice pro analogový panel. Standardní barva je černá.

Barva písma

  Umožňuje zvolit barvu písma pro analogový panel. Standardní barva je černá.

## Otázky a odpovědi

&reporting.bugs; &updating.documentation;

&knutclient; nepracuje ale program upsc ano. Co mam dělat ?

Zkontrolujte nastaveni čísla portu. Od ver. 0.5 (NUT) je změněno číslo portu 3493. Klikněte na odkaz pro další údaje.

## Credits and License

&knutclient;

Program copyright 2002 Daniel Prynych Daniel.Prynych@alo.cz

Documentation copyright 2002 Daniel A. Prynych Daniel.Prynych@alo.cz

Translations done by:

- Daniel Prynych Daniel.Prynych@alo.cz Čeština

&underFDL; &underGPL;

## Instalace

### Jak získat &knutclient;

&knutclient; není částí KDE projektu http://www.kde.org. &knutclient; může být nalezen na ftp://ftp.hornet.cz/pub/alo/knutclient/ a na ftp://ftp.buzuluk.cz/pub/alo/knutclient/

### Požadavky

Pro úspěšné použití &knutclient; potřebujete KDE 2.1.x 2.2.x nebo 3.0.x

Seznam změn můžete najít na http://www.alo.cz.

### Překlad a instalace

Pro překlad a instalaci &knutclient; napište následující příkazy v základním adresáři Vaší &knutclient; aplikace.

    % ./configure
    % make
    % make install

Od doby kdy KDE aplikace používají autoconf a automake, nemůžete mít žádné problémy při překladu. Jestliže přesto vzniknou nějaké problémy hlaste je prosím do KDE konference.

&documentation.index;