Wdrożenie programu Wyborny!

Wdrożenie programu Wyborny!
Wstęp
Program Wyborny powstał na potrzeby Urzędu Miejskiego w Wałbrzychu by wspomóc pracę tamtejszych
pracowników w wyborach powszechnych.
Z założenia był to program wielostanowiskowy i zintegrowany z systemem domenowym Microsoft Active Directory.
Program oparto o bezpłatną wersję bazy danych MS SQL, wersję Express. Jest to silnik aż nadto wystarczający do
sprawnej pracy programu nawet na wielu stanowiskach.
W obecnej wersji program potrafi pracować też bez AD autoryzując się logowaniem użytkownika SQL (SQL Server
Authentication).
Konfiguracja Serwera.
Program wyborny do pracy wymaga minimum serwera MS SQL w bezpłatnej wersji Express. Poprawnie pracuje
zarówno z wersją 2008 jak i 2012 i na tej ostatniej był tworzony i testowany.
Program z założenia jest wielostanowiskowy i by go dobrze wykorzystać należy zainstalować serwer SQL na
wielodostępnym komputerze - serwerze lub po prostu skorzystać z już istniejącej instancji serwera np. Programu
Płatnika.
W wersji, w której autoryzacja programu odbywa się poprzez grupy zabezpieczeń domeny AD, nie trzeba specjalnych
zabiegów konfiguracyjnych. Wystarczy za pomocą programu Microsoft SQL Server Management Studio założyć pustą
bazę danych o domyślnych parametrach. Np. o nazwie „Wyborny”
W przypadku kiedy chcemy autoryzować użytkowników za pomocą logowania do bazy danych MS SQL (SQL Server
Authentication) musimy zadbać o ich stworzenie i przydzielenie odpowiednich uprawnień w sekcji Security / Logins.
Instalacja bazy Ewidencji Ludności.
Przygotowania
Program wyborny do swojej pracy wymaga zainicjowania bazy ewidencji ludności.
Służy do tego załączony program LDB2PrzELUDek.
Program najlepiej uruchomić na serwerze na którym jest zainstalowany Serwer SQL.
Aby wczytać dane inicjacyjne potrzebne będą dwa zbiory danych.
1. Pierwszym z nich będzie zrzut całościowy Lokalnej Bazy Danych (LBD) w formacie 1B. Każda Ewidencja
Ludności generuje taki plik i zawiera on wszystkie potrzebne informacje z Ewidencji Ludności.
2. Drugim jest zbiór TERC.xml pobrany ze strony http://www.stat.gov.pl/broker/access/prefile/listPreFiles.jspa.
Paczka z programem zawiera ten plik, ale zawsze można go pobrać w najnowszej wersji.
Oba pliki musza znaleźć się w tym samym folderze (np. folderze „dane” – podrzędnym w stosunku do folderu
programu).
Inicjacja
Uruchamiamy program LDB2PrzELUDek i wykonujemy następujące czynności.
1. W pierwszym od góry okienku edycyjnym podajemy zbiór z danymi w formacie 1B wraz ze ścieżką dostępu
lub wybieramy go za pomocą okna dialogowego, które pojawi się po naciśnięciu ikony z prawej strony.
2. W następnym podajemy folder, w którym mają być składowane pliki csv lub wybieramy go za pomocą okna
dialogowego, które pojawi się po naciśnięciu ikony z prawej strony.
3. W następnym okienku podajemy ścieżkę do folderu z plikami z okna powyżej, ale z punktu widzenia
komputera – serwera, na którym jest zainstalowany serwer MS SQL.
Program wykorzystuje funkcje MS SQL bulk insert. Pozwala ona na bardzo szybkie wczytanie do serwera
nawet dużej ilości danych bezpośrednio z pliku csv.
Jeżeli uruchomiliśmy program LDB2PrzELUDek bezpośrednio na serwerze, na którym jest uruchomiony MS
SQL to można skopiować dane z okienka powyżej wykorzystując przycisk po prawej stronie.
4. Wpisujemy instancję serwera MSSQL wraz ze ścieżką
5. Zaznaczamy „ptaszka” przy opcji „Autoryzacja Windows” lub podajemy login i hasło do bazy.
6. Przyciskamy Test połączenia i jeżeli uzyskaliśmy komunikat informacyjny „Połączenie ustanowione
prawidłowo” możemy wybrać utworzoną wcześniej bazę danych z listy znajdujących się na serwerze.
7. Upewniamy się, że wszystkie opcje z prawej strony okna programu są zaznaczone i przyciskamy przycisk
„Wykonaj transfer danych”
Program wygeneruje tymczasowe zbiory csv z pliku LBD a następnie wczyta je do bazy danych tworząc odpowiednie
tabele.
W zależności od wielkości pliku LBD takie zasilenie bazy danymi z Ewidencji Ludności może trwać od kilkunastu
sekund do kilku minut. W przypadku danych z Wałbrzycha (niemal 290 tys. linii zbioru LBD) trwało to 80s
Po zakończonym transferze zamykamy program LDB2PrzELUDek. W pliku LDB2PrzELUDek.ini zostaną zapisane dane
konfiguracyjne na wypadek gdybyśmy chcieli ponowić zasilenie z aktualnymi danymi.
Operację tą można wykorzystywać wielokrotnie.
W przygotowaniu jest wersja programu, który można uruchomić wsadowo. Po wpisaniu w harmonogram zadań
serwera Windows 20xx Server wywołania programu z odpowiednim parametrem można będzie zautomatyzować
powyższe czynności.
Instalacja Wybornego!
Program dostarczany jest w paczce, którą należy rozpakować w wybranym miejscu na serwerze.
Paczka zawiera programy wykonywalne, pliki konfiguracyjne, wzorce wydruku oraz foldery ze skryptami SQL
wymaganymi do inicjalizacji programu.
Paczkę należy rozpakować na serwerze – tym samym co bazodanowy lub innym posiadającym rolę serwera plików.
Folder z programem udostępnić w sieci jako udział o nazwie „Wyborny” (adres \\Serwer_wybornego\Wyborny)
Konfiguracja do pracy z AD
Podłączenie do domeny – konfiguracja pliku wyborny.ini
Aby program poprawnie współpracował z domeną Active Directory należy ustawić odpowiednie zmienne w pliku
inicjalizacyjnym wyborny.ini znajdującym się w folderze z programem. Domyślna zawartość takiego pliku wygląda
następująco:
Odpowiednio zmieniamy wpis odpowiadający za „sDomena” oraz „sLDAPPatch” wprowadzając własne nazwy.
Uprawnienia – konfiguracja grup zabezpieczeń
Konfiguracja 4 grup zabezpieczeń dla programu Wyborny przedstawia się następująco:
1.
2.
3.
4.
PM.Wyborny – oznaczający zwykłego użytkownika z prawami do uruchamiania programu.
PM.Wyborny.ADM – oznaczający uprawnienia administratora
PM.Wyborny.EDT – oznaczający użytkownika z uprawnieniami do edycji (obecnie nie obsługiwana)
PM.Wyborny.PRN – oznaczający użytkownika z uprawnieniami do generowania wydruków.
Aby użytkownik mógł się korzystać z programu należy odpowiedni przypisać jego konto domenowe do tych grup.
Nazwy grup mogą być inne zgodnie z filozofią danego urzędu. Należy wówczas ich nazwy wpisać do pliku
wyborny.ini.
Automatyczne tworzenie skrótów na pulpicie użytkowników Wybornego
Aby automatycznie zainstalować każdemu użytkownikowi Wybornego ikonę skrótu na pulpit można użyć poniższego
skryptu. Wystarczy dodać go do innych skryptów uruchamianych w czasie logowania, w polityce GPO swojego
urzędu.
Należy tylko zmienić nazwę „Serwer_wybornego” na rzeczywistą nazwę serwera, na którym jest Wyborny wraz z
udostępnionym udziałem.
Set WybornyObjShell = CreateObject("Wscript.Shell")
Set objFSO = CreateObject("Scripting.FileSystemObject")
strDesktop = objShell.SpecialFolders("Desktop")
path = strDesktop & "\Wyborny.lnk"
If objFSO.FileExists(path) Then
If not isMember("PM.Wyborny") Then
Set aFile = objFSO.GetFile(path)
aFile.Delete
End If
End If
If not objFSO.FileExists(path) Then
If isMember("PM.Wyborny") Then
Set WybornyObjShortcut = WybornyObjShell.CreateShortcut(strDesktop & "\Wyborny.lnk")
WybornyObjShortcut.TargetPath = "\\Serwer_wybornego\Wyborny\wyborny.exe"
WybornyObjShortcut.WorkingDirectory = strDesktop
WybornyObjShortcut.Save
End If
End If
Praca bez AD.
Program pracuje również bez domeny AD, wówczas program działa w trybie administratora. Zaleca się wtedy
skonfigurować program do działania w trybie SQL Server Authentication i odpowiednio skonfigurować konta i
uprawnienia użytkowników w sekcji Security / Logins.
Pierwsze uruchomienie.
Jeżeli nie wpiszemy w plik wyborny.ini danych serwera i bazy danych program przy pierwszym uruchomieniu poprosi
o ich uzupełnienie:
Jeżeli nie skorzystamy z autoryzacji Windows zostaniemy dodatkowo poproszeni o podanie loginu i hasła do bazy
SQL.
Po udanym połączeniu z bazą danych program wykona szereg zapytań SQL tworzących odpowiednie obiekty w bazie
danych i uruchomi główne okno:
Pozostaje jeszcze ustawić dane gminy przez wywołanie polecenia „Preferencje”.
I można przejść do instrukcji pt. Zarządzanie bazą Obwodowych Komisji Wyborczych