Konfiguracja IIS: Różnice pomiędzy wersjami

Z wiki.groszek.pl
Przejdź do nawigacji Przejdź do wyszukiwania
Nie podano opisu zmian
Nie podano opisu zmian
Linia 2: Linia 2:


{{Uwaga}}
{{Uwaga}}
:*Zrzuty okien i adresy ścieżki przygotowano na podstawie wersji 10 systemu Windows,
:*Zrzuty okien i adresy ścieżki przygotowano na podstawie systemu Windows 10,
:*Filmy prezentujące konfigurowanie IIS znajdziemy na portalu [https://www.youtube.com/results?search_query=configuring+iis YouTube].   
:*Filmy prezentujące konfigurowanie IIS znajdziemy na portalu [https://www.youtube.com/results?search_query=configuring+iis YouTube].   


==Wymagania==
==IIS krok po kroku==
* Komputer z systemem Windows:
===Włączenie===
** Konto z uprawnieniami administratora (lub przynależność konta do grupy administratorów) w systemie operacyjnym, na którym będziemy uruchamiać IIS,
Przechodzimy do okna ''Programy i funkcje'' poprzez wciśnięcie kombinacji klawiszy ''Windows + R'', w wyświetlonym oknie wpisujemy ''appwiz.cpl'' i zatwierdzamy klikając ''OK'' lub wciskając ''Enter''.  
** Skonfigurowany i włączony serwer IIS.
 
* Działający serwer bazy danych Firebird na komputerze z IIS lub innym serwerze,
[[Plik:Konfiguracja IIS winr.png]]
* Zakupiony program ePodatki,
* Stały adres IP od ISP.


==Przygotowanie==
W oknie ''Programy i funkcje'' wybieramy opcję ''Włącz lub wyłącz funkcje systemu Windows''.
* Pobranie ze strony [https://groszek.pl groszek.pl] stabilnej wersji programów:
** ''epodatkiui'' (ePodatki UI [Usługa Internetowa]),
** ''epodatkiro'' (ePodatki RO [Rejestr Osób]),
** ''admin''.
* Pobranie klienta bazy danych Firebird w wersji 3.0 (stan wersji aktualny na: {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}) dla wersji systemu Windows na jakiej to będzie uruchomiony IIS.


==Wstępna konfiguracja==
[[Plik:Konfiguracja IIS programy i funkcje.png]]
*Instalujemy klienta bazy danych Firebird na maszynie, na której będzie włączony serwer IIS. W sytuacji problemów z serwerem bazy, zalecamy zapoznać się z instrukcją: [[Firebird zarządzanie]],
*Paczkę z programem ''epodatkiui'' rozpakowujemy i zalecamy umieścić na dysku C: w głównym korzeniu.


==IIS krok po kroku==
Odnajdujemy i zaznaczamy ''Internetowe usługi informacyjne'', a następnie zatwierdzamy klikając na przycisk ''OK''.
===Włączenie===
 
Uruchamiamy: ''Panel Sterowania'' (naciskamy klawisz WIN, wpisujemy ''panel sterowania'', wybieramy i uruchamiamy) > ''Programy i funkcja'' > ''Włącz lub wyłącz funkcje systemu Windows''. Zaznaczamy checkboxy, jak na poniższym zrzucie ekranu.
[[Plik:Konfiguracja IIS Funkcje systemu Windows.png]]
 
Po kilku chwilach usługa powinna zostać pomyślnie zainstalowana, co system Windows potwierdzi wyświetlając stosowny komunikat.


[[File: windows_wycinek_wlacz_lub_wylacz_funkcje_windows_iis.png|400px]]
[[Plik:Konfiguracja IIS koniec.png]]


===Status===
===Status===
Po zastosowaniu zmian, usługa IIS powinna zostać domyślnie włączona. Status sprawdzimy naciskając kombinację klawiszy '''WIN+R''', a następnie wpisując '''services.msc''' - zostanie wyświetlona lista usług. Usługa, której szukamy nazywa się: ''Usługa publikowania w sieci WWW''. Powinna działać, wycinek poniżej.
Po zastosowaniu zmian, usługa IIS powinna zostać automatycznie uruchomiona. Status usługi sprawdzimy naciskając kombinację klawiszy ''Windows + R'', w wyświetlonym oknie wpisujemy ''services.msc'' i zatwierdzamy klikając ''OK'' lub wciskając ''Enter''. Uruchomione zostanie okno ''Usługi'', na liście szukamy pozycji ''Usługa publikowania w sieci WWW''. Powinna działać, wycinek poniżej.


[[File: windows_wycinek_uslug_stan_www.png|600px]]
[[Plik:Konfiguracja IIS status.png]]


===Przystawka inetmgr===
===Menedżer internetowych usług informacyjnych (IIS)===
Naciskamy WIN+r i wpisujemy: ''inetmgr''. Wyświetlona przystawka, jest oknem zarządzania IIS.
Naciskając kombinację klawiszy ''Windows + R'', w wyświetlonym oknie wpisujemy ''inetmgr'' i zatwierdzamy klikając ''OK'' lub wciskając ''Enter''. Uruchomiony zostanie Menedżer internetowych usług informacyjnych, czyli okno służące do zarządzania usługą IIS.


[[File: windows_okno_inetmgr.png|600px]]
[[Plik:Konfiguracja IIS Menedżer.png|600px]]


===Dodawanie nowej witryny===
==ePodatki==
# Klikamy ppm na ''Witryny'', wybieramy z menu kontekstowego ''Dodaj witryne wieci Web...''
===Dodanie witryny ePodatki w IIS===
## Nazwa witryny: uzupełniamy dowolną nazwą. Można korzystać z naszej wewnętrznej nazwy: ServInfoSysAP,
#Pobieramy ze strony [https://groszek.pl groszek.pl] aktualną wersję programu ''ePodatkiUI'' (Usługa Internetowa).
## Ścieżka fizyczna: podajemy lokalizację do pliku ''ServInfoSysAP.exe'', który zgodnie z zaleceniami powinien znajdować się katalogu w głównej gałęzi na dysku C,
#Wypakowujemy pliki aplikacji do wybranej lokalizacji, zalecamy ''C:\inetpub\ePodatkiUI'' (ścieżka domyślna witryn IIS to ''C:\inetpub\<katalog_aplikacji>'').
## port: ustawiamy dowolny port wedle naszych potrzeb.
#Dodajemy nową witrynę w IIS.
[[File: windows_okno_iis_dodawanie_nowej_witryny.png]]
##Uruchamiamy [[Konfiguracja IIS 2#Menedżer internetowych usług informacyjnych (IIS)|Menedżer internetowych usług informacyjnych (IIS)]] > w sekcji ''Połączenia'' (lewa strona) klikamy PPM > wybieramy ''Dodaj witrynę sieci Web''.[[Plik:Konfiguracja IIS Dodawanie witryny.png|brak|ramka|Menedżer internetowych usług informacyjnych > Dodaj witrynę sieci Web]]
##Pole ''Nazwa witryny'' uzupełniamy dowolną nazwą, np. ePodatkiUI. ''Ścieżka fizyczna'' to lokalizacja folderu, do którego wypakowaliśmy pliki aplikacji ''ePodatkiUI''.[[Plik:Konfiguracja IIS Dodawanie witryny ePodatkiUI.png|brak|ramka|Dodawanie witryny sieci Web]]
##Zatwierdzamy klikając na przycisk ''OK''.
 
'''Ogranicznie ISAPI i CGI'''


===Ogranicznie ISAPI i CGI===
Klikamy przycisk ''Dodaj'' i dodajemy ścieżkę do pliku wykonywalnego dla naszej witryny.
Klikamy przycisk ''Dodaj'' i dodajemy ścieżkę do pliku wykonywalnego dla naszej witryny.


Linia 54: Linia 50:
{{Uwaga}}
{{Uwaga}}
:''ePodatkiUI'' może być wykonywana przez serwer IIS jako plik ''exe'' (obsługuje wolno żądania) lub jako biblioteka ładowana dynamicznie ''dll'' (obsługuje więcej żądań i szybciej).
:''ePodatkiUI'' może być wykonywana przez serwer IIS jako plik ''exe'' (obsługuje wolno żądania) lub jako biblioteka ładowana dynamicznie ''dll'' (obsługuje więcej żądań i szybciej).
: W celu obsługi jako dll, wybieramy plik ''ServInfoSysISAPI.dll'' z podkatalogu ''isapi''.
:W celu obsługi jako dll, wybieramy plik ''ServInfoSysISAPI.dll'' z podkatalogu ''isapi''.


===Uprawnienia do katalogu===
'''Uprawnienia do katalogu'''
Katalog z aplikacją ePodatkiUI powinien posiadać dodane odpowiednie uprawnienia. Klikamy ppm na katalogu, następnie zakładka ''Zabezpieczenia'', klikamy ''Dodaj'':
 
Katalog z aplikacją ePodatkiUI powinien posiadać dodane odpowiednie uprawnienia. Klikamy PPM na katalogu, następnie zakładka ''Zabezpieczenia'', klikamy ''Dodaj'':
* Klikamy ''Typy obiektów'', zaznaczamy ''Konta usług'', i ''OK'',
* Klikamy ''Typy obiektów'', zaznaczamy ''Konta usług'', i ''OK'',
* Wprowadzamy nazwę  ''IIS_WPG'' (dla innych wersji systemu Windows, nazwa użytkownika może się różnić. Jeśli korzystamy z innej wersji systemu, zalecamy wpisać ''IIS'' i zobaczyć wyniki wyszukiwania. Np. dla Windows 7 nazwa użytkownika będzie: ''IIS_IUSRS'') w pole ''Wprowadź nazwy obiektów do wybrania i dodajemy'', szukamy i dodajemy.
* Wprowadzamy nazwę  ''IIS_WPG'' (dla innych wersji systemu Windows, nazwa użytkownika może się różnić. Jeśli korzystamy z innej wersji systemu, zalecamy wpisać ''IIS'' i zobaczyć wyniki wyszukiwania. Np. dla Windows 7 nazwa użytkownika będzie: ''IIS_IUSRS'') w pole ''Wprowadź nazwy obiektów do wybrania i dodajemy'', szukamy i dodajemy.
Linia 64: Linia 61:
* W/w użytkownikowi ustawiamy ''Modyfikacja'' na ''Zezwalaj''.
* W/w użytkownikowi ustawiamy ''Modyfikacja'' na ''Zezwalaj''.


==Ustawienia po stronie ePodatków==
'''TO DO'''
 
#dodawanie nowej witryny - done.
#ogranicznie ISAPI i CGI (epodatki)
#uprawnienia do katalogu (epodatki)
#opis mapowań obsługi
#dodanie dozwolonych rozszerzeń pliku (''.exe'', ''.xml'')
 
===ePodatkiUI (Usługa Internetowa) - konfiguracja===
Instrukcja wstępnej konfiguracji aplikacji ''ePodatki'' jest dostępna na stronie [[EPodatki konfiguracja]].
Instrukcja wstępnej konfiguracji aplikacji ''ePodatki'' jest dostępna na stronie [[EPodatki konfiguracja]].


===ePodatkiRO (Rejestr Osób) - konfiguracja===
Aplikacja ''RejestrOsb.exe'' służy do zarządzania użytkownikami aplikacji ''ePodatki'', jej szerszy opis znajdziemy na stronie [[ePodatki Rejestr Użytkowników]].
==WebAdmin==
#Pobieramy ze strony [https://groszek.pl groszek.pl] aktualną wersje programu ''WebAdmin''.
#Wypakowujemy pliki aplikacji do wybranej lokalizacji, zalecamy ''C:\inetpub\WebAdmin'' (ścieżka domyślna witryn IIS to ''C:\inetpub\<katalog_aplikacji>'').
#Dodajemy nową witrynę w IIS.
##Uruchamiamy [[Konfiguracja IIS 2#Menedżer internetowych usług informacyjnych (IIS)|Menedżer internetowych usług informacyjnych (IIS)]] > w sekcji ''Połączenia'' (lewa strona) klikamy PPM > wybieramy ''Dodaj witrynę sieci Web''.[[Plik:Konfiguracja IIS Dodawanie witryny.png|brak|ramka|Menedżer internetowych usług informacyjnych > Dodaj witrynę sieci Web]]
##Pole ''Nazwa witryny'' uzupełniamy dowolną nazwą, np. WebAdmin. ''Ścieżka fizyczna'' to lokalizacja folderu, do którego wypakowaliśmy pliki aplikacji ''WebAdmin''.[[Plik:Konfiguracja IIS Dodawanie witryny WebAdmin.png|brak|ramka|Dodawanie witryny sieci Web]]
##Zatwierdzamy klikając na przycisk ''OK''.
#W pliku ''Admin.xml'' podajemy ścieżkę oraz dane dostępowe do bazy danych ([[Wzorcowy plik XML]]).
#Możemy edytować również plik ''Aktualizacje.xml'', jednak można to zrobić później z poziomu aplikacji WebAdmin - opis na stronie [[WebAdmin instrukcja#Aktualizacje]].
#Dodajemy uprawnienia modyfikacji dla grupy ''Użytkownicy'' do plików: ''AdminErrors.txt'', ''Aktualizacje.xml'', ''BackupPaths.xml'' oraz folderu ''/Downloads''.[[Plik:Konfiguracja IIS Dodawanie witryny WebAdmin uprawnienia.png|brak|ramka|Uprawnienia modyfikacji dla grupy ''Użytkownicy'']]
Po wykonaniu powyższych czynności aplikacja ''WebAdmin'' powinna poprawnie działać. Domyślne dane do logowania do aplikacji WebAdmin to:
login: admin
pass: admin
Zmienić je możemy poprzez kliknięcie w nazwę konta w prawym górnym rogu aplikacji i wybraniu opcji ''Zmień swój login'' i ''Zmień swoje hasło''.
W zakładce ''Zarządzanie użytkownikami'' możemy dodawać innych administratorów i zarządzać ich uprawnieniami. Uprawnienie ''Admin'' to uprawnienie o najwyższym poziomie, pozwala na korzystanie ze wszystkich funkcji jakie daje aplikacja ''WebAdmin''.


[[Category:ePodatki]]
[[Category:ePodatki]]
[[Kategoria:WebAdmin]]
[[Kategoria:WebAdmin]]
[[Category:Aneks]]
[[Category:Aneks]]

Wersja z 11:59, 20 sie 2018

Dokument zawiera opis konfiguracji serwera usług internetowych - Internet Information Services (IIS). Z IIS korzystamy m.in. w celu uruchomienia aplikacji ePodatki oraz WebAdmin.

Uwaga!
  • Zrzuty okien i adresy ścieżki przygotowano na podstawie systemu Windows 10,
  • Filmy prezentujące konfigurowanie IIS znajdziemy na portalu YouTube.

IIS krok po kroku

Włączenie

Przechodzimy do okna Programy i funkcje poprzez wciśnięcie kombinacji klawiszy Windows + R, w wyświetlonym oknie wpisujemy appwiz.cpl i zatwierdzamy klikając OK lub wciskając Enter.

W oknie Programy i funkcje wybieramy opcję Włącz lub wyłącz funkcje systemu Windows.

Odnajdujemy i zaznaczamy Internetowe usługi informacyjne, a następnie zatwierdzamy klikając na przycisk OK.

Po kilku chwilach usługa powinna zostać pomyślnie zainstalowana, co system Windows potwierdzi wyświetlając stosowny komunikat.

Status

Po zastosowaniu zmian, usługa IIS powinna zostać automatycznie uruchomiona. Status usługi sprawdzimy naciskając kombinację klawiszy Windows + R, w wyświetlonym oknie wpisujemy services.msc i zatwierdzamy klikając OK lub wciskając Enter. Uruchomione zostanie okno Usługi, na liście szukamy pozycji Usługa publikowania w sieci WWW. Powinna działać, wycinek poniżej.

Menedżer internetowych usług informacyjnych (IIS)

Naciskając kombinację klawiszy Windows + R, w wyświetlonym oknie wpisujemy inetmgr i zatwierdzamy klikając OK lub wciskając Enter. Uruchomiony zostanie Menedżer internetowych usług informacyjnych, czyli okno służące do zarządzania usługą IIS.

ePodatki

Dodanie witryny ePodatki w IIS

  1. Pobieramy ze strony groszek.pl aktualną wersję programu ePodatkiUI (Usługa Internetowa).
  2. Wypakowujemy pliki aplikacji do wybranej lokalizacji, zalecamy C:\inetpub\ePodatkiUI (ścieżka domyślna witryn IIS to C:\inetpub\<katalog_aplikacji>).
  3. Dodajemy nową witrynę w IIS.
    1. Uruchamiamy Menedżer internetowych usług informacyjnych (IIS) > w sekcji Połączenia (lewa strona) klikamy PPM > wybieramy Dodaj witrynę sieci Web.
      Menedżer internetowych usług informacyjnych > Dodaj witrynę sieci Web
    2. Pole Nazwa witryny uzupełniamy dowolną nazwą, np. ePodatkiUI. Ścieżka fizyczna to lokalizacja folderu, do którego wypakowaliśmy pliki aplikacji ePodatkiUI.
      Dodawanie witryny sieci Web
    3. Zatwierdzamy klikając na przycisk OK.

Ogranicznie ISAPI i CGI

Klikamy przycisk Dodaj i dodajemy ścieżkę do pliku wykonywalnego dla naszej witryny.

Uwaga!
ePodatkiUI może być wykonywana przez serwer IIS jako plik exe (obsługuje wolno żądania) lub jako biblioteka ładowana dynamicznie dll (obsługuje więcej żądań i szybciej).
W celu obsługi jako dll, wybieramy plik ServInfoSysISAPI.dll z podkatalogu isapi.

Uprawnienia do katalogu

Katalog z aplikacją ePodatkiUI powinien posiadać dodane odpowiednie uprawnienia. Klikamy PPM na katalogu, następnie zakładka Zabezpieczenia, klikamy Dodaj:

  • Klikamy Typy obiektów, zaznaczamy Konta usług, i OK,
  • Wprowadzamy nazwę IIS_WPG (dla innych wersji systemu Windows, nazwa użytkownika może się różnić. Jeśli korzystamy z innej wersji systemu, zalecamy wpisać IIS i zobaczyć wyniki wyszukiwania. Np. dla Windows 7 nazwa użytkownika będzie: IIS_IUSRS) w pole Wprowadź nazwy obiektów do wybrania i dodajemy, szukamy i dodajemy.

  • Dodajemy użytkownika IIS_WPG,
  • W/w użytkownikowi ustawiamy Modyfikacja na Zezwalaj.

TO DO

  1. dodawanie nowej witryny - done.
  2. ogranicznie ISAPI i CGI (epodatki)
  3. uprawnienia do katalogu (epodatki)
  4. opis mapowań obsługi
  5. dodanie dozwolonych rozszerzeń pliku (.exe, .xml)

ePodatkiUI (Usługa Internetowa) - konfiguracja

Instrukcja wstępnej konfiguracji aplikacji ePodatki jest dostępna na stronie EPodatki konfiguracja.

ePodatkiRO (Rejestr Osób) - konfiguracja

Aplikacja RejestrOsb.exe służy do zarządzania użytkownikami aplikacji ePodatki, jej szerszy opis znajdziemy na stronie ePodatki Rejestr Użytkowników.

WebAdmin

  1. Pobieramy ze strony groszek.pl aktualną wersje programu WebAdmin.
  2. Wypakowujemy pliki aplikacji do wybranej lokalizacji, zalecamy C:\inetpub\WebAdmin (ścieżka domyślna witryn IIS to C:\inetpub\<katalog_aplikacji>).
  3. Dodajemy nową witrynę w IIS.
    1. Uruchamiamy Menedżer internetowych usług informacyjnych (IIS) > w sekcji Połączenia (lewa strona) klikamy PPM > wybieramy Dodaj witrynę sieci Web.
      Menedżer internetowych usług informacyjnych > Dodaj witrynę sieci Web
    2. Pole Nazwa witryny uzupełniamy dowolną nazwą, np. WebAdmin. Ścieżka fizyczna to lokalizacja folderu, do którego wypakowaliśmy pliki aplikacji WebAdmin.
      Dodawanie witryny sieci Web
    3. Zatwierdzamy klikając na przycisk OK.
  4. W pliku Admin.xml podajemy ścieżkę oraz dane dostępowe do bazy danych (Wzorcowy plik XML).
  5. Możemy edytować również plik Aktualizacje.xml, jednak można to zrobić później z poziomu aplikacji WebAdmin - opis na stronie WebAdmin instrukcja#Aktualizacje.
  6. Dodajemy uprawnienia modyfikacji dla grupy Użytkownicy do plików: AdminErrors.txt, Aktualizacje.xml, BackupPaths.xml oraz folderu /Downloads.
    Uprawnienia modyfikacji dla grupy Użytkownicy

Po wykonaniu powyższych czynności aplikacja WebAdmin powinna poprawnie działać. Domyślne dane do logowania do aplikacji WebAdmin to:

login: admin
pass: admin

Zmienić je możemy poprzez kliknięcie w nazwę konta w prawym górnym rogu aplikacji i wybraniu opcji Zmień swój login i Zmień swoje hasło. W zakładce Zarządzanie użytkownikami możemy dodawać innych administratorów i zarządzać ich uprawnieniami. Uprawnienie Admin to uprawnienie o najwyższym poziomie, pozwala na korzystanie ze wszystkich funkcji jakie daje aplikacja WebAdmin.