Instalace a nastavení eDock Serveru & 602SQL Serveru na Linux |
Instalace eDock Server na Linux
Výchozí předpoklady
Produkt eDock je určen pro provozování v režimu klient/server, což znamená, že instalace obsahuje část pro server, na kterém běží databázový SQL server s modulem eDock, a část pro klienta. Klientská instalace integruje přístup k eDocku přímo do desktopu a Průzkumníka Windows.
Dalším (hlavním) klientem eDocku je samotný webový browser podporující grafické zobrazení webových stránek.
Instalace a základní zprovoznění aplikace eDock je navrženo tak, aby nebylo nutné instalovat vývojové a provozní prostředí 602SQL. Instalaci je možné provést přímo z příkazového řádku linuxové konzole a základní nastavení aplikace eDock pak přes webový browser.
Pro nastavení provozních parametrů SQL serveru je k dispozici Řídící konzole 602SQL a to ve verzích jak pro MS Windows tak pro prostředí X-Windows.
Poznámka:
Při instalaci v síti Intranet/Internet je podmínkou, že všechny instalované počítače jsou propojeny protokolem TCP/IP; toto je základní pracovní prostředí pro přístup více uživatelů k eDocku.
Chcete-li si spouštět aplikace ve webovém browseru mimo vaši lokální síť, je potřeba pevného připojení vaší sítě k Internetu.
Pro odesílaní zpráv z eDocku prostřednictvím elektronické pošty je nutný přístup k SMTP/POP3 serveru.
Instalace aplikace eDock na 602SQL server pro OS Linux
Samotná instalace aplikace eDock je prováděna třemi skripty shellu. Před samotnou instalací je však nezbytné provést několik přípravných kroků.
Instalace předpokládá, že jste přihlášen s právy superuživatele root.
Získání a použití licenčních čísel
Během instalace budete vyzvání k zadání licenčních čísel. Ujistěte se, že máte ze svého nebo jiného počítače přístup do Internetu; bez licenčních čísel se instalace úspěšně nedokončí.
Postup instalace:
Všechny komponenty pro instalaci na Linux jsou uloženy na tomto CD ROMu v adresáři /instalace_edock/linux.
- Pokud ještě nemáte nainstalován 602SQL Server, učiňte tak dle postupu Instalace a nastavení 602SQL Serveru na Linux.
V rámci zmíněného postupu proveďte vše i s registrací 602SQL Serveru. Add-on licence a eDock licenci budete uplatňovat později až v rámci tohoto postupu.
- Nejdříve nainstalujte programový balík WINE, který na Linuxu implementuje Windows API.
Instalaci provedete spuštěním skriptu ./install.1.sh, který vše potřebné zařídí za vás. Součástí instalace je přeložení a sestavení balíku WINE ze zdrojových souborů, proto vyžaduje přítomnost kompilátoru jazyka C++ a binutils na vašem počítači.
Tato fáze instalace je nejdelší a může trvat poměrně dlouho (na počítači s procesorem Celeron 333MHz a 128MB RAM cca 70 minut, na Celeron 1.2GHz a 512MB RAM cca 15 min).
Pokud chcete používat novější verzi balíku WINE, můžete ji získat na stránkách http://www.winehq.org/.
Stačí nahradit v adresáři obsahujícím instalaci starý soubor Wine-yyyymmdd.tar.gz (yyyy značí rok, mm pořadové číslo měsíce a dd den v měsící, kdy byla daná verze uvolněna) souborem novým a spustit první skript zadáním
./install.1.sh.
Je možné, že skript skončí hláškou:
*************************************************
*************************************************
The installed Wine libraries will not be found!
You can either:
Add the line '/usr/local/lib' to /etc/ld.so.conf and run /sbin/ldconfig
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
*************************************************
*************************************************
Není se třeba ničeho obávat. eDock je funkční i bez těchto nastavení. Pokud ovšem chcete používat WINE i samostatně, doporučujeme řídit se instrukcemi v řádku, výše zvýrazněném tučným písmem.
Pokud nechcete nebo nemůžete použít instalační skript install.1.sh, můžete provést instalaci ručně podle těchto pokynů.
- Zkopírujte celý obsah adresáře /instalace_edock/linux z instalačního CD do vyhrazeného adresáře na disku serveru, odkud budete eDock instalovat. Adresář může být kdekoliv, kde máte práva k zápisu. Adresář slouží pouze pro instalaci a později bude možné jej opět smazat.
Soubory install*.sh označte jako spustitelné (chmod +x ./install*.sh).
- Otevřete konfigurační soubor configuration v editoru a nadefinujte hodnoty proměnných dle svých potřeb. Všechny jsou v souboru popsány.
- Nyní vytvoříte nový databázový soubor do nějž bude posléze importována aplikace eDock.
- Nejjednodušší postup je spustit instalační skript číslo 2:
./install.2.sh
skript detekuje, že databáze dosud neexistuje a dotáže se vás, přejete-li si ji založit, odpovězte 'y'.
skript v souboru /etc/602sql zaregistruje novou databázi podle údajů uvedených v souboru configuration. Pokud se registrace zdaří, budete vyzvání ke spuštění SQL serveru nad novou databází.
- Druhou možností je zadat definici databáze do souboru /etc/602sql ručně. Jak to udělat se dozvíte zde. Také po provedení ruční definice je nutné nad databází spustit SQL server.
- Poslední možností je importovat aplikaci eDock do již existující databáze. Stačí uvést v souboru configuration parametry již existující databáze. Obecně tuto však možnost nedoporučujeme.
- Spusťte nad novou databází SQL server.
/etc/rc.d/init.d/602sql8 start
Příkaz se pokusí spustit všechny servery na vašem počítači. Některé ale již mohou běžet a tak se jejich opětovné spuštění nezdaří (musely by se je nejdříve zastavit). Důležité je, aby se rozběhl server, jehož název (default je edock) jste uvedli v souboru configuration
- Spusťte skript installkey.sh. Tento skript vyčte ze souboru /etc/602sql instalační klíč vaší databáze a vypíše je na obrazovku.
- Otevřete www prohlížeč a přejděte na stránku registračního portálu Software602:
http://www.602.cz/registrace/edockserver.htm.
- Pokud nemáte ještě zaregistrován 602SQL Server, zadáváte pouze instalační klíč. Pokud do následného registračního formuláře nezadáte žádná distribuční čísla, obdržíte po registraci pouze licenční číslo 602SQL (SQ1...) a bude moci eDock provozovat ve zkušebním TRIAL režimu po dobu 30 dnů.
Pokud do registračního formuláře zadáte požadovaná distribuční čísla, obdržíte po registraci celkem 3 e-maily (tj. licenční čísla pro 602SQL, pro eDock a pro Add-on pro 602SQL). Prefix distribučního čísla pro eDock je DED, pro add-on licence pro 602SQL je prefix DAQ.
- Pokud máte již zaregistrován 602SQL Server, zadáváte instalační klíč i použitou licenci k 602SQL Serveru.
- Obdržené nebo již dříve získané licenční číslo serveru zapište do sekce [.ServerRegKey], licenční číslo pro
Add-on licence 602SQL Serveru a licenční číslo eDocku do sekce [.ClientAccessLicences] do souboru /etc/602sql.
- Zastavte chod serveru (/etc/rc.d/init.d/602sql8 stop) a znovu jej spusťte (/etc/rc.d/init.d/602sql8 start) resp. jej restartujte (/etc/init.d/602sql8 restart).
Podívejte se do obsahu logu /var/lib/602sql/edock/wbsqllog.txt (pokud jste neměnili název databáze v souboru configuration) nebo do /var/lib/602sql/jméno_vaší_databáze/wbsqllog.txt.
Měl by tam být uveden správný počet zakoupených Add-on licencí (standardně 5). Licence pro eDock v logu 602SQL serveru neuvidíte.
- Vytvořte pro svůj eDock adresář a virtuální server v aplikaci Apache, případně můžete použít standardní nastavení (adresář /var/www/html).
Obsah adresáře by měl být prázdný; není to podmínkou. V tomto adresáři bude později vytvořen soubor index.html a dále sem bude zkopírován celý podadresář edock. Pokud v adresáři již máte nějaká data, zazálohujte si je!
- Znovu spusťte instalační skript install.2.sh. Instalace se řídí nastaveními v souboru configuration a trvá přibližně 20-30 sekund. Během instalačního procesu dochází k následujícím krokům:
- je zkontrolováno, je-li nainstalován balík WINE a 602SQL Server;
- je ověřeno, byla-li již zaregistrována databáze pro aplikaci eDock;
- do adresáře /usr/lib/602sql je zkopírována knihovna webdms.so a jsou k ní nastavena příslušná práva;
- je vytvořen uživatelský účet pod nímž poběží eDock daemon a do domovského adresáře účtu jsou nainstalovány všechny soubory potřebné pro běh démona. Jedná se o spustitelné soubory a knihovny pro Win32 API a konfigurační soubory prostředí WINE, které WIN32 API na Linuxu implementuje.
- do adresáře /etc/rc.d/init.d jsou zkopírovány startup skripty zajišťující spuštění eDock daemona během startování Linuxu. Pomocí administrátorského nástroje chkconfig jsou tyto skripty zaregistrovány pro spuštění na patřičných runlevelech.
- do adresáře web serveru jsou zkopírovány podadresáře www objektů aplikace eDock a instalační balíček Windows klienta. Jako vlastník souborů je nadefinován uživatel, pod kterým běží webový server.
- v adresáři web serveru se vygeneruje startovací stránka index.html tj. rozcestník aplikací.
- Spusťte instalační skript install.3.sh. Instalace se řídí nastaveními v souboru configuration a trvá přibližně 20-30 sekund. Během instalačního procesu dochází k následujícím krokům:
- do 602SQL serveru je přidán nový uživatel a je obsazen do role administrator a pro tohoto uživatele je nadefinováno přístupové heslo;
- do 602SQL serveru je přidán uživatel __web, s minimálními právy nezbytnými pro umožnění WWW přístupu;
- uživateli ANONYMOUS, který má v nově vytvořené databázi maximální práva, je většina práv odebrána. Jsou mu ponechána pouze minimální práva nezbytná pro přístup k veřejným dokumentům v eDocku. Tento uživatel bude nadále využíván pro veřejný (anonymní) přístup k eDocku.
- do databáze je naimportována aplikace eDock;
- je provedena počáteční inicializaci aplikace a nastavení některých počátečních parametrů;
- do 602SQL serveru jsou importovány upravené procedury volané automaticky při startu a ukončení SQL serveru;
- je nastaveno zálohování databáze podle definice v souboru configuration.
- Nyní máte možnost nadefinovat v souboru /etc/602sql e-mail profil podle dokumentace k 602SQL serveru a tento profil potom vybrat v administraci eDocku (webové rozhraní), aby mohl odesílat a případně i přijímat poštu viz Zprovoznění odesílání e-mailů. Po nadefinování poštovního profilu je nutné 602SQL Server restartovat.
- Restartujte 602SQL Server příkazem /etc/init.d/602sql8 restart
- Spusťte eDock daemona, což provedete příkazem /etc/init.d/edockd2 start. Daemon je při každém dalším startu počítače spouštěn automaticky.
- Nyní je hotova instalace aplikace eDock.
Pro vstup do aplikace eDock můžete použijte webový browser ze stránky http://www.domena.cz/edock (cesta na váš eDock je uvedena v konfiguračním skriptu). Po provedení instalace Windows klienta eDocku můžete na server přistupovat také prostřednictvím tohoto specializovaného klienta.
Pro přihlášení na 602SQL server použijte přihlašovací jméno a heslo administrátora 602SQL serveru, které jste definovali v konfiguračním skriptu configuration.
Poznámka:
Pokud se během instalace zobrazí chybové hlášení, ujistěte se, že jste postupovali dle pokynů instalace a že jste zadali správné hodnoty.
Pokud i přesto se instalace nezdaří, kontaktujte
technickou podporu.
Postupy ručních instalací
Instalace a nastavení 602SQL Serveru na Linux RedHat
Tato distribuce vychází z RedHat 7.3 a instalace by měla probíhat obdobně.
- Instalace balíku 602sql-8.1-1.i386.rpm
rpm –ihv ./602sql-8.1-1.i386.rpm
Uvedenou instalací se zkopírují příslušné soubory 602SQL serveru a řádkového klienta do obvyklých adresářů. Dále je automaticky vytvořen uživatel sql602 (pokud již dříve nebyl založen). Pod účtem tohoto uživatele poběží 602SQL server.
Do /etc/rc.d/init.d byl přidán spouštěcí skript 602sql8 a byl na něj zřízen odkaz v adresářích /etc/rc.d/rc[0-6].d pro automatické spouštění a ukončování běhu 602SQL serveru při startu, resp. vypínání serveru.
Dále byla vytvořena první databáze testdb (přesněji adresář pro ni a odkaz v konfiguračním souboru – samotná databáze se vytvoří automaticky po prvním spuštění SQL serveru)
Poznámka: Pokud v distribuci Linuxu chybí knihovna libstdc++-libc6.2-2.so.3 nebo některá funkce z ní (pozorováno např. na distribuci Debian), nepůjde SQL server spustit a oznámí chybu typu _symbol not found_. V tomto případě nainstalujte balík 602sql-libraries-8.1-1.i386.rpm.
- Nyní se již můžete pokusit o první spuštění 602SQL serveru. Server spustíte příkazem /etc/rc.d/init.d/602sql8 start.
Protože ale ještě nemáte prvotní licenční číslo pro umožnění startu 602SQL serveru, objeví se pouze chybové hlášení s popisem, kde toto licenční číslo zdarma obdržíte. V URL odkazu který vidíte je uvedeno váš "instalační klíč", který byl vygenerován při prvním spuštění SQL serveru. Na základě tohoto čísla vám bude na registračním serveru Software602 zdarma vygenerováno licenční číslo.
- Nyní podle instrukcí v chybovém hlášení proveďte registraci.
Pokud se vám nechce opisovat url a instalační klíč, použijte příkaz
/etc/rc.d/init.d/602sql8 start 2>reg.sh
Nyní se vám v adresáři, ve kterém jste provedli příkaz vytvořil soubor reg.sh, který obsahuje tři řádky zmíněného chybového hlášení. Otevřete jej v editoru a vymažte první a třetí řádek tak, aby v souboru zbylo jen příslušné url s vaším instalačním klíčem.
Celou URL adresu dejte do uvozovek a na začátek řádku doplňte lynx. Řádek pak bude vypadat následovně:
lynx "http://eshop.software602.cz/...........X6-000-XXXXXXXXX"
Spusťte soubor příkazem sh ./reg.sh
Tím se spustí webový prohlížeč lynx a otevře se v něm registrační stránka.
Vyplňte registrační údaje. Pokud instalujete 602SQL server u zákazníka, tak jako
e-mail adresu uveďte zákazníkovu a svou jako "na vědomí". Licenční číslo přijde současně na obě adresy.
- Během několika minut (zpravidla okamžitě) vám přijde na vámi uvedenou e-mail adresu licenční číslo pro registraci 602SQL Serveru (licence začíná prefixem SQ1...).
Zapište jej do souboru /etc/602sql do sekce [.ServerRegKey] a za toto číslo napište znak "=" jako je tomu u instalačního klíče v sekci [.InstallationKeys].
Nastavte práva k souboru /etc/602sql tak, aby do něj mohl zapisovat uživatel sql602 pod kterým SQL server běží. To uděláte příkazem
chown sql602:sql602 /etc/602sql
- Nyní se můžete podívat i na ostatní nastavení uvedené v /etc/602sql které jsou zde uvedeny. Všechna možná nastavení jsou popsána v dokumentaci k serveru.
- Spusťte opět server příkazem /etc/rc.d/init.d/602sql8 start.
Tentokrát již proběhne start serveru v pořádku. Můžete to ještě ověřit příkazem ps ax|grep 602sql8. Tento příkaz zobrazí všechny běžící procesy v jejichž názvu je "602sql8". Měli byste vidět 4 procesy. To je základní nastavení.
- Dokumentaci najdete v adresáři /usr/share/doc/602sql8/html/ jako soubor htmldoc.tar.gz. Rozbalením tohoto souboru příkazem
tar -vxzf ./htmldoc.tar.gz ve zmíněném adresáři dostanete kompletní dokumentaci v sadě html stránek. Na prohlížení musíte použít grafický webový browser, nejlépe Mozilla.
Změna jazyka fulltextového indexování a vyhledávání v souborech uložených v eDocku
eDock umí zaindexovat běžné formáty souborů (formátu doc, wpd, xls, pdf atd.) a pak lze použít funkci fulltextového vyhledávání. Správce eDocku nastaví jazyk, ve kterém se toto indexování má provádět - dostupné jazyky jsou čeština a slovenština. Nezávisle lze nastavit jazyk webového rozhraní.
Při instalaci je v souboru configuration uvedena proměnná, podle které se jazyk fulltextového vyhledávání vybere. Kromě toho je potřeba, aby i ostatní proměnné odpovídaly vaší konkrétní instalaci (doporučujeme si původní konfigurační skript uschovat). Tento jazyk lze dodatečně měnit a jeho postup je následující:
- V souboru configuration změňte nastavení jazyka z language='CZ' na language='SK' nebo obráceně.
- Ověřte, že jméno a heslo administrátora SQL serveru v souboru configuration jsou nastaveny správně a je aktuální. Jde o řádky "admin=..." a "heslo=..."
- Zastavte eDock démona příkazem /etc/init.d/edockd2 stop
- Spusťte skript ./changelang.sh
- Restartujte 602SQL Server /etc/init.d/602sql8 restart
- Znovu spusťte eDock démona: /etc/init.d/edockd2 start
Pokud se nyní podíváte do eDocku, zjistíte, že většina souborů není zaindexována. Démonovi může trvat i několik hodin, než provede opětovné zaindexování celého obsahu eDocku v nově zvoleném jazyce. Po dobu indexování nebude plně fungovat fulltextové vyhledávání a eDock server může vykazovat mít delší odezvy.
Zprovoznění odesílání e-mailů:
- Nejprve aktivujte funkci pro odesílání e-mailů ze SQL serveru: na Windows se poštovní profil vytváří pomocí aplikace Konfigurace 602SQL a na Linuxu přímou editací souboru /etc/602sql.
Parametry poštovních profilů pro Linux
Profil je sada parametrů, které jsou potřeba k inicializaci použité pošty. Aplikace potřebuje pro zpřístupnění pošty znát pouze jméno profilu a prakticky vůbec nemusí brát ohled na to, která z podporovaných pošt je v cílovém prostředí nainstalovaná. Pokud se změní některý z parametrů pošty, není třeba měnit aplikaci, stačí změnit hodnotu parametru v profilu. V systému může existovat několik profilů, které se liší svým jménem, implicitní profil má jméno prázdné.
Pro vytváření a správu profilů na X-Window Linuxu lze použít aplikaci Konfigurace 602SQL, položka stromu Poštovní profily.
Na Linuxu jsou profily uloženy v souboru /etc/602sql. Implicitní profil je v sekci [.MAIL_] a další pojmenované profily jsou uvozeny sekcí [.MAIL_jméno profilu]. Soubor 602SQL se edituje ručně z prostředí OS. Je zřejmé, že pro tyto OS se uplatní pouze profily typu SMTP/POP3.
Do souboru 602SQL nelze uložit zašifrované přístupové heslo do POP3 schránky.
Příklad implicitního profilu definovaného na Linuxu v souboru 602SQL:
[.MAIL_]
SMTPServer=databaze602.soft602.cz
MyAddress=server@soft602.cz
POP3Server=databaze602.soft602.cz
UserName=server
Password=heslo
FilePath=/602sql/send;/602sqlsend/temp
Parametry profilu pro SMTP/POP3
- SMTPServer
- Jméno nebo IP adresa SMTP serveru
- MyAddress
- Poštovní adresa, která bude v zásilkách uvedena jako adresa odesílatele
- POP3Server
- Jméno nebo IP adresa POP3 serveru
- UserName
- Jméno uživatele poštovní schránky
- Password
- Heslo pro přístup do POP3 schránky; může se zde uvádět, pokud to nevadí požadované bezpečnosti.
- DialConn
- Jméno telefonního připojení (ze složky Telefonické připojení sítě)
- DialUserName
- Jméno uživatele telefonního připojení k Internetu
- FilePath
- Seznam adresářů (s absolutními cestami v syntaxi daného OS) oddělených středníkem, ze kterých lze připojit soubor k zásilce (a tudíž odeslat). Pokud se aplikace pokusí odeslat soubor z jiné složky, než je v seznamu, bude požadavek odmítnut. Jestliže parametr není specifikován, nebo obsahuje-li prázdný řetězec, bude možné odeslat libovolný soubor. Jde o to, že SQL server zpravidla běží s velkými přístupovými právy a je třeba neprivilegovaným uživatelům databáze zabránit v neoprávněnému přístupu k souborům.
Příklad (Windows): D:\sqldata;D:\sqldata\temp
Příklad (UNIX): /sqldata;/sqldata/temp
Parametry SMTPServer a MyAddress jsou povinné pro odesílání pošty. Parametry POP3Server a UserName jsou povinné pro příjem pošty. Parametry DialConn a DialUserName jsou nutné pouze pokud je počítač připojen k Internetu pomocí vytáčené linky. Konfigurační panel umožňuje navíc do profilu v registrační databázi Windows uložit heslo pro přístup k POP3 schránce (pro odesílání pošty není heslo potřeba) a případně heslo pro telefonní přístup k Internetu.
- V sekci Administrace webového rozhraní eDocku podle potřeby aktivujte používání pošty nastavením existujícího poštovního profilu.
Ruční instalace balíku WINE
Tato sekce zjednodušeně popisuje ruční instalaci balíku WINE, který implementuje Windows API na Linuxu.
Silně doporučujeme neprovádět ruční instalaci, ale použít instalační skript install.1.sh, který provede vše potřebné za vás.
Pokud pouze chcete instalovat novější verzi WINE než je ta, která je součástí instalace eDocku, nemusíte provádět ruční instalaci.
Stačí nahradit v adresáři obsahujícím instalaci starý soubor Wine-yyyymmdd.tar.gz souborem novým a spustit skript install.1.sh.
Je velmi pravděpodobné, že pro váš systém nebude nová verze WINE dostupná v RPM nebo jiném distribučním balíčku s již zkompilovanými binárními soubory. Instalace WINE ze zdrojových souborů není o mnoho složitější než z binární distribuce a proto ji doporučujeme. Aktuální zdrojové distribuce WINE naleznete na stránkách http://www.winehq.org/. Upozorňujeme, že není nutné mít nainstalována X-Windows. Zjednodušený postup instalace je následující:
- Stáhněte archiv se zdrojovou distribucí WINE ve verzi alespoň 20030618. Zdrojová distribuce je soubor pojmenovaný Wine-yyyymmdd.tar.gz, kde první čtyři číslice yyyy značí rok, další dvě mm měsíc a poslední dvě dd den v měsíci).
- Rozbalte archiv na Linuxovém serveru, na němž chcete WINE instalovat.
- Vstupte do adresáře v němž jsou zdroje WINE rozbaleny a napište ./tools/wineinstall. Nesmíte být přihlášeni jako root. V závěrečné fázi instalace však můžete být vyzváni k zadání hesla uživatele root, neboť poslední fáze instalace musí být prováděna s identitou root.
- Proběhne autokonfigurace sestavovacích parametrů.
Pokud máte nainstalována X-Windows, bude následně provedena kompilace, sestavení a instalace sestavených binárních souborů balíku WINE.
Jestliže X-Windows nainstalována nemáte, skončí wineinstall po provedení konfigurace s hlášením, upozorňujícím na nepřítomnost knihoven pro X-Windows. Text vás upozorní, že pokud si přesto přejete pokračovat, musíte z příkazové řádky zadat příkazy make depend && make, které povedou k sestavení binárních souborů; poté se přihlaste jako root a zadejte make install. Poslední příkaz provede instalaci sestavených binárních souborů na patřičná místa v souborovém systému.
Podrobněji je kompletní popis instalace popsán jednak v soboru README, který je součástí zdrojů WINE a jednak na stránkách http://www.winehq.org/.
Ruční definice databáze SQL serveru
Pro bezpečný provoz eDocku je třeba nechat si 602SQL serverem vygenerovat nový (další) instalační klíč a vytvořit novou databázi, do které budete instalovat aplikaci eDock.
Tato procedura je velmi jednoduchá. Řekněme, že nová databáze se bude jmenovat edock.
Vytvořte adresář /var/lib/602sql/edock příkazem
mkdir /var/lib/602sql/edock.
Uživatel sql602 musí mít práva k zápisu do tohoto adresáře. To nastavíte příkazem
chown -R sql602:sql602 /var/lib/602sql/edock.
Na konec souboru /etc/602sql zapište následující řádky:
[edock]
PATH=/var/lib/602sql/edock
USER=sql602
AUTOSTART=yes
IP address=127.0.0.1
IPport=6011
InstallationKey=NEW
- První řádek vyznačuje začátek sekce pro databázi pojmenovanou edock.
- Druhý řádek, definující hodnotu PATH, je cesta k souborům databáze.
- Třetí, čtvrtý a pátý řádek jsou převzaty ze sekce databáze testdb a určují uživatelský účet pod kterým běží server, že se má startovat automaticky a na které IP adrese jej má hledat lokální klient.
- Šestý řádek, definující hodnotu IPport, je velmi důležitý. Každé síťové spojení (protokolem TCP/IP) je adresováno IP a portem. Například www server máte standardně na portu 80 a ftp server na portu 21. Přitom máte oba servery na stejné IP adrese. Dva různé 602SQL servery nemohou naslouchat zároveň na stejné IP adrese a portu.
Vzhledem k tomu, že 602SQL server standardně běží na portu 5001, běží na něm tedy váš původní server s databází testdb. Je tedy třeba zvolit pro databázi edock jiný port; pro náš postup doporučujeme hodnotu 6011.
Protože 602SQL server používá porty tři (vždy základní +1 pro UDP a základní +2 pro Direct IP replikace) je vhodné pro každý další server (databázi) stanovit port nejméně o 3 vyšší než předchozí.
- Na sedmém řádku uvádíme, že SQL server má po novém spuštění vygenerovat nový instalační klíč. Tento instalační klíč se automaticky zapíše na místo slova NEW; k tomuto instalačnímu klíči se budou později přidávat Add-on a eDock licence.
Nastavte práva k souboru /etc/602sql tak, aby do něj mohl zapisovat uživatel sql602 pod kterým SQL server běží. To uděláte příkazem
chown sql602:sql602 /etc/602sql
Zastavte chod serveru (/etc/rc.d/init.d/602sql8 stop) a znovu jej spusťte (/etc/rc.d/init.d/602sql8 start). Podívejte se do adresáře /var/lib/602sql/edock, měl by tam být alespoň hlavní soubor databáze wb8.fil.
Podívejte se znovu do souboru /etc/602sql. Slovo NEW by mělo být nahrazeno novým instalačním klíčem. Tento klíč byl také připsán nahoru do sekce [.InstallationKeys]. Tento klíč můžete uplatnit stránce registračního portálu Software602:
http://www.602.cz/registrace/edockserver.htm k získání licenčního klíče a Add-on licencí pro váš server.
Je nezbytné, aby se název databáze uvedený v souboru configuration shodoval s názvem vytvořené databáze. Doporučujeme tyto údaje ještě jednou zkontrolovat!