Instalator aplikacji Comarch sPrint API jest dostępny do pobrania na Indywidualnych Stronach Partnerów oraz Indywidualnych Stronach Klientów.

Po uruchomieniu pliku instalacyjnego wyświetli się okno wyboru języka. Wybierz odpowiednią opcję i kliknij **Dalej**.

W kolejnym kroku wskaż ścieżkę instalacji Comarch sPrint API. Możesz ją zmienić za pomocą przycisku **Przeglądaj…**. Po ustawieniu docelowego folderu kliknij **Dalej**.

Następnie skonfiguruj sposób komunikacji Comarch sPrint API z Menedżerem Kluczy.

Następnie skonfiguruj sposób komunikacji Comarch sPrint API z Menedżerem Kluczy.

Do wyboru są dwie opcje:

• Będę wysyłał klucz w zadaniach druku – wybierz tę opcję, jeśli instalujesz komponenty na tym samym serwerze. Nie wymaga ona stałego połączenia z Menedżerem Kluczy; klucz będzie przesyłany w odpowiednim formacie bezpośrednio w każdym żądaniu (request).
• Skonfiguruj połączenie z menedżerem kluczy – wybierz tę opcję, aby połączyć się z Menedżerem Kluczy. Dane połączenia zostaną zapisane w plikach konfiguracyjnych narzędzia.

Po zaznaczeniu drugiej opcji system poprosi o podanie numeru klucza, adresu serwera, portu (opcjonalnie) oraz typu uwierzytelniania.

• Klucz – numer Twojego klucza licencjonowania.
• Serwer – adres IP lub nazwa sieciowa serwera, na którym działa Menedżer Kluczy.
• Port (opcjonalnie) – port usługi Menedżera Kluczy (domyślnie 5150). W przypadku wyboru trybu uwierzytelniania WebApi zalecamy wprowadzenie portu.
• Typ uwierzytelniania – do wyboru są trzy metody autoryzacji połączenia:
  • WebApi

W przypadku tej opcji komunikacja odbywa się domyślnie na porcie 5150. Upewnij się, że ruch na tym porcie jest odblokowany pomiędzy serwerami oraz że nazwa serwera zostanie poprawnie rozpoznana (jeśli wpisujesz nazwę zamiast IP, zweryfikuj jej poprawność w pliku `hosts` , DNS lub cliconfig w katalogu system32).

• • Sql

Wybierz tę opcję, jeśli uwierzytelnianie odbywa się na bazie SQL. Wymagane jest podanie danych logowania użytkownika, który posiada uprawnienia na serwerze z Menedżerem Kluczy:

login – login użytkownika Sql

hasło – hasło użytkownika Sql

• • SqlIntegratedSecurity

Opcja ta wykorzystuje poświadczenia systemu Windows. Do serwera bazy danych SQL (gdzie zainstalowany jest Menedżer Kluczy) zostaną przekazane dane aktualnie zalogowanego użytkownika domeny.

Po zakończeniu konfiguracji kliknij przycisk **Dalej**.

Kolejny etap to konfiguracja połączenia z bazą PostgreSQL o nazwie `hangfire_sprint`. Baza ta odpowiada za obsługę mechanizmu Hangfire (rejestrację zleceń wydruków, asynchroniczną kolejkę zadań) oraz stabilne utrzymanie procesów Comarch sPrint API.

W oknie konfiguracji wyświetli się komunikat o kompatybilności wersji bazy danych (zalecana wersja to PostgreSQL 18 lub wyższa):

• Jeśli posiadasz odpowiednią wersję

system poinformuje o zgodności komponentów.

• W przypadku posiadania starszej wersji zostaniemy poinformowani o możliwości instalacji kompatybilnej wersji

Aby potwierdzić należy zaznaczyć pole wyboru  **Zainstaluj PostgreSQL 18** (rekomendowane)

Dla tych dwóch opcji sekcji parametrów połączenia uzupełnij pole **Connection string** w jednym z poniższych formatów:

Host=localhost;Port=5432;Database=hangfire_sprint;Username=Użytkownik;Password=Hasło

użyj tego formatu, jeśli baza `hangfire_sprint` została utworzona ręcznie przed instalacją.

Host=localhost;Port=5432;

użyj tego formatu, jeśli chcesz, aby instalator automatycznie utworzył bazę `hangfire_sprint`.

W tym przypadku wymagane jest wpisanie loginu i hasła administratora serwera PostgreSQL zgodnie z poniższym komunikatem:

• W przypadku braku zainstalowanego serwera Postgresql

W tym przypadku musimy zaznaczyć **Zainstaluj PostgreSQL 18**

Dodatkowo użytkownik musi wpisać port instancji PostgreSQL oraz hasło administatora dla użytkownika Postgres

Po uzupełnieniu danych kliknij **Dalej**.

W kolejnym oknie wskaż port, na którym będzie działać usługa Comarch sPrint API (domyślny port to 5000).

Zaznaczenie opcji **Uruchom serwis po instalacji** spowoduje automatyczne włączenie usługi natychmiast po zakończeniu procesu instalacji. Jeśli pozostawisz to pole puste, usługę trzeba będzie uruchomić ręcznie z poziomu menedżera usług systemu Windows. Po ustawieniu parametrów kliknij **Dalej**.

W oknie podsumowania zweryfikuj poprawność wszystkich wprowadzonych danych. Jeśli parametry są prawidłowe, kliknij przycisk **Instaluj**, aby rozpocząć proces instalacji.

Po zakończeniu instalacji wyświetli się komunikat potwierdzający pomyślne wdrożenie systemu. Kliknij **Zakończ**, aby zamknąć kreator instalacji.