Instalacja eZ Publish
System eZ Publish, jak każdy inny system CMS wymaga zainstalowania go w odpowiednim środowisku serwerowym. Od wyboru środowiska w jakim chcesz uruchomić naszego CMSa zależy wybór „paczki instalacyjnej”, którą można pobrać ze strony producenta.
Instalacja eZ Publish na poprawnie przygotowanym serwerze, z dostępem do bazy danych zajmuje około 90 sekund :) Zobacz film.
W chwili pisania artykułu dostępne są dwa rodzaje możliwych do pobrania paczek instalacyjnych (w wersji darmowej), dla środowiska Linux/UNIX oraz środowiska Windows. W artykule zajmę się najbardziej popularną instalacją w środowisku Linux, pakietu eZ Publish Community Project 2011.5.
Przed rozpoczęciem instalacji upewnij się, że Twoje środowisko spełnia wymagania stawiane mu przez eZ Publish. Lista wymagań zależna jest od wersji instalowanego systemu i dla mojego przykładu jest to: http://doc.ez.no/eZ-Publish/Technical-manual/4.5/Installation/Requirements-4.5
Istnieją trzy metody instalacji systemu eZ Publish, a wybór jednej z nich zależy przede wszystkim od znajomości samego systemu CMS:
- Instalacja normalna (Normal installation)
- Instalacja ręczna (Manual installation)
- Instalacja zautomatyzowana (Automated installation)
Instalacja normalna
Ten typ instalacji jest najczęściej stosowanym i rekomendowanym typem instalacji systemu (właśnie tą metodę opiszę). Instalacja wymaga przygotowanego już środowiska serwerowego wraz z bazą danych, a sam proces instalacji sprowadza się do skorzystania z wbudowanego „Wizarda”, który krok po kroku przeprowadza nas przez proces instalacyjny.
Instalacja ręczna
Ręczna instalacja systemu przeznaczona jest dla zaawansowanych użytkowników z biegłą znajomością systemu. Tryb instalacji nie zawiera żadnych pomocnych okien dialogowych, żadnego Wizarda, a cały proces sprowadza się do rozpakowania paczki systemu i ręcznym skonfigurowaniu wielu plików konfiguracyjnych. Tak jak w poprzednim przypadku, sam eZ Publish wymaga już przygotowanego środowiska serwerowego.
Instalacja zautomatyzowana
Ten typ instalacji (tzw. kickstart) przeznaczony jest dla zaawansowanych użytkowników systemu, będących administratorami systemu serwerowego, którzy chcieliby dokonać wstępnej konfiguracji eZ Publish, która później wymaga minimum interakcji podczas pracy z Wizardem. System również wymaga przygotowanego środowiska serwerowego, a sam proces opiera się o wcześniej skonfigurowane parametry (kickstart.ini).
„Normalna” instalacja eZ Publish
Typowa instalacja systemu eZ Publish składa się z następujących kroków:
- Pobranie i rozpakowanie pakietu z dystrybucją systemu
- Utworzenie bazy danych na potrzeby instalacji
- Instalacja systemu (przy użyciu Kreatora instalacji)
Zakładam, że pobranie i rozpakowanie paczki instalacyjnej oraz stworzenie nowej bazy danych jest na tyle "codziennym" zadaniem, że nie trzeba go opisywać :)
Uruchomienie kreatora instalacji systemu eZ Publish może być wywołana przez dowolną przeglądarkę internetową, poprzez pierwsze wywołanie pliku „index.php” znajdującego się w katalogu z rozpakowanym pakietem. Sam kreator nie zapisuje żadnych danych dopóki nie zakończymy ostatniego kroku kreatora.
Instalacja przy użyciu kreatora składa się z 12 kroków:
Strona powitania – krok 1
Pierwszy krok w kreatorze to powitanie użytkownika oraz przede wszystkim wybór języka, który ma być użyty podczas instalacji. Jakość oraz kompletność tłumaczeń kreatora zależy od wersji eZ Publish i dostępnych słowników.
Krok ten pozwala również na sprawdzenie poprawności konfiguracji systemu, w którym instalowany jest eZ Publish. Po kliknięciu przycisku „Finetune” kreator pokaże stronę „System finetuning”, na której wyświetli ewentualne niezgodności konfiguracji serwera w odniesieniu do wymagań eZ Publsih.
Po kliknięciu przycisku „Dalej” (w przypadku gdy któreś z elementów niezgodności systemu są krytyczne dla jego działania i wymagają poprawy), kreator wyświetli stronę „System check”, na której znajdą się informacje o elementach wymagających zmiany w konfiguracji serwera. Na moim przykładzie, kreator zgłosił informacje o konieczności włączenia opcji AcceptPathInfo w konfiguracji serwera.
W przypadku niewystępowania krytycznych niezgodności systemu, kreator automatycznie przejdzie do drugiego kroku.
Konfiguracja wysyłania e-maili – krok 2
Drugi krok w pracy z kreatorem pozwala na wybór metody używanej przez eZ Publish do wysyłania wiadomości e-mail. System obsługuje dwie opcje konfiguracyjne:
- Bezpośrednie wysyłanie wiadomości przez serwer na którym instalujemy CMSa (system sendmail musi być zainstalowany na serwerze),
- Wysyłanie wiadomości przy użyciu protokołu SMTP (zalecane podczas instalacji w środowisku Windows),
Wybór typu bazy danych – krok 3
W trzecim kroku kreator zapyta nas o typ bazy danych jakiej chcemy używać w pracy z systemem eZ Publish. Na liście dostępnych typów wyświetlone są wyłącznie te typy, które kreator znalazł w przygotowanym środowisku (bazy dostępne dla skryptu PHP). W przypadku, gdy kreator wykryje tylko jeden typ bazy danych, domyślnie zostanie on wybrany i ekran nie zostanie wyświetlony.
W przypadku gdy rozszerzenie MySQLi jest włączone w PHP, dostępna będzie opcja bazy „MySQL Improved”. Jeżeli zamierzamy użyć bazy danych MySQL zalecane jest wówczas skorzystanie z opcji „MySQL Improved”.
Inicjalizacja bazy danych – krok 4
Po wybraniu silnika bazy danych kreator zapyta nas o dane dostępowe do samej bazy. Należy podać nazwę hosta (jeżeli baza danych uruchamiana jest na tym samym serwerze możemy zostawić domyślnie wartość localhost) oraz nazwę użytkownika i hasło jakie będą używane do połączenia się bazą danych.
Kliknięcie przycisku „Dalej” wywoła próbę połączenia się do serwera bazy danych (dla MySQL), a przejście do kolejnego kroku będzie możliwe dopiero po poprawnym uzyskaniu połączenia. W przypadku bazy PostgreSQL połączenie testowane jest na dalszym etapie.
Obsługa języków – krok 5
W kroku piątym kreator pozwala na wybór języka domyślnego (przycisk radio - wymagane) oraz opcjonalnie na wybranie dodatkowych języków jakie planujemy używać. Wybór języka domyślnego determinuje również w systemie ustawienia lokalne, tj. pol-PL dla języka polskiego. Oznacza to, że wszelkie elementy związane z walutami itp., będą używane zgodnie z deklaracją pliku ini dla języka polskiego.
Zmiana języków / dodatnie kolejnych jest oczywiście możliwa po zakończeniu instalacji.
Wybór instalowanego pakietu – krok 6
Krok szósty kreatora pozwala na wybór jednego ze standardowych pakietów jaki ma zostać zainstalowany. Wybór pakietu zależy od wymagań jakie stawiamy naszej instalacji. Każdy z pakietów posiada inny zestaw gotowych do użycia rozwiązań. Z uwagi na fakt, że w każdej chwili możemy poszerzać zestaw funkcjonalności systemu eZ Publish, w naszym przykładzie wybieram tzw. „Plain site”. Pakiet ten zawiera jedynie podstawowe funkcjonalności niezbędne do rozpoczęcia pracy z samym systemem. Po zakończeniu instalacji można dodawać kolejne pakiety.
Kreator automatycznie pobierze wybrany pakiet (wraz z ewentualnymi pakietami zależnymi), zainstaluje w naszym systemie i wyświetli ekran z podsumowaniem zainstalowanych pakietów.
Wybór opcji językowych pakietu – krok 7
W przypadku, gdy wybrane przez nas w kroku 5 języki nie są wspólne z językami użytymi w wybranych pakietach, system zapyta nas o metodę, jaka powinna zostać zastosowana do rozwiązania tej niezgodności. W moim przykładzie wybrałem język polski jako język domyślny (krok 5), natomiast wybrany pakiet posiada stworzoną prostą strukturę serwisu w języku brytyjskim. Do wyboru mamy trzy możliwości:
- Ominięcie contentu (struktury serwisu) w języku pakietu
- Utworzenie brakującego języka
- Zamapowanie contentu z pakietu na jeden z wybranych przez nas języków
Opcja mapowania contentu wydaje się być w naszym przypadku najbardziej odpowiednia (nie chcemy mieć języka brytyjskiego) ale nie chcemy również stracić struktury stworzonej w instalowanym pakiecie.
Wybór metody dostępowej – krok 8
Krok ósmy kreatora pozwala na wybór jednej z dostępnych metod dostępu, jakiej ma używać eZ Publish gdy otrzyma request wyświetlenia strony. Dostępne są trzy metody:
- URL (zalecana dla testowej instalacji) – część adresu URL (zaraz po „index.php”) wskazuje na jeden z siteaccessów (publiczny bądź panelu administracyjnego).
- Port – wybór jednego z siteaccessów następuje w zależności od zadeklarowanych portów. Opcja ta wymaga dodatkowych ustawień serwera WWW.
- Hostname (zalecana dla instalacji docelowej) – każdy z używanych w CMSie siteaccessów w swojej konfiguracji powinien mieć wskazane odpowiednie nazwy hostów. Przykład: Front end naszego serwisu powinien być widoczny pod domeną www.examle.com, natomiast panel administracyjny pod domeną admin.example.com. Ta opcja wymaga dodatkowej konfiguracji serwera DNS dla wybranych domen.
Po zakończeniu procesu instalacji metoda dostępowa może zostać zmieniona na jedną z dostępnych. Zaleca się użycie metody URL dla pierwszych / testowych instalacji.
Szczegóły instalacji – krok 9
Krok dziewiąty pozwala na zmianę ustawień związanych z dostępem do instalowanego serwisu oraz wybór bazy danych jaka ma zostać użyta dla naszej instalacji.
Pola „User path – Ścieżka dla strony użytkownika” oraz „Admin path – Ścieżka dla administratora” zależy od wybranej w kroku 8 metody dostępowej.
W przypadku wyboru bazy danych, która zawiera już dane, kreator zapyta nas co ma zrobić. Możliwymi do wyboru rozwiązaniami są:
- Pozostawienie danych i dodanie nowych
- Usunięcie istniejących danych
- Pozostawienie istniejących danych i nic więcej
- Wybór nowej bazy danych
Dostęp do Panelu Administracyjnego – krok 10
Domyślnie dostęp do Panelu Administracyjnego posiada jedynie użytkownik o loginie „admin”. W kroku tym możemy zdefiniować Imię, Nazwisko, adres e-mail oraz hasło dla użytkownika, który tego loginu będzie używać.
Po zakończeniu instalacji możemy tworzyć kolejnych użytkowników o odpowiednim poziomie uprawnień oraz zmienić podane w tym kroku dane. System nie daje możliwości zmiany loginu.
Zabezpieczanie strony – krok 11
Z przyczyn bezpieczeństwa zaleca się aby instalacja serwisu pracowała w trybie „virtual host mode”. Jeżeli nie mamy możliwości pracy serwera w tym trybie, należy do naszej instalacji dodać plik .htaccess. Instrukcje zawarte w pliku .htaccess wymagają na serwerze odpowiednie restrykcyjne reguły dostępu do plików naszej instalacji. Plik z wzorcowymi regułami dostarczony jest w katalogu głównym naszej instalacji i nosi nazwę .htaccess_root.
Rejestracja instalacji – krok 12
W kroku dwunastym kreator wyświetla nam podsumowanie naszych ustawień i pozwala na wysłanie informacji (poprzez e-mail) do eZ Systems (producent systemu eZ Publish). Do wysyłanych danych należą informacje na temat:
- Szczegółów systemy operacyjnego
- Rezultat zgodności testu wymagań systemu w odniesieniu do serwera
- Typ bazy danych użytej w instalacji
- Nazwę strony
- Adres URL strony
- Języki, które zostały wybrane
Jeżeli nie chcesz aby te informacje zostały wybrane, należy odznaczyć opcję „Wyślij rejestrację”
Zakończenie – krok 13
Krok trzynasty pracy instalatora to wyłącznie podsumowanie, system eZ Publish jest już zainstalowany i gotowy do używania. Linki zawarte w podsumowaniu pozwalają na otwarcie obydwu interfejsów – strony publicznej oraz panelu administracyjnego.
Po poprawnym zakończeniu instalacji istnieje możliwość restartu pracy kreatora, co spowoduje przejście całej procedury instalacji (z użyciem kreatora) jeszcze raz. Aby wymusić ponowne uruchomienie pracy kreatora podczas wywołania adresu naszej strony wystarczy ustawić zmienną CheckValidity=true w pliku „settings/override/site.ini.append.php” naszej instalacji.
Dostęp do Panelu Administracyjnego
Po kliknięciu w link "Admin site" system otworzy nową kartę przeglądarki pozwalającą na zalogowanie się do Panelu Administracyjnego aplikacji.
