platformaCRM
Instrukcja instalacji systemu
Wersja 1 2013-11-19 Marta Pieszyńska
Spis treści
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
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)
- Uruchomić Managment Studio
- 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 REM MOZNA TAK DLA WSZYSTKICH netsh firewall add portopening tcp 49172 "SQL_CRM" |
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.: 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 |
Krok 1. (Instalacja IIS Web server)
- Add or Remove program
- Turn Windows Feature
- Web Server (IIS) powinien byc zaznaczony jesli nei nalezy zaznaczyc
Instalacja aplikacji platformaCRM
- Pobranie dostarczonej paczki z bieżącą wersją aplikacji lub spakowanie zawartości folderu aplikacji z bieżącego serwera
- W wybranym folderze rozpakować paczkę (folder nie powinien wcześniej zawierać innych plików) (ewentualnie może zawierać folder datastore)
- Uruchomić Manager IIS
- 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
- Założyć folder na tzw datastore (repozytorium plików oraz indeks wyszukiwania)
- Z serwera bieżącego przenieść zawartość na nowy serwer do folderu datastore
- Użytkownik na którym działa aplikacja powinien mieć pełny dostęp do tego folderu (również do zapisu i modyfikacji)
- Aplikacja w tym momencie będzie zwracała błąd
Instalacja baz danych
- System używa dwóch baz danych.
- Baza konfiguracji
- Baza aplikacji
- 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”.
- Należy założyć na tych bazach danych użytkowników z uprawnieniem db_owner albo wykorzystać już istniejących
- 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]
- W kolumnie datastore skonfigurować ściężkę do folderu datastore
- 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
- Wkleić plik (sterownik) sqljdbc4.JAR do folderu
<jasper-report-server-install-directory>\apache-tomcat\lib
- 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
- Zaimportować raporty przez CMD
- najlepiej przejść do folderu "\buildomatic" w katalogu instalacyjnym jaspera cd <jasper-report-server-install-directory>\buildomatic
- 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
- import raportów na nowym serwerze
skrypt:
js-import --input-zip
C:\Users\Administrator\Desktop\instalki\jasper\repo20140325.zip –update
- import raportów na nowym serwerze
"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)
- 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
- Pobranie dostarczonej paczki z bieżącą wersją aplikacji lub spakowanie zawartości folderu aplikacji z bieżącego serwera
- W wybranym folderze rozpakować paczkę (folder nie powinien wcześniej zawierać innych plików)
- Uruchomić Manager IIS
- 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
- Ważna jest aktualizacja pliku konfiguracyjnego
- w sekcji „appSettings” dla klucza platformaUrl należy wstawić adres url strony głównej aplikacji plaftormaCRM
- 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)
- Uruchom menadżera internetowych usług informacyjnych (IIS).
- W kolumnie ‘Połączenia’, rozwiń listę dla wybranego połączenia.
- Wybierz pozycję ‘Pule aplikacji’. Po prawej stronie okna, powinny zostać wyświetlone dostępne pule apliacji.
- 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...’.
- Odszukaj na liście właściwości, pozycję ‘Tożsamość’ (patrz grupa rozwijana ‘Model procesu’).
- Wybierz edycję wskazanej pozycji ‘Tożsamość’ (patrz
).
- Wybierz pozycję ‘Konto niestandardowe’, a następnie przycisk ‘Ustaw’. W ustawieniach poświadczeń, wpisz odpowiednią nazwę oraz hasło dla użytkownika w domenie.
- Zatwierdź zmiany zamykając otwarte okna poprzez przyciski ‘OK’.
THE END