Instalace

Zpět na hlavní stránku

Obsah adresáře s distribucí

Máte-li k dispozici distribuční adresář, má následující strukturu:

|
|--- client
|    |- ValidujSoubor.jar
|
|--- doc
|    |--- javadoc
|
|--- example
|    |--- Example.java
| 
|--- program
|    |- VS.jar
|    |- ...
|
|--- src
|    |--- lib
|    |- ...

Význam jednotlivých souborů a adresářů je následující:

• client/ValidujSoubor.jar - spustitelný klient validačního serveru. Spouští se běžně "java -jar ValidujSoubor.jar", při spuštění bez parametrů vypisuje help.
• doc - tato dokumentace
  • javadoc - JavaDoc dokumentace serveru
• example - ukázkové programy, které se poté pošlou k validaci.
• program - zde je celý program, tj. běhová forma validačního serveru tak, jak je popsána v dokumentu o adresářové struktuře serveru. Adresář navíc pro ukázku obsahuje dvě domény: "ppa1" (doména pro validaci semestrálních prací v předmětu KIV/PPA1 na Fakultě aplikovaných věd, ZČU) a "ssp07" (kontrola příkladů studentských soutěží). Pozor, domény nejsou kompletní, obsahují pouze definice domény a procesu, neobsahují citlivá data (jako jsou vzorové příklady, testovací data atd.)
• src - obsahuje ukázkové zdrojové kódy klienta - tedy programu "ValidujSoubor". Zdrojové kódy jsou závislé pouze na knihovně "VS-Interface.jar", která je v podadresáři "lib".

Nejdůležitější adresář je adresář "program". Proveďte tedy následující kroky:

• Podívejte se nejprve na systémové požadavky serveru a zařiďte, aby je cílové prostředí splňovalo.
• Nahrajte celý adresář "program" do cílového prostředí
• Nakonfigurujte server - viz nastavení serveru. (především položky "rmi.server_url" a "core.java_path", ty by měly stačit na zprovoznění ukázkové domény)
• Podívejte se na zkušební doménu "example" a prohlédněte si její konfiguraci.
• Podívejte se na nastavení logování, pokud jej chcete změnit. Standardně by mělo být logování do souboru "data/log/vs.log".
• Zkuste server spustit.
• Pokud je vše ok, měl by naběhnout (viz log soubory) a začít přijímat požadavky na validaci.
• Máte-li na stroji, kde validační server běží, nainstalován http server, můžete v něm nastavit alias "/vs/" na "<cesta k serveru>/data/html". Ukázková konfigurace serveru je totiž nyní nastavena tak, že výsledné html se ukládají do "data/html" a URL, které se vrací, je "http://localhost/vs/...".
• Zkuste zaslat ukázkový soubor (v adresáři "examples" je připravený soubor "run-examples.bat")
• Po proběhnutí validace se podívejte v každém případě do "data/html", kde by měly přibýt podadresáře s informacemi o validacích. Pokud v nich bude chyba "Aktuálně používané Java prostředí neobsahuje překladač! Nepoužíváte omylem JRE místo JDK?", byl validační server pravděpodobně spuštěn pouze v JRE a nikoliv v JDK (viz systémové požadavky serveru). Vypněte proto server a spusťte ho tak, že budete volat příkaz "java" z JDK.

  Nově: Varování týkající setohoto problému se nyní vypisuje i do logu serveru během jeho spouštění.

  Konkrétně: Např. na Windows, je-li Java JDK 1.6 nahráno do adresáře "C:\Java\JDK1.6", potom je v něm podadresář "C:\Java\JDK1.6\BIN" a "C:\Java\JDK1.6\JRE\BIN". V obou z nich je příkaz "java.exe", ale je potřeba dát pozor, abyste validační server spouštěli příkazem z JDK, tedy: "C:\Java\JDK1.6\BIN\java.exe". Důvod je ten, že pouze v JDK je k dispozici knihovna "tools.jar", ve které je java compiler, který validační server potřebuje.

  Problém ve Windows je následující - proměnná PATH i JAVAHOME jsou nastaveny správně na JDK. Jenže proměnná PATH obsahuje na začátku cestu na "C:\Windows\System32" a instalátor Javy do tohoto adresáře nahraje soubor "java.exe", který patří k JRE. Proto se spouští JRE když se zadá pouze příkaz "java". Je potřeba zadat celou cestu k JDK.

• Pokud vše funguje, můžete začít přemýšlet o nové doméně.

Zpět na hlavní stránku