Instrukcja opisuje wymagania oraz sposób instalacji serwera systemu Kofios. Instrukcja przeznaczona jest dla działów IT które chcą samodzielnie przeprowadzić proces instalacji serwera Kofios oraz migracji danych z KOFIOS Cloud na własny serwer.

Przypominamy, że dla naszych Klientów posiadających aktywne usługi utrzymania systemu oferujemy usługę migracji danych. Zależnie od posiadanego pakietu licencyjnej jest ona rozliczana w stawce preferencyjne (pakiety Silver lub Gold) lub darmowa (pakiet Platinum)

Instrukcja zakłada, że wykonywana jest przez osobę posiadającą wiedzę z zakresu administracji systemem Windows Server oraz serwerem Sql Server.

Wymagania

Oprogramowanie

1. Windows Server 2019 lub nowszy, np. Essential Edition
2. Wersja językowa polska lub angielska
3. Zalecamy instalację standalone, nie jako kontroler domeny
4. Powyżej 50 użytkowników systemu KOFIOS, Sql Server Standard Edition

Sprzęt

1. Procesor min. 4 rdzenie 3 GHZ
2. Pamięć RAM - minimum 16GB, zalecana 32GB
3. Dysk SSD system 100GB, pozostała ilość zależna od ilości skanów, zalecamy 400GB-1TB w RAID10
4. Karta sieciowa 1Gb/s
5. Łącze internetowe minimum 20/10 Mb/s

Dostępność do serwera

W celu poprawnego działania systemu Kofios poza siecią lokalną w której jest system Kofios, a także poprawnego działania aplikacji mobilnych, bramki sms, czytników RCP wymagane jest udostępnienie następujących portów TCP/IP serwera:

• 443 - wymagane, dozwolone mapowanie na wyższy port np. 10443, 
• 80 - opcjonalnie, dozwolone mapowanie na wyższy port np. 10080
• powiązanie publicznego adresu IP serwera z dowolną nazwą DNS, 
• w przypadku aktywnych usług utrzymania systemu KOFIOS, zalecana nazwa to nazwaklienta-serwer.kofios.pl
  • firma Kofio włączy ww. obsługę nazwy DNS dla Klientów posiadających aktywne usługi utrzymania

W celu świadczenia usług utrzymania oraz aktualizacji wymagane jest:

• zdalny dostęp RDP, może być ograniczony do wybranych adresów IP, może wymagać połączenia VPN

Instalacja wymaganych składników Windows

W systemie Windows Server należy zainstalować Internet Information Server zgodnie z poniższymi opcjami:

Nazwa DNS serwera aplikacyjnego KOFIOS

1. Usługi serwera aplikacyjnego powinny być dostępne poprzez przyjazną nazwę DNS, np. nazwafirmy-server.kofios.pl
2. Jeśli nazwa ma być poddomeną w domenie kofios.pl to należy takie zapotrzebowanie wysłać na adres pomoc@kofios.pl 
3. Nazwa poddomeny w ramach domeny kofios.pl musi zawierać dodatkowy człon w postaci słowa serwer lub server.
4. Klient może użyć dowolnej poddomeny w swojej domenie internetowej, np. kofios.firmaxyz.pl (jeśli rzecz jasna jest posiadaczem domeny fimaxyz.pl)

Instalacja serwera aplikacyjnego KOFIOS

1. W ramach usług IIS należy dodać nową witrynę nazywając ja zgodnie z przyjętą nazwą DNS serwera wraz z utworzeniem folderu wewnątrz inetpub o tej samej nazwie, np. c:\inetpub\nazwaklienta-server.kofios.pl
2. Należy włączyć uprawnienia modyfikacji do nowo założonego folderu dla użytkowników IIS_IUSRS
3. Należy zainstalować lub utworzyć certyfikat SSL dla nowo dodanej witryny, np. korzystając z dostawcy Let's Encrypt oraz narzędzia wacs.exe
4. W przypadku klientów objętych aktywnymi usługami utrzymania oraz poddomeny w ramach domeny kofios.pl firma Kofio może przeprowadzić proces tworzenia i instalacji certyfikatu SSL
5. Wgranie do folderu nowej witryny plików udostępnionych przez firmę KOFIO
6. Sprawdzenie powiązań witryny, wpis dla portu 443 wymagany, wpis dla portu 80 opcjonalny
   
7. Ustawienie trybu uruchamiania puli aplikacyjnej na wartość AlwaysRunning
   
8. Sprawdzenie poprawności instalacji, poprzez uruchomienie w przeglądarce adresu https://nazwadnsserwera, np. https://nazwaklienta-server.kofios.pl:10443

Instalacja serwera SQL Server 2019 lub 2022

W ramach nowo przygotowywanego serwera Kofios należy zainstalować silnik bazy danych Microsoft Sql Server 2019 lub 2022. Może być użyta wersja Express Edition. Wymagane parametry instalacji instancji silnika SQL Server:

1. Wymagane składniki instalacji:
   1. 
   2. 
2. Instancja nazwana, np. SQLKOFIOS lub SQLA
   
3. Strona kodowa serwera Polish_CI_AS
   
4. Logowanie mieszane z ustawionym hasłem dla konta sa
   
   
5. 
6. W ramach nowo zainstalowanej instancji SQL Server przywracamy bazę danych, której backup dostarczyła firma Kofio. 
7. Silnik bazy danych może być dostępny tylko z poziomu localhost
8. Opcjonalnie: dodajemy nowy login który jest właścicielem bazy odtworzonej z backupu

Ustawienie parametrów połączenia do bazy danych

Po poprawnej instalacji serwera aplikacyjnego oraz silnika bazy danych należy w serwera aplikacyjnych Kofios ustawić parametry dostępu do bazy danych. W tym celu edytujemy plik w pod folderze serwera aplikacyjnego App_Data\db..cnf

W pliku znajduje się pojedyncza linia o składni:

KFSDB;sql_loginname;sql_password;1instance_name;databasename;PROD;

gdzie:

KFSDB - stała, nie zmieniamy

sql_loginname - nazwa logowania dodana w procesie instalacji bazdy danych lub konto sa

sql_password - hasło powiązane z sql_loginname

instance_name - adres instancji wraz z nazwą instancji, może być w notacji .\nazwainstancji, np. .\SQLEXPRESS

databasename - nazwa odtworzonej bazy danych systemu Kofios, np. kfs_firmaxyz

PROD - opcjonalny opis ciągu połączenia