Naše společnost ANNECA Vám děkuje, že jste se rozhodli používat internetový informační systém InTouch CRM. Jedná o software založený na progresivní technologii Java, využívající ke své práci SQL databázi. Tím je zaručena přenositelnost aplikace na většinu dnes dostupných operačních systémů.
InTouch CRM je tzv. vícevrstvý software. To znamená, že ke své činnosti využívá další software, který je nutné nainstalovat ještě před tím, než začnete instalovat vlastní aplikaci. Všechny požadované softwarové balíky jsou k dispozici zdarma na internetu. Zde je přehled toho, co musíte stáhnout:
Instalační balíček najdete na adrese http://www.oracle.com/technetwork/java/javase/downloads/index.html. Na této stránce naleznete několik tlačítek na stažení softwaru. Ten správný je pojmenován "JDK". Stáhněte si tento balíček, spusťte jej a nainstalujte JDK do libovolného adresáře.
Instalační balíček databázového serveru je k dispozici na stránkách http://dev.mysql.com/downloads/mysql. Doporučujeme verzi 8.0.
Instalace tohoto SQL serveru je jednoduchá. Buď spustíte instalační program a nebo si necháte rozbalit na svůj disk stažený archiv. Doporučujeme Vám, abyste nechali MySQL spouštět jako službu hned po startu počítače.
Pro budoucí instalaci aplikace InTouch CRM budete potřebovat, aby byla v databázi založena prázdná databáze. Její založení je popsáno v další kapitole.
Adresář, do kterého je instalován SQL server budeme v dalším textu označovat jako [mysql].
Instalační balíček aplikačního serveru je k dispozici na stránkách http://tomcat.apache.org/. Stáhněte si verzi 9.
V případě, že budete instalovat Tomcat na Linuxový server, doporučujeme jeho umístění do adresáře /usr/local/tomcat nebo /opt/tomcat. Pokud máte Windows server, Tomcat se standardně instaluje do adresáře c:\Program Files\Apache Software Foundation\Tomcat x. Nezapomeňte jej naistalovat jako službu. V dalším popisu budeme adresář s instalovaným Tomcatem označovat jako [tomcat].
Pozor, instalátor Tomcatu pro Windows nabízí uživateli při instalaci cestu k JRE (Java Runtime Environment), což je nedostatečná verze Javy pro plnohodnotný běh Tomcatu. Je potřeba ručně vybrat cestu k adresáři s celým JDK.
Důležité: InTouch CRM Enterprise (placená verze) vyžaduje pro svůj běh, aby byl Tomcat nakonfigurován s podporou HTTPS protokolu. Budete tedy potřebovat certifikát na web serveru. Dokumentaci, jak nakonfigurovat SSL/TLS v Tomcatu naleznete zde.
Upozornění: pokud provádíte aktualizaci InTouch CRM ze starší verze, přeskočte nyní ve čtení na další podkapitolu.
Produkt InTouch CRM je distribuován v souboru s názvem intouch.war. Při instalaci tohoto souboru postupujte podle následujících kroků:
# cd [tomcat]/bin # ./shutdown.shWindows:
# cd [mysql]/bin # mysql -u root > CREATE SCHEMA intouch DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_czech_ci; > grant all privileges on intouch.* to UZIVATEL identified by 'HESLO'; > exitPoznámka: [mysql] je název adresáře, ve kterém je instalován databázový server, údaje UZIVATEL a HESLO nahraďte jménem uživatele a jeho heslem, pod kterým se bude InTouch CRM přihlašovat do databáze. Tyto údaje budete potřebovat později.
https://<server>:<port>/intouchÚdaje <server> a <port> jsou název stroje, na kterém běží Tomcat a http port, na kterém Tomcat čeká na spojení. Při instalaci Tomcatu je nabízen port 8080 (http) a 8443 (https). Můžete jej však změnit na 80 resp. 443, který je standardním portem a nemusí se pak v adrese uvádět.
Při aktualizaci produktu InTouch CRM postupujte podle níže uvedených kroků.
# cd [tomcat]/bin # ./shutdown.shWindows:
# cd [mysql]/bin # ./mysqldump -u root -R intouch > [cesta]/[soubor]
# cd [tomcat]/bin # ./startup.shWindows:
https://<server>:<port>/intouchÚdaje <server> a <port> jsou název stroje, na kterém běží Tomcat a http port, na kterém Tomcat čeká na spojení. Při instalaci Tomcatu je nabízen port 8080 (http) a 8443 (https). Můžete jej však změnit na 80 resp. 443, který je standardním portem a nemusí se pak v adrese uvádět.
Pokud chcete InTouch CRM používat pro reálný provoz a neinstalujete jej pouze za účelem vyzkoušení, bude vás nejspíš zajímat několik dalších otázek. Následuje jejich přehled:
Těsně po instalaci je aplikační server Tomcat spouštěn se standardním množstvím dostupné paměti, cca 64 MB. Pokud aplikace dosáhne této hranice, začne hlásit chybu OutOfMemoryError (nedostatek paměti). Děje se tak i přesto, že server má fyzicky třeba 2 GB RAM.
Na operačním systému typu UNIX nadefinujte proměnnou s názvem CATALINA_OPTS, která bude mít hodnotu -Xmx512m. Tento údaj znamená, že Tomcat může pro své potřeby použít až 512 MB paměti RAM. To by mělo pro běžnou instalaci InTouch CRM stačit.
CATALINA_OPTS=-Xmx512m
Jestliže používáte Windows, je nastavení tohoto parametru složitější. Tomcat, který běží jako NT služba očekává tento údaj v registrech operačního systému. Navíc je tento údaj umístěn pro různé verze Tomcatu na jiném místě.
Naštěstí je spolu s Tomcatem dodáván skript s názvem service.bat, který instaluje Tomcat jako službu. Parametry tohoto skriptu je možné velikost paměti určit. Doporučujeme přečíst návod k instalaci aplikačního serveru Tomcat.
Tomcat má po instalaci vypnutou podporu protokolu HTTPS, a proto je nutné upravit jeho konfigurační soubory, pokud chcete k InTouch CRM přistupovat v bezpečnějším režimu.
V souboru [tomcat]/conf/server.xml najdete v poznámkách postup jak aktivovat HTTPS protokol. Po úpravě konfigurace je nutné Tomcat restartovat.
Pokud již máte na serveru nainstalovaný InTouch CRM, měli byste pro přístup na tento server povolit porty 80 (HTTP) a 443 (HTTPS). Aby mohl InTouch CRM stahovat a odesílat poštu (obsahuje vestavěného e-mailového klienta), bude nutné povolit i přenos pro porty 110 (POP3), 143 (IMAP) a 25 (SMTP).