Jak nainstalovat Quoterro

Quotero je DMS, systém určený pro správu dokumentů, který ke svému běhu používá server Tomcat a jeho databázi můžete uložit do  Jeho instalaci provedete následovně.

Nejprve si stáhněte Quotero Deployer, což je instalační balíček obsahující klienta i serverovou část Quotero zároveň. Také se můžete podívat na seznam vydání Quotero a stáhnout instalační sadu podle libosti.

http://localhost:8080/manager/html

Stažený Deployer (soubor .war) nahrajte na server skrz administrační rozhraní Tomcatu. Tlačítko pro nahrání se nachází v části WAR file to deploy administračního rozhaní.

Dál se kliknutím na odkaz v řádku vedle quotero deployer přesuňte na instalační skript quotero. Než se pustíte do vlastní instalace, ujistěte se, že znáte uživatelské jméno a heslo správce databáze (MySQL nebo PostgreSQL a další) a také nastavte práva k určitým adresářům na plný zápis:

chmod a+rw /usr/share/tomcat6

chmod a+rw /var/lib/tomcat6

Pokud se instalační proces někde zastaví, pak bude "někde chyba", např. databáze Quoterro už existuje, nebo existují vlastní adresáře atd. Jednou z možných chyb může být např. špatně nastavené kódování v PostgreSQL serveru (zde je nutné kódování UTF-8).

Po instalaci by se vám měl objevit webový klient Quotero

http://localhost:8080/QuoteroClient/

do kterého se přihlásíte pomocí uživatelského jména admin a hesla admin.

Další odkazy
Quotero Quick Install

Jak nastavit výchozí kódování v PostgreSQL na UTF-8

Pomocí psql se nejprve přihlaste k PostgreSQL serveru. To obvykle uděláte např. tak, že se přihlásíte na uživatele postgres a pak zadáte psql:

su postgres

psql

Nejprve se můžete porozhlédnout po výchozím kódování vašich šablon, to se provede zadáním

\l

které může zobrazit např. toto

                              List of databases
   Name    |  Owner   | Encoding  | Collation | Ctype |   Access privileges  
-----------+----------+-----------+-----------+-------+-----------------------
 postgres  | postgres | SQL_ASCII | C         | C     |
 template0 | postgres | SQL_ASCII | C         | C     | =c/postgres
                                                      : postgres=CTc/postgres
 template1 | postgres | SQL_ASCII | C         | C     | =c/postgres
                                                      : postgres=CTc/postgres
(3 rows)

Odsud je vidět, že kódování šablony template1 je ASCII. Pro změnu nastavení je třeba šablonu nejprve odstranit

UPDATE pg_database SET datistemplate = FALSE WHERE datname = 'template1';

DROP DATABASE template1;

Dál jí znovu vytvořit s tím správným kódováním UTF-8:

CREATE DATABASE template1 WITH TEMPLATE = template0 ENCODING = 'UNICODE';

UPDATE pg_database SET datistemplate = TRUE WHERE datname = 'template1';

Pro kontrolu můžete zadat opět příkaz \l

\l
                              List of databases
   Name    |  Owner   | Encoding  | Collation | Ctype |   Access privileges  
-----------+----------+-----------+-----------+-------+-----------------------
 postgres  | postgres | SQL_ASCII | C         | C     |
 template0 | postgres | SQL_ASCII | C         | C     | =c/postgres
                                                      : postgres=CTc/postgres
 template1 | postgres | UTF8      | C         | C     |

Zdroje informací
Change Default Encoding of New Databases To UTF-8

Jak nainstalovat Tomcat

Tomcat, jinak řečeno Javu pro server, nainstalujete nejlépe takto. Nejprve je nutné nainstalovat JRE nebo JDK. Ideální je ta přímo od SUNu, ale ta zas není přímo součástí svobodných balíčků Debianu.

Z toho důvodu budete muset nejdřív zřejmě povolit zdroje balíčků ze sekce non-free. To se provede úpravou souboru /etc/apt/sources.list do např. následující podoby                       

deb http://ftp.debian.org/debian squeeze main contrib non-free
deb http://ftp.debian.org/debian squeeze-updates main contrib non-free
deb http://security.debian.org squeeze/updates main contrib non-free


(důležité jsou především direktivy non-free na konci řádků, které tento repoziář zapínají). Dál musíte provést aktualizaci zdrojů balíčků, zadáním

apt-get update

a dál už můžete Javu přímo od SUNu nainstalovat. V případě JRE (Java Runtime Environment) bude stačit následující

aptitude install sun-java6-jre

(Při instalaci je třeba souhlasit s licenčními podmínkami programu.) Dál je třeba nainstalovat vlastní Tomcat a k němu se určitě hodí i nějaké to administrační rozhraní. To se provede takto

aptitude install tomcat6 tomcat6-admin

Nyní se můžete v prohlížeči podívat na adresu serveru a informace o běžícím Tomcatu. Pro vstup do administračního rozhraní Tomcatu je ovšem třeba nejprve nastavit příslušná hesla v souboru /etc/tomcat6/tomcat-users.xml, kerý by měl při nejmenším obsahovat

<tomcat-users>
  <role rolename="manager"/>
  <user username="tomcat" password="heslo" roles="manager"/>
</tomcat-users>

(Uživatelské jméno a heslo si můžete měnit podle sebe, a také nezapomeňte restartovat Tomcat /etc/init.d/tomcat6 restart). Tomcat pak můžete zkontrolovat zadáním IP adresy počítače, kde běží

http://localhost:8080/

a dál vstoupit do administračního rozhraní (po zadání odpovídajícího hesla ve výše uvedeném souboru tomcat-users.xml).

http://localhost:8080/manager/html

nebo kliknutím na odkaz manager webapp, který se zobrazí na úvodní stránce Tomcatu.