Instalacja

Poniższa instrukcja przygotowana jest w oparciu o instalację aplikację w środowisku Windows Server 2019. Pozostałe wersje systemów serwerowych instaluj analogicznie do niniejszego przykładu.

1.1.Pobieranie najnowszej wersji instalatora

Pobierz najnowszą wersję instalatora z adresu https://public.light-erp.pl/_install/Symfonia%20e-Pracownik/current/SetupSymfoniaERPePracownik.exe i zapisz w znanej sobie lokalizacji.
Kliknij prawym klawiszem i uruchom jako administrator plik instalacyjny „SetupSageePracownik.exe”.

Po wyświetleniu komunikatu kliknij „Więcej informacji” i „Uruchom mimo to”.

Zezwól na instalację aplikacji nieznanego wydawcy wybierając „Tak”.

Podążaj za kreatorem klikając „Dalej” i zaczekaj, aż instalator zakończy pracę.

- Nie zmieniaj katalogu docelowego podczas instalacji. Jeżeli wybierzesz inny katalog niż domyślny, pamiętaj aby zmieniać go również w każdym skrypcie instalacyjnym i aktualizacyjnym zanim go uruchomisz.

2. Instalacja środowiska

2.1. Internet Information Services (IIS)

Zainstaluj komponenty serwera internetowych usług Informacyjnych (IIS).

Kliknij przycisk Start.
Wyszukaj Menedżer serwera i kliknij „Dodaj role i funkcje”.

Klikaj przycisk „Dalej”, aż zatrzymasz się na sekcji „Role serwera”.

Wybierz „Web Server (IIS)” i w otwartym oknie kliknij „Dodaj funkcję”.

- Usługi SageePracownik_API i SageePracownik_Front, wymagają użycia IIS w wersji 8.0.

Kliknij przycisk „Dalej”.

Klikaj dalej, aż dojdziesz do sekcji „Usługi ról”.
Postępuj zgodnie z załączonymi ilustracjami, aby wszystkie opcje zostały zaznaczone jak poniżej. Kiedy system poprosi o doinstalowanie kolejnych składników, zgadzaj się potwierdzając przyciskiem „Dodaj funkcję”.

Instalacja roli i funkcji serwera sieci Web (IIS). Usługi SageePracownik_API i SageePracownik_Front, wymagają użycia IIS w wersji 8.0.

- Menadżer sesji -> Dodaj role i funkcje -> Role serwera:

Klikaj dalej aż dojdziesz do sekcji „Usługi ról”.
Postępuj zgodnie z załączonymi ilustracjami, aby wszystkie opcje zostały zaznaczone jak poniżej. Kiedy system poprosi o doinstalowanie kolejnych składników, zgadzaj się potwierdzając przyciskiem „Dodaj funkcję”.

Przewiń okno usług ról na sam dół i zaznacz „.NET Extensibility 4.7” w grupie „Application Development”.

Zaznacz „Application Initialization” i „ASP.NET 4.7”.

Zaznacz „WebSocket Protocol”, kliknij przycisk „Dalej”, a następnie „Dalej” i „Zainstaluj”.

Zaczekaj, aż proces dobiegnie końca i kliknij przycisk „Zamknij”.

2.2. .Net Core Hosting

Uruchom plik instalacyjny „dotnet-hosting-2.2.8-win.exe” z katalogu „C:\SageePracownik\Install” lub pobierz go z adresu https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-2.2.8-windows-hosting-bundle-installer.
Kliknij przycisk „Install” i zamknij okno przyciskiem „Close” po zakończeniu procesu instalacji.

- Po zakończonej instalacji należy uruchomić ponownie system operacyjny.

2.3. Sage e-Pracownik

Wykonaj skrypty instalacyjne i aktualizacyjne systemu Sage e-Pracownik.

Kliknij prawym klawiszem i uruchom jako administrator, skrót „Instalacja Sage ePracownik IIS”.
Zaczekaj, aż zniknie okno konsoli systemu (czarne okno).

Kliknij prawym klawiszem i uruchom jako administrator, skrót „Aktualizacja Sage ePracownik IIS (KIP2020.2)”.
Zaczekaj. aż zniknie okno konsoli systemu (czarne okno).

3. Konfiguracja

3.1. Konfiguracja Internet Information Services (IIS)

Kliknij przycisk „Start” Systemu Windows i zacznij pisać „iis”.
Uruchom Menedżera internetowych usług informacyjnych (IIS).

3.2. Konfiguracja aplikacji „SageeKIP_OUT”

Kliknij w „Pule aplikacji” i po kliknięciu prawym klawiszem na puli „SageeKIP_OUT”.
Wybierz „Ustawienia zaawansowane”.

Ustaw opcje puli aplikacji „SageeKIP_OUT” zgodnie z załączonym obrazkiem:
- Tryb uruchamiania: AlwaysRunning
- Włącz aplikacje 32-bitowe: True
- Limit czasu bezczynności: 0
- Limit czasu uruchamiania: 1800
- Tożsamość: NetworkService
- Stały przedział czasu: 0

3.3. Konfiguracja aplikacji „SageePracownik_API”

Kliknij w „Pule aplikacji” i po kliknięciu prawym klawiszem na puli „SageePracownik_API”.
Wybierz „Ustawienia zaawansowane”.

Analogicznie do poprzedniego przykładu ustaw opcje puli „SageePracownik_API” zgodnie z załączonym obrazkiem:
- Tryb uruchamiania: AlwaysRunning
- Limit czasu bezczynności: 0
- Limit czasu uruchamiania: 1800
- Stały przedział czasu: 0

3.4. Konfiguracja aplikacji „SageePracownik_Front” (WEB)

Zaktualizuj w pliku C:\SageePracownik\SageePracownik_Front\assets\app-config.json

adresy rozpoznawalne z www (sieć internet z zewnątrz serwera aplikacji)
włączenie/wyłączenie możliwości logowania za pomocą kont społecznościowych (social_button).
- aby włączyć możliwość logowania należy zmienić "false" na "true"
włączenie/wyłączenie możliwości logowania za pomocą kont domeny Windows (windowsAuthentication).
- aby włączyć możliwość logowania za pomocą kont Active Directory (AD) należy zmienić "false" na "true"

{

"apiUrl": "http://localhost:9001/api",

"apiAdUrl": "https://localhost:9002/api",

"hub": "http://localhost:9001",

"social_button_google": false,

"social_button_facebook": false,

"windowsAuthentication": false

}

- Jeżeli włączysz logowanie za pomocą kont domenowych "windowsAuthentication":
  - adres "apiAdUrl" koniecznie musi być uruchomione na protokole "HTTPS"
- W przeciwnym razie przeglądarka nie będzie mogła pobrać danych o zalogowanym użytkowniku Windows i dane trzeba będzie wprowadzać ręcznie (domena\użytkownik i hasło domeny).

3.5. Konfiguracja startowa aplikacji Sage e-Pracownik

Uruchom program „Notatnik” jako administrator i otwórz plik (zmień widoczność na "Wszystkie pliki" aby zobaczyć pliki z rozszerzeniem ".json") „appsettings.json” z katalogu „C:\SageePracownik\SageePracownik_API”.

Wprowadź zmiany zgodnie z poniższym przykładem, a na końcu z menu „Plik” kliknij „Zapisz”:

{

"Logging": {

"LogLevel": {

"Default": "Warning"

}

"AllowedHosts": "*",

"JwtIssuerOptions": {

"Issuer": "ePracownik",

"Audience": "http://localhost:5000/"

"BackgroundTaskOptions": {

"CallbackUrl": "http://localhost:9000/",

"EPracownikApiPath": "http://localhost:9001/",

"Synchronization": 720,

"EmailService": 1,

"ErpDataUpdater": 1

"ConnectionStrings": {

"Default": "Server=sqlserver\\express;Initial Catalog=Sage_ePracownik;Persist Security Info=False;User ID=sql_username;Password=sql_password;MultipleActiveResultSets=True;"

"SymfoniaApiSettings": {

"path": "http://localhost:5690"

}

"CookieOptions": {

"Secure": false,

"DisableCookieTokenAfterLogout": false,

"Expires": 14400

}

Zaktualizuj w pliku C:\SageePracownik\SageePracownik_API\appsettings.json

adresy (jeśli wymagane),
parametry cyklicznej synchronizacji z Sage Kadry i Płace:
- CallbackUrl": "http://localhost:9000/"
- EPracownikApiPath": "http://localhost:9001/ "
- Synchronization <odstęp czasu uruchamiania pełnej synchronizacji (w minutach)>
- EmailService <odstęp czasu uruchamiania wysyłki powiadomień email (w minutach)>
- ErpDataUpdater <odstęp czasu uruchamiania wysyłki zmienionych danych do Sage KiP (w minutach)>
parametry połączenia do MS SQL w sekcji ConnectionStrings.
- Server=<host>\\<instance>
- Initial Catalog=<Sage_ePracownik>
- User ID=<sql_username>
- Password=<sql_password>
CookieOptions (nie jest wymagana!! Czyli jak nie wpiszesz tej sekcje to nic się nie stanie i będzie działać jak wcześniej).
- Secure: false <(boolean) domyślna wartość ustawiona na false. Jeżeli ustawisz na true to pro-tokół HTTP zostanie odrzucony przez przeglądarkę.>
- HttpOnly: true <(boolean) domyślna wartość ustawiona na true. Raczej nie będziemy zmieniać tej konfiguracji nigdy, ale jeżeli ktoś zachce to taka możliwość jest. (Może się przydać tylko wtedy, gdy API i FRONT stoją pod różnymi domenami, bo wtedy nie zadziała.
- Expires: 60 <(integer, wartość w minutach) domyślna wartość ustawiona na 14400 minut (10 dni). Czyli oznacza to, że jak ustawimy wartość na 1, to po zalogowaniu ciasteczko będzie ważne 1 minutę, i po jednej minucie straci swoją ważność (czyli przy pierwszym jakimkolwiek kliknięciu użytkownik zostanie wylogowany). P.S. Proszę pamiętać, że jak ustawimy za krótki czas, to też wpływa na tokeny które są generowane podczas akceptacji wniosku z maila (czyli jak mamy 1 minutę w ustawieniach, to z maila token też będzie ważny tylko jedną minutę.
- SameSiteMode: 2 <(integer) domyślna wartość ustawiona na 2 (0 - None, 1 - Lax, 2 - Strict). (Też może się przydać gdy ustawiamy różne domeny dla API i Frontu, ale domyślne tego nie zmieniamy).
- DisableCookieTokenAfterLogout: false <(boolean) domyślna wartość ustawiona na false. Do-da token użytkownika do czarnej listy po wylogowaniu. Dzięki temu jak nawet ktoś ukradnie nasz token, to nie da się więcej z niego korzystać. Nieznacznie wpływa na szybkość wszyst-kich żądań do API.

Zmieniony plik konfiguracyjny, może wyglądać jak na przykładzie poniżej (przykład dla dostępu tylko z serwera bez udostępnienia w sieci - np. "praca terminalowa"):

3.6. Konfiguracja HR Framework

Skonfiguruj parametry dostępu do Sage HRFramework (zgodnie z zaleceniami Sage).

Kliknij przycisk „Start” Systemu Windows i wpisz „C:\Windows\SysWOW64\comexp.msc” lub:
- Uruchom program Windows Power Shell.
- Wpisz polecenie zgodnie z poniższym obrazkiem i naciśnij „Enter”:

Odszukaj element KDF.AppIni.10.5 i kliknij prawym klawiszem myszy „Właściwości”.

Przejdź do zakładki „Zabezpieczenia” i w każdej sekcji uprawnień dodaj użytkownika Usługa Sieciowa (NetworkService)
Dodaj pełne uprawnienia zaznaczając wszystkie kratki w kolumnie "Zezwalaj".

Przejdź do zakładki „Tożsamość”.
Zaznacz „Ten użytkownik”.
Kliknij „Przeglądaj”, wpisz „epracownik” i naciśnij „OK”.
Wprowadź hasło użytkownika i naciśnij „OK”.

- Po zmianach w plikach konfiguracyjnych zawsze wykonaj restart serwera IIS lub jeżeli nie jest to możliwe, wykonaj restart tylko witryn aplikacji Sage e-Pracownik na serwerze IIS.

Na serwerze gdzie zainstalowana jest rola IIS z witryną "SageeKIP_OUT" przynajmniej raz uruchom Sage Kadry i Płace i zaloguj się kontem użytkownika, który używany będzie do synchronizacji baz.

Po zakończeniu konfiguracji wykonaj restart API ERP.

- Na serwerze, na którym będzie zainstalowane API ERP muszą być podłączone do Sage KiP wszystkie firmy, które będą obsługiwane w Sage e-Pracowniku.

4. Pierwsze uruchomienie

4.1. Pierwsze logowanie

Otwórz przeglądarkę internetową.
Wprowadź adres http://localhost:9000 lub adres docelowy wprowadzony podczas konfiguracji.
Zaloguj się do systemu dowolnym użytkownikiem aby system wzbudził aplikację.

- Przy pierwszym logowaniu musisz poczekać, aż usługa się uruchomi.
- Kiedy otrzymasz komunikat nie odświeżaj strony, a system przekieruje cię do okna logowania, jak tylko usługa zostanie w pełni uruchomiona.

Zaczekaj aż system utworzy bazę danych i ponownie pokaże się okno logowania.
Zaloguj się do systemu użytkownikiem "Admin", podając hasło "demo” i ustal nowe hasło.

4.2. Dodaj firmę

Przejdź do zakładki "Konfiguracja" w pasku nawigacyjnym bieżącej instrukcji.

5. Aktualizacja

5.1. Uaktualnienie Sage e-Pracownik

Pobierz najnowszą wersję instalatora z adresu: https://public.light-erp.pl/_install/Sage e-Pracownik
Uruchom instalator jako administrator i kliknij dalej.

Po wyświetleniu komunikatu kliknij „Więcej informacji” i „Uruchom mimo to”.
Zezwól na instalację aplikacji nieznanego wydawcy wybierając „Tak”.

Podążaj za kreatorem klikając „Dalej” .
Instalator podpowie ścieżkę zainstalowanej poprzedniej wersji Sage e-Pracownika. Jeżeli ścieka jest poprawna, kliknij dalej.
Poczekaj aż instalator zakończy kopiowanie pilików i kliknij przycisk zakończ.

Zatrzymaj serwer IIS lub jeżeli nie jest to możliwe, zatrzymaj tylko witryn aplikacji Sage e-Pracownik na serwerze IIS.

Odszukaj na pulpicie skrót do aktualizacji portalu zgodny z zainstalowaną wersję Sage KiP np:
- Aktualizacja Sage ePracownik IIS (KIP 2019.2)
- Aktualizacja Sage ePracownik IIS (KIP 2020)
- Aktualizacja Sage ePracownik IIS (KIP 2020.1)
- Aktualizacja Sage ePracownik IIS (KIP 2020.2)
Skrypt instalatora możesz również odnaleźć w lokalizacji "C:\SageePracownik\Install\".
Kliknij prawym klawiszem i uruchom jako administrator, skrót „Aktualizacja Sage ePracownik IIS (KIP2020.2)”, i zaczekaj aż z niknie okno konsoli systemu.

- Jeżeli podczas instalacji zmieniłeś katalog docelowy na inny niż domyślny, pamiętaj aby zmieniać go również w skrypcie aktualizacyjnym,zanim go uruchomisz.

- Po zakończeniu operacji uaktualnienia, okno instalatora zostanie zamknięte, co oznacza, że Sage e-Pracownik został uaktualniony.

Po uaktualnieniu, witryny IIS uruchomią się ponownie.

Wzbudź uruchomienie aplikacji logują się do systemu.
- Możesz użyć dowolnego użytkownika i hasła.

Zaczekaj aż system uruchomi aplikację i ponownie pokaże się okno logowania

Zaloguj się do systemu.

- Pamiętaj aby zainstalowana wersja API ERP była zgodna z instalacją Sage Kadry i Płace.
- W zależności od wielkości bazy i ilości firm, uruchomienie wszystkich usług może trwać nawet do kilku minut.

Page updated

Report abuse