W tym artykule znajdziesz wszystko, co powinieneś wiedzieć o instalacji YetiForce CRM:

• niezbędne informacje
• instrukcja instalacji krok po kroku
• najczęściej pojawiające się błędy i problemy. 

Koniecznie zapoznaj się ze wszystkimi poniższymi informacjami  przed przystąpieniem do instalacji systemu.

Instalacja YetiForce CRM jest bardzo prosta. Odbywa się jak przy większości aplikacji webowych, za pomocą kreatora przez przeglądarkę.

Przed instalacją sprawdź czy twój serwer spełnia wymagania: Wymagania dla serwera WWW lub Jak zainstalować YetiForce na Debian 10

Osoba instalująca CRM powinna mieć przynajmniej podstawową wiedzę w zakresie serwerów WWW, baz danych oraz uprawnień na serwerze. 99% problemów instalacyjnych wynika z niewystarczającej wiedzy osób, które instalują aplikacje. Jeżeli nie jesteś pewien czy sobie poradzisz, poproś kogoś z odpowiednią wiedzą informatyczną. Cała operacja instalacji zajmie maksymalnie od 2 do 30 minut. Instalacja YetiForce jest podobna do instalacji takich aplikacji jak: WordPress, Joomla, Drupal. Różnice pomiędzy poszczególnymi narzędziami są niewielkie. Jeżeli poradziłeś sobie z instalacją systemu klasy CMS, to poradzisz sobie również z YetiForce CRM.

W pierwszej kolejności przygotuj pliki instalacyjne. Źródła skąd można pobrać pilki systemu znajdują się na: github.com/YetiForceCompany/YetiForceCRM

1. Pobierz najnowszą wersję systemu CRM.
   UWAGA - Zalecamy pobranie wersji oznaczonych jako "complete", na przykład: YetiForceCRM-6.2.0-complete.zip. Jeśli została pobrana inna wersja niż "complete", to przed instalacją systemu należy zainstalować biblioteki przy użyciu yarn'a i composer'a.
   Ważna jest kolejność - najpierw yarn, potem composer.
   Przykładowy skrypt instalacyjny możesz pobrać stąd.
2. Pobrany plik ZIP rozpakuj, np. za pomocą programu 7-Zip.
3. Katalog z systemem CRM, który otrzymasz po rozpakowaniu pliku ZIP, skopiuj na serwer WWW, np. za pomocą programu FileZilla, WinSCP.
4. Postępuj zgodnie z kreatorem, którego wywołasz z poziomu WWW, tam, gdzie skopiowałeś pliki YetiForce CRM.

Lub posłuż się konsolą bash:

Uruchom w oknie przeglądarki adres docelowy Twojego CRM-a. System powinien pokazać kreator instalacji. Jeśli system nie pokazuje kreaotra, to może oznaczać, że wystąpiły jakieś problemy. Wtedy spróbuj uruchomić adres: __SITE_URL__/install/Install.php np. https://gitdeveloper.yetiforce.com/install/Install.php

Na ekranie startowym, w kreatorze instalacji, dostępna jest możliwość konfiguracji języka instalacji (domyślnie język jest predefiniowany na podstawie języka przeglądarki) oraz wyboru trybu instalacji (nowa instalacja lub migracja z innego systemu).

My przejdziemy kroki nowej instalacji. Kliknij przycisk "Instaluj".

W drugim kroku, kreator wymaga zaakceptowania licencji. Licencja YetiForce jest bardzo podobna do licencji MIT. Jest otwarta i pozwala na dowolną modyfikację kodu z pozostawieniem informacji o pierwotnym autorze. Przeczytaj w pełni informacje o licencji, ponieważ z perspektywy firmy, dla której wdrażasz to oprogramowanie, jest istotne, na jakich warunkach jest ono wdrażane.

Zdecyduj, gdzie chcesz zainstalować system - możesz wybrać własny serwer albo dokonać zakupu naszego hostingu lub chmury. Po kliknięciu przycisku "Kup" będziesz miał możliwość dokonania płatności.

W czwartym kroku, widoczna jest aktualna konfiguracja serwera WWW oraz zalecenia, jakie stawia YetiForce CRM (czyli co trzeba zmienić i na jaką wartość). Należy pamiętać, że w zależności od wymagań, jakie się stawia aplikacji CRM, konfiguracja ta może ulec zmianom. Zmiany powinna uwzględnić we własnym zakresie firma wdrożeniowa.

Dla przykładu, jeżeli generujesz duże raporty, których czas generowania jest dłuższy niż parametr "max_execution_time", wtedy należy ten parametr ustawić tak, aby czas wykonywania skryptu był zawsze dłuższy niż czas generowania raportu. W przeciwnym wypadku taki raport może się nie wygenerować.

Dla pewności, poproś swojego administratora, aby zapoznał się z tymi wymaganiami dla serwerów WWW. Jeżeli nie będą spełnione wszystkie wymagane parametry i będziesz chciał przejść dalej, to aplikacja pokaże komunikat ostrzegawczy.

Świadomy ryzyka związanego z niepoprawną konfiguracją środowiska WWW, możesz przejść dalej, klikając przycisk "OK".

Na tym etapie musisz wypełnić podstawowe dane dostępowe do bazy danych i ustawić parametry wyjściowe dla systemu CRM. Na podstawie tych danych system utworzy bazę danych (o ile ta opcja została aktywowana), wgra strukturę bazy danych razem z podstawowymi danymi oraz utworzy podstawowe konto administratora, do którego będziesz mógł się zalogować po instalacji.

Jeżeli wprowadzisz nieprawidłowe dane dostępowe do bazy danych, pokaże się błąd.

W takim wypadku musisz cofnąć się do poprzedniego ekranu i prawidłowo wprowadzić dane dostępowe. Jeżeli wszystko zostanie uzupełnione prawidłowo, zobaczysz ekran podobny do tego, który jest w kroku następnym.

Wprowadzamy dane firmy, która będzie korzystała z CRM-a. Te dane będą potem używane do rejestracji systemu.

Zgodnie z zapisami licencji każdy system musi być zarejestrowany po okresie próbnym - 14 dni.

Jeżeli instalacja zostanie wykonana prawidłowo, zostaniesz automatycznie przeniesiony do systemu CRM.

W porównaniu do instalacji i migracji systemu, aktualizacja jest bardzo prosta i przyjemna. Każdy administrator YetiForce CRM powinien sobie z nią poradzić. Zanim jednak do niej przejdziemy, w pierwszej kolejności powinniśmy zadbać o dobrą kopię zapasową jak również uruchomić cały proces na środowisku testowym. 

Do najczęstszych błędów młodych administratorów można zaliczyć między innymi aktualizacje wykonywane bezpośrednio na produkcji.

Aktualizację systemu możemy podzielić na 3 rodzaje czynności, na które składają się odpowiednie, dość ważne procesy.

• Zrobienie pełnej kopii zapasowej całego systemu CRM (wszystkie pliki/foldery)
• Zrobienie kopii zapasowej bazy danych
• Wyłączenie cron-a - Wyłączenie cron-a można przeprowadzić w panelu administracyjnym odpowiednio dla każdego zadania (zalecane jest aby wyłączyć wszystkie zadania)
  Wyłączyć cron-a można również poprzez zmianę nazwy pliku cron.php
• Włączenie logów (https://yetiforce.com/pl/baza-wiedzy/dokumentacja/dokumentacja-programistyczna/item/debugowanie#quick_start)
• Utworzenie kopii systemu i testowa aktualizacja

• Przechodzimy do panelu administracyjnego, w menu wybieramy Logi/Serwer – aktualizacje.

W wybranym oknie mamy możliwość przeprowadzenia aktualizacji na dwa sposoby:

1. Instalacja manualna

W instalacji manualnej ważne jest, aby wcześniej pobrać odpowiednią paczkę dla danego systemu.

Paczkę aktualizacyjną można pobrać z kilku miejsc, jednakże zalecanym miejscem jest to: https://github.com/YetiForceCompany/UpdatePackages/tree/master/. Znajdują się tam paczki aktualizacyjne do wszystkich wersji. Należy wybrać tą paczkę, która odpowiada naszej wersji, a co ważniejsze aktualizacje można wykonywać tylko zachowując kolejność. Jeżeli masz wersje 1.1 a chciałbyś uaktualnić system do wersji 2.0 powinieneś pobrać następujące paczki aktualizacyjne: 

1. 1.1.0RC_to_1.2.0RC
2. 1.2.0RC_to_1.3.0RC
3. 1.3.0RC_to_1.4.0RC
4. 1.4.0RC_to_2.0.0

Co prawda są wbudowane mechanizmy, które nie pozwolą wgrać niepoprawnej paczki, ale można je oszukać. Choć "oszukiwanie" nie jest zalecane, to czas ma biznesowe uzasadnienie. Domyślnie paczki umożliwiają aktualizacje tylko z wersji stabilnych [np. 1.2.0, 1.4.0], jednakże wersje pośrednie [np. 1.2.54, 1.4.11] nie pozwolą na aktualizacje systemu. Do takiej sytuacji może dojść w dwóch przypadkach:

1. Pobrana została wersja systemu niestabilna [np. bezpośrednio z głównego folderu GitHub], ponieważ prawidłowo, powinniśmy pobrać system z tego miejsca: https://github.com/YetiForceCompany/YetiForceCRM/releases
2. Została wgrana paczka aktualizacyjna dla wersji pośredniej, można je pobrać np. z kanału developerskiego tutaj: https://github.com/YetiForceCompany/UpdatePackages/tree/developer/YetiForce%20CRM%201.x.x 

Niezależnie od przyczyny, należy pamiętać, że jeśli chcesz by aktualizacja była możliwa należy wykonać czynności takie jak:

1. Otworzyć ten plik https://github.com/YetiForceCompany/YetiForceCRM/blob/master/config/version.php tylko na swoim serwerze gdzie mamy CRM;
2. Następnie należy zmienić numer wersji na stabilny np. z wersji 1.4.55 na 1.4.0 [zawsze zmniejszamy wersje].

• Mając odpowiednio dobraną wersję paczki aktualizacyjnej możemy przejść do ręcznego sposobu jej wgrania, klikając w przycisk „Wgraj aktualizację”. 

• Wybieramy odpowiednią wersję i klikamy „Importuj”.

2. Instalacja panelu

• W tabeli „Dostępne pakiety aktualizacyjne” znajduje się lista pakietów, które system automatycznie wykrywa odpowiednio do posiadanej wersji.

• Mając włączony internet po kliknięciu w „Pobierz pakiet” nastąpi pobranie wybranego pakietu.
• Po ukończeniu pobierania pakietu możemy od razu przejść do instalacji klikając w przycisk „Zainstaluj pakiet”.

• Akceptacja licencji - jest to ostatni krok tak jak i w instalacji manualnej tak i w instalacji automatycznej. Jeżeli wszystko się zgadza pojawi się okno z informacją z jakiej wersji do jakiej aktualizujemy oraz listą istotnych zmian jakie wprowadza aktualizacja, a które mogą mieć wpływ na jej przebieg. Jeżeli jesteśmy gotowi i włączyliśmy logi, to akceptujemy licencję i uruchamiamy aktualizację wciskając przycisk "Tak".

• Prawidłowa instalacja zakończy się pokazaniem okna podsumowania lub przekierowaniem do pulpitu

III CZYNNOŚCI PO AKTUALIZACJI

1. Czynności sprawdzające prawidłowość wykonania aktualizacji

• W pierwszej kolejności sprawdzamy plik logów, czy przypadkiem nie zawiera błędów, czy też ostrzeżeń. Plik logów może zawierać bardzo dużo linii, zalecamy przeszukiwać go po słowach kluczowych np. error, warning itd.
• Zlecamy wyłącznie logów po kilkudniowym używaniu systemu, aby zweryfikować czy nie występują jakieś błędy https://yetiforce.com/pl/baza-wiedzy/dokumentacja/dokumentacja- programistyczna/item/debugowanie#warning  
• Aktualizacja języków występujących w systemie.
• Aktualizacja biblioteki lib_roundcube do wersji odpowiadającej danemu systemowi.
• W panelu administracyjnym Konfiguracja systemu/Moduły standardowe/Moduły - instalacja zaobserwujemy czy dana biblioteka wymaga aktualizacji o ile wcześniej była zainstalowana.

• Instalacja najnowszej wersji Servis Pack o ile istnieje dla danej wersji – Po zainstalowaniu aktualizacji w Panelu Administracyjnym – „Logi/Serwer – aktualizacja” możemy zobaczyć aktualnie dostępne pakiety SP. Jeżeli w widoku listy nie będzie dostępnych wersji to znaczy, że jest zainstalowana najnowsza wersja.

• Włączenie cron-a oraz sprawdzenie jego prawidłowego działania. W tym celu można wejść do panelu administracyjnego, aby zobaczyć czy zostały uruchomione zadania cron-a i czy zostały zakończone prawidłowo.

2. Testy prawdiłowego działania systemu:

• Następnie przeklikujemy system czy działają wszystkie widoki, [czy możemy edytować, modyfikować, usuwać rekordy]. Zmiany te, wprowadzamy przede wszystkim jako użytkownik nieuprzywilejowany. 
• Wykonujemy również niezbędne testy związane np. z testową wysyłką maili, generowaniem dokumentów PDF, edytowaniem ról, czy też zasad dostępu.
• Sprawdzamy komunikację z systemami zewnętrznymi np. integrującymi się poprzez API. 

Jak radzić sobie z problemami?

Przede wszystkim należy dokładnie przeanalizować logi, mamy tam rozwiązanie na 99% problemów. Oprócz logów aplikacji, mam na myśli również logi serwera, które również są niezbędnym źródłem wiedzy. Drugim krokiem może być opisanie problemu na GitHub, gdzie nasza społeczność jak również producent YetiForce pomaga bezpłatnie. Zanim jednak dodasz zgłoszenie tutaj https://github.com/YetiForceCompany/YetiForceCRM/issues należy przygotować niezbędne opisy, istotne logi, ważne zrzuty ekranu i dokładnie wyjaśnić na czym polega problem. Niepoprawnie dodany issue może tylko wydłużyć okres w jakim społeczność będzie wstanie Tobie pomóc. Przed dodaniem zgłoszenia zalecamy także sprawdzenie zakładki Discussions.

Możesz sięgnąć również po profesjonalne i płatne wsparcie bezpośrednio od producenta, odwiedź nasz Marketplace i zobacz naszą ofertę usług.

Jednym z elementów instalacji portalu jest konfiguracja systemu tak, aby portal był od razu gotowy do używania. Ten instruktaż pokazuje co, i w jakiej kolejności, skonfigurować.

Należy utworzyć nowy profil, który będzie określał do czego użytkownicy portalu mają mieć dostęp. Zarządzanie profilami znajduje się w "Konfiguracja systemu > Uprawnienia > Profile".

Utworzony wcześniej profil należy przydzielić do nowej roli. W tym celu należy przejść do "Konfiguracja systemu > Uprawnienia > Role" i utworzyć nową rolę z wybranym wcześniej profilem.

Kolejnym elementem do konfiguracji są użytkownicy. Należy dodać nowego użytkownika z wcześniej utworzoną rolą. Funkcja dodawania użytkownika znajduje się w panelu "Konfiguracja systemu > Uprawnienia > Użytkownicy". Użytkownik jest potrzebny do określenia uprawnień oraz staje się domyślnym właścicielem dla nowych rekordów.

Następnym krokiem jest dodanie aplikacji dla API "Konfiguracja systemu > Integracja > Web service - Aplikacje" o typie "Webservice Premium". Umożliwi to korzystanie z kontenera API "Webservice Premium". Pełna dokumentacja znajduje się pod adresem: https://doc.yetiforce.com/api

Nadanie uprawnień jest niezbędne aby moduły były widoczne. Bez tego moduł nie pojawi się w menu.

Kolejnym elementem do konfiguracji, bez którego portal nie będzie działał poprawnie, jest menu.

Panel konfiguracyjny menu znajduje się w "Konfiguracja systemu > Moduły standardowe > Menu - konfiguracja".

Dzięki utworzeniu odrębnego menu, które będzie przypisane jedynie dla portalu, ograniczamy widoczność dostępnych modułów.

Po dodaniu użytkowników API przypisanych do kontaktów, musimy dodać pola, dzięki któremu będziemy kontrolować dostęp do rekordów.

Bez tego pola nie będzie dostępu do rekordów w portalu. Z tego względu należy dodać pole o typie "Aplikacja Web service" dla danej aplikacji web service.

Dzięki temu rozwiązaniu możemy mieć kilka portali/aplikacji web service i oddzielnie, dla każdego z nich kontrolować, dostępność rekordów.

Dodawanie pól znajduje się w panelu "Konfiguracja systemu > Moduły standardowe > Moduły - Pola"

Zarządzanie udostępnianiem rekordów w portalu 

Panel daje możliwość zarządzania dostępnością oraz domyślną wartością pól dla portalu.

Umożliwia wyłączenie pól obowiązkowych, takich jak np. status, właściciel rekordu oraz pozwala narzucić wartości domyślne tylko dla portalu/API. (Oznacza to, że wszystkie rekordy które będą tworzone z portalu/API będą miały ustawioną tą wartość.)

Zarządzanie polami w portalu jest dostępne w panelu "Konfiguracja systemu > Moduły standardowe > Moduły - pola".

Pola słownikowe bazujące na rolach wymagają określenia jakie wartości mają być dostępne w portalu/API.

Bez tego użytkownik, tworząc/edytując rekord w portalu, nie będzie miał listy wyboru dla pól słownikowych opartych o role.

Panel konfiguracyjny znajduje się w "Konfiguracja systemu > Moduły standardowe > Pola - słowniki".

Ostatnim krokiem konfiguracji systemu jest dodanie użytkowników portalu. Można to zrobić w panelu "Konfiguracja systemu > Uprawnienia > Web service - Użytkownicy".

Hasło dla użytkowników można ustawić jedynie z poziomu CRM podczas dodawania użytkownika. Na późniejszych etapach pozostaje jedynie możliwość zmiany/resetu z poziomu portalu klienta.