Dla tych, którzy jeszcze nie osiwieli czekając na wydanie wersji WWW aplikacji Bibliotekarz mam dziś do pobrania najnowszą paczkę – wersję 1.0.23. Jest to paczka nie zawierająca Microsoft .NET Core 2.0 dlatego aby uruchomić program należy zainstalować: https://www.microsoft.com/net/download/thank-you/dotnet-runtime-2.0.6-windows-x64-asp.net-core-runtime-installer
Uruchomienie – przypadek optymistyczny
Kroki jaki należy wykonać aby uruchomić program:
- Zainstalować silnik bazy danych (szczegóły w poprzednich wpisach na blogu)
- Zainstalować .NET Core 2.0 (link powyżej)
- Pobrać paczkę z programem blibliotekarz.net https://bibliotekarz.net/webplatform/BibliotekarzWebPlatform_1.0.23_NoFramework.7z
- Rozpakować paczkę z programem np do folderu: C:\BibliotekarzWebPlatform (jeśli archiwum nie chce się rozpakować, wymagana może być instalacja programu: https://7-zip.org.pl/sciagnij.html)
-
Program możemy uruchomić na dwa sposoby:
– poleceniem wiersza poleceń: wykonujemy polecenie: dotnet C:\BibliotekarzWebPlatform\WEB_Core_Bibliotekarz.dll
– poprzez serwis IIS: wszczegóły w dalszej części wpisu - W przypadku poprawnego uruchomienia, otwieramy przeglądarkę internetową i wpisujemy adres: https://localhost:5001 Powinna pojawić się strona aplikacji
Uruchomienie – Konfiguracja IIS
W przypadku chęci korzystania z serwera IIS (ma to choćby taką zaletę, że serwis działa bez potrzebny utrzymywania zalogowanej sesji użytkownika), potrzebujemy:
- Zainstalowany i uruchomiony serwis IIS. Osoby, które go nie posiadają muszą dokonać odpowiedniej instalacji (patrz: https://docs.microsoft.com/pl-pl/aspnet/core/host-and-deploy/iis/?tabs=aspnetcore2x)
- Zainstalowany moduł dla IIS (pakiet .NET Core w wersji ServerHosting Installer https://www.microsoft.com/net/download/dotnet-core/runtime-2.0.6)
-
Utworzenie nowej witryny na serwerze IIS. Wskazujemy ścieżkę, gdzie rozpakowaliśmy nasze archiwum.
-
Konfigurujemy pulę aplikacyjną, tak aby nie miała kodu zarządzalnego.
-
W przypoadku hostowania aplikacji na IIS, domyślnie może być wykorzystywane konto sieciowe lub "wirtualne konto puli". Oba typy tych kont nie mają dostępu do bazy danych aplikacji, dlatego należy zmienić sposób uwierzytelniania do bazy danych w pliku appsettings.json.
- Uruchamiamy konsolę zarządzania serwerem baz danych – SQL Management Studio
-
Dodajemy nowy login, z którego będzie korzystał nasz program. Ja nazwałem swojego użytkownika sqlUser
- Nadajemy użytkownikowi hasło, odznaczamy Enforce password policy (jeśli jest taka konieczność). W zakładce User Mapping przypisujemy mu rolę db_owner do naszej bazy danych.
- Odszukujemy plik appsettings.json w folderze, do którego wypakowaliśmy zawartość pobranego archiwum.
- Otwieramy plik w dowolnym edytorze tekstowym.
-
Zmieniamy dane dostępowe do bazy danych
z: "DefaultConnection": "Server=localhost\\sqlexpress;Database=BibliotekarzNET;Trusted_Connection=True;MultipleActiveResultSets=true"
na: "DefaultConnection": "Server=localhost\\sqlexpress;Database=BibliotekarzNET;User Id=sqlUser;Password=HASLO_NADANE_UZYTKOWNIKOWI_PRZEZ_WAS;MultipleActiveResultSets=true"
Wymiana certyfikatu SSL
Wraz z programem dołączony jest certyfikat dla domeny localhost. Oczywiście w przypadku udostępnienia aplikacji użytkownikom w Internecie lub w sieci lokalnej, należy użyć odpowiedniego certyfikatu, który będzie zaufany. Nazwę pliku z certyfikatem oraz hasło do klucza prywatnego można zmienić w pliku appsettings.json. Zaleca się aby aplikacja zawsze korzystała z protokołu HTTPS.
Domyślni użytkownicy systemu
Program jest dostarczony z 3ma domyślnymi użytkownikami systemu: admin@admin / czytelnik@czytelnik / bibliotekarz@bibliotekarz
Wszyscy Ci użytkownicy posiadają hasło: password Dla własnego bezpieczeństwa, konta te powinny być usunięte / hasła zmienione zanim aplikacja zostanie udostępniona innym użytkownikom. W przeciwnym razie bez wątpienia prędzej czy później ktoś niepowołany przejmie kontrolę nad systemem.
Artykuł ten będzie uaktualniany w miarę pojawiania się pytań od użytkowników, dotyczących uruchomienia programu.