PDS - PrunierDataServer

Návod k instalaci daemona PDS

Veškeré zde uvedené informace se týkají instalace v prostředí linuxové distribuce Debian, popřípadě distribucí z Debianu odvozených. V případě jiných distribucí může být postup odlišný.

PDS daemon je v současné době dodáván v podobě zdrojových kódů uložených v archívu tar.gz a je ke stažení zde:
pds.tar.gz.

• Pro úspěšnou instalaci a překlad potřebujete mít nainstalován zejména překladač:

  apt-get install gcc

• pak si vytvoříte adresář /usr/src/pds

  mkdir /usr/src/pds

• přepnete se do toho adresáře

  cd /usr/src/pds

• stáhnete zdrojové kódy daemona

  wget http://pds.fi.cz/pds.tar.gz

  v případě, že nemáte nainstalován wget, nainstalujte jej za pomocí

  apt-get install wget

• rozbalte stažené zdrojové kódy daemona

  tar xzf pds.tar.gz

• proveďte překlad

  ./compile.sh

V případě úspěšného provedení všech bodů budete mít k dispozici binárku pds.

Nyní je nutné zajistit její korektní spuštění a zavedení na pozadí po startu systému. K tomuto použijeme debianího start-stop-daemona.

• Daemona nedoporučuji spouštět pod rootem a z toho důvodu doporučuji vytvořit uživatele pds. V případě, že jste v systému přihlášení ne pod uživatelem root, ale pod uživatelem systému, musíte u dalších příkazů vždy předřazovat příkaz sudo. Tj. např.: sudo adduser --shell /bin/false --disabled-login pds. Popřípadě se přepnout do shellu s právy roota za pomocí např.: sudo bash.

  Nyní si vytvoříme nového uživatele:

  adduser --shell /bin/false --disabled-login pds

• V případě, že používáte Debian či z něj odvozené distribuce a vytvořili jste si uživatele pds, můžete ke spuštění využít skript, který naleznete v podadresáři ./scripts. Skript prekopirujte do /etc/init.d za pomoci

  cp ./scripts/pds /etc/init.d/

  a vytvořte automatické zavádění tohoto souboru za pomocí

  insserv pds

Nyní by již měl být daemon kompletně nainstalován a mělo by být zajištěno i jeho korektní spuštění. Zbývá ještě vytvořit podadresář určený pro uložení dat. Defaultně se jmenuje defaultkey, ale můžete jej pojmenovat i jinak a to až 32 znaky z následujících

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz$%'`-@{}~!#()&_^.

přičemž název nesmí začínat tečkou. Stejný název pak nastavujete na klientské straně. Defaultní adresář pro uživatele pds vytvoříte za pomocí:

mkdir /home/pds/defaultkey; chown pds:pds /home/pds/defaultkey

v případě, že neexistuje konfigurační soubor pds /etc/pds/pds.conf hledá daemon svůj domovský datový adresář v podadresáři pds uživatelského adresáře tj. ~pds. Toto může být možný zdroj problémů v případě, že spouštíme daemona například prostřednictvím sudo, jelikož pak se proměnná prostředí HOME nemění a směřuje na původního uživatele. Z tohoto důvodu překopírujeme vzorový konfigurační soubor a provedeme v něm nastavení a cesta k datům bude vždy jasná. Popis jednotlivých nastavení naleznete zde.

A nyní překopírovaní vzorového konfiguračního souboru:

mkdir /etc/pds; cp ./etc/pds.conf /etc/pds/pds.conf

editaci provedete např. příkazem

nano /etc/pds/pds.conf

Nyní můžete daemona spustit za pomocí

/etc/init.d/pdsstart start

zda jste uspěli můžete ověřit příkazem:

netstat -pan | grep 7777

V případě, že vše proběhlo korektně, vypíše příkaz informaci, jinak zůstane bez výstupu.

Nastavení na klientské straně - program WinDUO

Pro zprovoznění klientské strany potřebujete síťovou verzi programu WinDUO a to minimálně verze 1.67.C
Přepnutí do klientského módu pds provedete v souboru data.ini tam, kde máte data WinDUO. Do sekce [INFO] přidáte položku Server=xxx.xxx.xxx.xxx kde xxx.xxx.xxx.xxx nahradíte IP adresou serveru se spuštěným daemonem. Např.: Server=192.168.0.1.

Přenos dat z původní instalace na pds demona provedete tak, že data zaarchivujete, pak nastavíte pro využívání pds a data odarchivujete.
Přímý přenos *.dat a *.inx souborů do datového adresáře pds daemona je také možný, ale je nutné mít na paměti, že veškeré názvy souborů musí být převedeny na malá písmena (ve zdrojích pds daemona naleznete v podadresáři ./scripts skript tolower, využívající perl, který můžete k převodu na malá písmena využít). Nezapomeňte i na správného vlastníka souborů, nastavit jej můžete např.: chown -R pds:pds ~pds.

Na co nezapomenout pokud chcete PDS daemona spouštet s chroot

• Zkopírovat do nového rootu pro PDS adresáře /lib a popřípadě i symbolické odkazy /lib64
• Vytvořit adresář /tmp
• Překopírovat /etc/localtime do nového PDS rootu /etc
• Vše co patří PDS dát do jeho rootu /etc /bin ...
• Správně nastavit práva
• Spouštet lze například takto:
  /sbin/start-stop-daemon --start --background --user pds --group pds --chuid pds:pds --chdir / --pidfile /pds.pid --chroot /home/pds --verbose --exec /bin/pds
  v případě, že domovský adresář PDS daemona je /home/pds