# Podręcznik WebIssues

## Wersja 1.0.4

Spis treści » Przygotowanie systemu
« Przygotowanie systemu
Konfiguracja początkowa »

## Instalacja

Po upewnieniu się, że wymagane komponenty są zainstalowane i skonfigurowane, oraz utworzeniu bazy danych, możesz przystąpić do właściwej instalacji serwera WebIssues.

### Kopiowanie plików

Ściągnij i rozpakuj pakiet serwera WebIssues — zawiera on katalog o nazwie `webissues-x.y` (gdzie `x.y` to wersja pakietu). Następnie przenieś wszystkie pliki i podkatalogi z tego katalogu do katalogu głównego serwera WWW. Jeśli korzystasz z zewnętrznego hostingu, na ogół do kopiowania plików na serwer używa się protokołu FTP, a więc będziesz potrzebował do tego celu klienta FTP.

### Notatka

Istnieje możliwość zainstalowania serwera WebIssues wraz z innymi stronami i aplikacjami WWW działającymi na tym samym komputerze. Możesz zainstalować serwer w podkatalogu umieszczonym w katalogu głównym serwera WWW, a także na wirtualnym hoście lub w wirtualnym katalogu. Zapoznaj się z dokumentacją twojego serwera WWW lub usługi hostingowej, aby uzyskać więcej informacji na ten temat.

Możesz także utworzyć wiele odrębnych instancji serwera WebIssues w ramach jednej instalacji. Poszczególne instancje mogą być dostępne poprzez różne nazwy domen lub subdomen albo w różnych wirtualnych podkatalogach. Więcej informacji na ten temat znajdziesz na stronie http://wiki.mimec.org/wiki/WebIssues/Configuration.

Następnie nadaj prawo zapisu do podkatalogu `data/sites` wszystkim użytkownikom lub użytkownikowi, w kontekście którego działa usługa WWW. Skorzystaj w tym celu z menedżera plików lub klienta FTP albo uruchom polecenie `chmod` z linii poleceń. W katalogu tym, podczas instalacji, zostanie utworzony plik konfiguracyjny. Będą w nim również przechowywane dołączone do spraw załączniki.

### Uwaga

Upewnij się, że katalogi `data` oraz `common/data` są zabezpieczone przed niepowołanym dostępem przez przeglądarkę internetową. W przeciwnym wypadku nieuprawnione do tego osoby będą mogły np. pobierać przechowywane w systemie załączniki. Jeśli korzystasz z serwera Apache, możesz w tym celu wykorzystać załączone w pakiecie pliki `.htaccess`. Więcej informacji na ten temat znajdziesz na stronie http://wiki.mimec.org/wiki/WebIssues/Installation.

Po zakończeniu instalacji upewnij się również, że plik konfiguracyjny systemu WebIssues jest chroniony przed niepowołanym dostępem, ponieważ zawiera on między innymi login i hasło do bazy danych. Jest to szczególnie istotne w przypadku korzystania z publicznych usług hostingowych.

Dla zapewnienia największego bezpieczeństwa zaleca się, aby pliki konfiguracyjne i załączniki nie były przechowywane w katalogu `data`, ale w innej lokalizacji położonej poza katalogiem głównym serwera WWW. Więcej informacji na temat zmiany lokalizacji katalogu zawierającego te pliki znajdziesz na stronie http://wiki.mimec.org/wiki/WebIssues/Configuration.

### Konfiguracja systemu

Teraz możesz już otworzyć stronę główną systemu WebIssues. Uruchom swoją ulubioną przeglądarkę internetową i wpisz adres URL serwera, na przykład `http://www.example.com`. Powinieneś zobaczyć następujący komunikat:

Rysunek 2.1. Komunikat powitalny

Nie przejmuj się, że komunikat jest po angielsku. Jeśli postąpisz zgodnie z instrukcją i klikniesz odnośnik, zostaniesz zapytany o język, który będzie używany w czasie instalacji. Będzie to również domyślny język, w jakim system WebIssues będzie wyświetlał wszystkie komunikaty.

W następnym kroku instalacji wyświetlone zostaną podstawowe informacje na temat twojego serwera: nazwa instancji (zwykle będzie to `default`, chyba że tworzysz wiele instancji serwera w ramach jednej instalacji), bazowy adres URL serwera oraz ścieżka katalogu, w którym zostanie utworzony plik konfiguracyjny. Zostanie również wyświetlona wersja PHP, serwera WWW i systemu operacyjnego oraz nazwa komputera, na którym instalujesz system WebIssues. Po zweryfikowaniu tych informacji, przejdź do następnego kroku.

Rysunek 2.2. Konfiguracja połączenia z bazą danych

Zostaniesz poproszony o wprowadzenie informacji niezbędnych do połączenia z wcześniej utworzoną bazą danych. Musisz przede wszystkim określić jej rodzaj. W zależności od konfiguracji PHP, będziesz miał do dyspozycji bazę MySQL, PostgreSQL lub SQL Server. Jeśli któraś z tych opcji jest niedostępna, oznacza to, że niezbędne rozszerzenie PHP nie zostało zainstalowane lub jest wyłączone.

Następnie podaj nazwę hosta serwera bazy danych, jeśli znajduje się on na innym komputerze niż serwer WWW, nazwę bazy danych oraz login i hasło użytkownika posiadającego prawo tworzenia tabel w tej bazie danych. W przypadku bazy SQL Server możesz pozostawić login i hasło puste, aby użyć zintegrowanej autentykacji Windows.

### Notatka

W trakcie instalacji możesz również określić prefiks, który zostanie dodany przed nazwami wszystkich tabel i innych obiektów w bazie danych. Jeśli na przykład wybierzesz prefiks `wi_`, zostaną utworzone tabele o nazwach `wi_server`, `wi_users`, itd.

Wybierając unikalny prefiks, możesz zainstalować wiele różnych aplikacji korzystających z jednej bazy danych. Możesz również utworzyć kilka oddzielnych instancji serwera WebIssues w ramach jednej bazy danych.

Podaj niezbędne informacje i przejdź do następnego kroku. System WebIssues spróbuje połączyć się z serwerem bazy danych, a w przypadku błędu wyświetli odpowiedni komunikat. Jeśli połączenie się powiedzie, a baza danych nie zawiera jeszcze tabel niezbędnych do działania systemu, zostanie wyświetlona następująca strona:

Rysunek 2.3. Parametry nowego serwera

Podaj nazwę serwera, która będzie widoczna dla wszystkich użytkowników w lewym górnym rogu strony. Wprowadź również hasło dla konta administratora, którego będziesz mógł później użyć, aby zalogować się do serwera i zmieniać jego ustawienia.

Domyślnie instalator utworzy kilka predefiniowanych typów spraw i widoków. Najlepiej pozostaw to ustawienie, aby szybko rozpocząć pracę z systemem. Będziesz miał później możliwość swobodnego dostosowania, a nawet usunięcia tych wbudowanych typów. Jeśli jednak chcesz samodzielnie utworzyć wszystkie typy spraw od podstaw, wybierz opcję Nie instaluj żadnych typów spraw.

### Notatka

Istnieje możliwość zaimportowania danych z serwera WebIssues w wersji 0.8.5 do nowej wersji systemu. Nowy serwer musi być zainstalowany w tej samej bazie danych co jego poprzednia wersja. Musisz więc użyć innego prefiksu dla nazw nowych tabel niż ten, który był użyty w wersji 0.8.5. Wybierz opcję Importuj dane z serwera WebIssues 0.8.5 i opcjonalnie wprowadź prefiks dla tabel źródłowych.

Podczas instalacji nowego serwera wszystkie dane przechowywane w bazie danych zostaną skopiowane, ale tabele źródłowe nie zostaną zmodyfikowane ani usunięte. Jeśli zatem proces importu się nie powiedzie, możesz poprawić ewentualne błędy i ponowić instalację nowej wersji. Jeśli załączniki były przechowywane w systemie plików, musisz je także skopiować ze starej wersji do odpowiedniego katalogu w nowej wersji serwera. Instalator nie zrobi tego automatycznie.

Jeśli w wersji 0.8.5 systemu używałeś starszej wersji bazy danych niż jest obecnie wymagana, przed rozpoczęciem instalacji musisz najpierw zaktualizować bazę danych do nowszej wersji. Po zaktualizowaniu bazy MySQL z wersji starszej niż 4.1, musisz także skonwertować kolumny typu tekstowego na binarne, a następnie na tekstowe z kodowaniem `utf8`, aby zachować poprawne kodowanie tekstu. Przeczytaj http://dev.mysql.com/doc/refman/4.1/en/charset-conversion.html aby uzyskać informacje na temat konwersji kolumn.

Przejdź do kolejnej strony, która zawiera krótkie podsumowanie czynności, które zostaną wykonane. Kliknij przycisk Instaluj, aby rozpocząć instalację. Może to potrwać kilka sekund, a w przypadku importu istniejących danych nieco dłużej. Jeśli instalacja zakończy się sukcesem, zostanie wyświetlony odpowiedni komunikat.

Jeśli tworzysz nowy plik konfiguracyjny dla wcześniej utworzonego serwera, podaj parametry połączenia do bazy danych zawierającej dane tej instancji. Strona służąca do wprowadzania parametrów nowego serwera zostanie w takim wypadku pominięta, a baza danych nie zostanie w żaden sposób zmodyfikowana. Zamiast tego wyświetlona zostanie nazwa i inne informacje na temat istniejącego serwera, a proces instalacji utworzy jedynie nowy plik konfiguracyjny.

### Wskazówka

Aby w przyszłości utworzyć nowy plik konfiguracyjny, na przykład po przeniesieniu bazy danych na inny serwer, musisz najpierw skasować istniejący plik konfiguracyjny. Jest to zabezpieczenie chroniące system przed niepowołanym dostępem do procedury instalacyjnej.

« Przygotowanie systemu
Konfiguracja początkowa »