platformaCRM

Instrukcja instalacji systemu

Wersja 1 2013-11-19 Marta Pieszyńska

Spis treści

2 Wymagania Serwer 2

3 Wymagania klient 2

4 Instalacja 2

4.1 Krok 2 (Instalacja SQL SERVER, podczas instalacji należy zaznaczyć tryb autoryzacji Mixed mode) 2

4.2 Krok 3 (Konfiguracja SQL SERVER) 2

4.3 Krok 4 (Instalacja Bazy) 2

4.4 Opcjonalna konfiguracja dostępu zewnętrznego do sql server Express 3

4.5 Krok 1. (Instalacja IIS Web server) 4

5 Instalacja aplikacji platformaCRM 5

6 Instalacja baz danych 5

7 Podłączenie JASPER(4.7) do SQL Server 6

8 Instalacja aplikacji na czytniki 7

9 Konfiguracja puli aplikacji (dla wersji IIS 7.5) 8

Wymagania Serwer

  • Microsoft Windows Server 2008R2/2012 64-bit OS
    Recomended: Intel XEON+ 8GB+ RAM 150+ GB HDD
  • Microsoft IIS 7/7.5/8 (part of windows Server) with .NET FRAMEWORK 4.5
  • Microsoft SQL server 2012 ( Express or above )
    Recomended: SSD Intel 710 or Intel S3700 or fast storage
  • Jasper Server Jasper minimum 4.7
  • Zainstalowany program wkhtmltopdf w domyślnej lokacji na dysku „C”

Wymagania klient

  • Przeglądarka Internetowa Google Chrome

Instalacja

Krok 2 (Instalacja SQL SERVER, podczas instalacji należy zaznaczyć tryb autoryzacji Mixed mode)

Krok 3 (Konfiguracja SQL SERVER)

  1. Uruchomić Managment Studio
  2. Dodać użytkownika, na którym będzie działała aplikacja

-- Dodanie uzytkownika

CREATE LOGIN [platformaUser] WITH PASSWORD = 'sadfewge3*';

EXEC sp_addsrvrolemember 'platformaUser', 'sysadmin'

Krok 4 (Instalacja Bazy)

System do poprawnego działania wymaga dwóch baz danych

Nazwy baz danych mogą się różnic w zależności od klienta.

  • CRM0000_CONFIG – Baza konfiguracyjna
  • CRM0100_KLIENT – Baza przechowująca dane

Baza jest dostarczana, jako plik bak

Jeśli serwer jest przenoszony należy wykonać pełna kopie bazy danych z starego serwera

-- opcjonalnie backup istniejącej bazy danych

BACKUP DATABASE [CRM0000_CONFIG] TO DISK = 'c:\CRM0000_CONFIG.bak' WITH FORMAT;

BACKUP DATABASE [CRM0100_KLIENT] TO DISK = 'c:\CRM0100_KLIENT.bak' WITH FORMAT;

  • Odtworzenie bazy danych na nowym serwerze (wymagna skopiowanie plikow CRM0000_CONFIG.bak CRM0100_KLIENT.bak)

-- opcjonalnie backup istniejącej bazy danych

RESTORE DATABASE [CRM0000_CONFIG] FROM DISK = 'c:\CRM0000_CONFIG.bak' WITH NOUNLOAD, REPLACE, STATS = 10;

RESTORE DATABASE [CRM0100_KLIENT] FROM DISK = 'c:\ CRM0100_KLIENT.bak' WITH NOUNLOAD, REPLACE, STATS = 10;

Jeśli zamiast przywracania z backupu wybiera się ściężke zeskryptowania bazy to koniecznie trzeba zeskryptować COLLATE

Opcjonalna konfiguracja dostępu zewnętrznego do sql server Express

KONFIGURACJA SIECIOWA

netsh firewall show logging
netsh firewall set logging droppedpackets=ENABLE
netsh firewall set icmpsetting type=ALL mode=enable

REM MOZNA TAK DLA WSZYSTKICH

netsh firewall add portopening tcp 49172 "SQL_CRM"
netsh firewall add portopening udp 1434 "SQL_CRM_browser"
netsh firewall add portopening tcp 21 "FTP"
netsh firewall add portopening tcp 80 "WWW"
netsh firewall add portopening tcp 443 "WWW-SSL"
netsh firewall show state ENABLE

Dostęp do SQL server z zewnątrz

Aby umożliwić zewnętrzny dostęp do SQL servera należy

ustawić na sztywno port dla instancji np.:
sql server configuration manager > wybrać instancje > ustawić port jak na rysunku

Uwaga TCP Dynamic Ports trzeba wyczyscic!

wystartowac sql browser (mogl byc disabled sql server configuration manager )

Dodac regule dla tego portu w windows firewall (W POPRZEDNIM PUNKCIE)

więcej na http://msdn.microsoft.com/en-us/library/cc646023.aspx

więcej na http://msdn.microsoft.com/en-us/library/ms345327.aspx
więcej o portach na sql http://msdn.microsoft.com/en-us/library/cc646023.aspx#BKMK_dynamic_ports

Krok 1. (Instalacja IIS Web server)

  1. Add or Remove program
  2. Turn Windows Feature
  3. Web Server (IIS) powinien byc zaznaczony jesli nei nalezy zaznaczyc

Instalacja aplikacji platformaCRM

  1. Pobranie dostarczonej paczki z bieżącą wersją aplikacji lub spakowanie zawartości folderu aplikacji z bieżącego serwera
  2. W wybranym folderze rozpakować paczkę (folder nie powinien wcześniej zawierać innych plików) (ewentualnie może zawierać folder datastore)
  3. Uruchomić Manager IIS
  4. W wybranej witrynie (może być Default Web Site) dodajemy nową aplikację i definujemy jej nazwę pod jaką będzie dostępna aplikacja. Może być to np. platformaCRM (lub platforma+nazwafirmy). Należy wskazać folder do którego jest wypakowana aplikacja
  5. Założyć folder na tzw datastore (repozytorium plików oraz indeks wyszukiwania)
    1. Z serwera bieżącego przenieść zawartość na nowy serwer do folderu datastore
    2. Użytkownik na którym działa aplikacja powinien mieć pełny dostęp do tego folderu (również do zapisu i modyfikacji)
  6. Aplikacja w tym momencie będzie zwracała błąd

Instalacja baz danych

  1. System używa dwóch baz danych.
    1. Baza konfiguracji
    2. Baza aplikacji
  2. Należy wykonać backup obu baz danych. Baza konfiguracji ma zazwyczaj nazwę CRM0000_CONFIG. Nazwa bazy aplikacji zazwyczaj zawiera w nazwie tekst „CRM0100” lub „PLATFORMA”.
  3. Należy założyć na tych bazach danych użytkowników z uprawnieniem db_owner albo wykorzystać już istniejących
  4. W bazie konfiguracji znajdują się ustawienia dostępu do aplikacji dla każdej nazwy pod którą aplikacja jest dostępna. Jeśli zmieniła się nazwa bazy aplikacji lub nazwa użytkownika lub hasło należy zmienić konfigurację w tabeli [dbo].[tblConfig] w kolumnie [dsn]
  5. W kolumnie datastore skonfigurować ściężkę do folderu datastore
  6. W folderze gdzie jest aplikacja należy odnaleźć folder „Instance”. W pliku connectionStrings należy zmienić wpisy o kluczach „DSNconfig”, „Hangfireserver” tak aby wskazały na bazę konfiguracji po przeniesieniu

Podłączenie JASPER(4.7) do SQL Server

  1. Wkleić plik (sterownik) sqljdbc4.JAR do folderu

<jasper-report-server-install-directory>\apache-tomcat\lib

  1. W pliku <jasper-report-server-install-directory>\apache-tomcat/webapps/jasperserver/WEB-INF/classes/esapi/security-config.properties należy wyłączyć walidację aby można było używać wywołań procedur

LINE 10. security.validation.sql.on=true należy zmienić na security.validation.sql.on=false

  1. Zaimportować raporty przez CMD
    1. najlepiej przejść do folderu "\buildomatic" w katalogu instalacyjnym jaspera cd <jasper-report-server-install-directory>\buildomatic
    2. utwórz backup szablonów z poprzedniej wersji
      skrypt:
      js-export --output-zip C:\Users\m.kotynia\Desktop\jas2014\repo.zip --everything

"C:\Users\m.kotynia\Desktop\jas2014\repo.zip" -->> scieżka do pliku gdzie zapisze się paczka

    1. import raportów na nowym serwerze
      skrypt:
      js-import --input-zip
      C:\Users\Administrator\Desktop\instalki\jasper\repo20140325.zip –update

"C:\Users\krzysztof.czupryniak\Desktop\kc\repo.zip" -->> scieżka do pliku z backup'em

Ważne !!! Backup utworzy źródło danych należy w nim ustawić IP serwera/nazwę bazy obecnego systemu
SQL SEVER co należy sprawdzić jeżeli połączenie nie działa
port 1433 (lub inny) dla połączenia sql musi być odblokowany na Firewall
protkół TCP/IP musi być uruchomiony (SQL server configuration manager)

  1. Aktualizacja raportów
    mając gotowy backup na docelowym serwerze poprzez CMD przechodzimy do folderu
    <jasper-report-server-install-directory>\buildomatic
    uruchamiamy osobno każdą linie skryptu
    a) tworzy kopie aktualnej konfiguracji połączenia do bazy
    js-export --uris /DataSource/PLATFORMA_SQLSERV --output-dir datasource
    b) wgrywa backup raportów na serwer (także źródło danych jest zastępowane)
    js-import --input-zip C:\Users\krzysztof.czupryniak\Desktop\kc\jreport.zip –update
    c) przywraca źródło danych sprzed backup'u
    js-import --input-dir datasource –update
    Ważne !!! sprawdzić źródło danych czy IP nazwa bazy jest poprawna

Instalacja aplikacji na czytniki

  1. Pobranie dostarczonej paczki z bieżącą wersją aplikacji lub spakowanie zawartości folderu aplikacji z bieżącego serwera
  2. W wybranym folderze rozpakować paczkę (folder nie powinien wcześniej zawierać innych plików)
  3. Uruchomić Manager IIS
  4. W wybranej witrynie (może być Default Web Site) dodajemy nową aplikację i definujemy jej nazwę pod jaką będzie dostępna aplikacja. Sugerujemy nazwę barcode ale może być inna. Należy wskazać folder do którego jest wypakowana aplikacja
  5. Ważna jest aktualizacja pliku konfiguracyjnego
    1. w sekcji „appSettings” dla klucza platformaUrl należy wstawić adres url strony głównej aplikacji plaftormaCRM
    2. w sekcji „connectionStrings” musimy zaktualizować połączenia do bazy danych (o ile również została przeniesiona na nowy serwer). Połączenie o nazwie „Main” musi wskazywać na bazę danych aplikacji natomiast połączenie o nazwie „Config” musi wskazywać na bazę konfiguracji.

Konfiguracja puli aplikacji (dla wersji IIS 7.5)

  1. Uruchom menadżera internetowych usług informacyjnych (IIS).

  1. W kolumnie ‘Połączenia’, rozwiń listę dla wybranego połączenia.

  1. Wybierz pozycję ‘Pule aplikacji’. Po prawej stronie okna, powinny zostać wyświetlone dostępne pule apliacji.

  1. Z dostępnej listy, prawym przyciskiem myszy wybierz pulę aplikacji, z którą skojarzona jest Twoja aplikacja (domyślnie DefaultAppPool). Następnie z menu kontekstowego, zatwierdź pozycję ‘Ustawienia zaawansowane...’.

  1. Odszukaj na liście właściwości, pozycję ‘Tożsamość’ (patrz grupa rozwijana ‘Model procesu’).

  1. Wybierz edycję wskazanej pozycji ‘Tożsamość’ (patrz ).

  1. Wybierz pozycję ‘Konto niestandardowe’, a następnie przycisk ‘Ustaw’. W ustawieniach poświadczeń, wpisz odpowiednią nazwę oraz hasło dla użytkownika w domenie.

  1. Zatwierdź zmiany zamykając otwarte okna poprzez przyciski ‘OK’.

THE END