1. Moduł Print Master

1. Moduł Print Master 1.1. Wprowadzenie Print Master (PM) to moduł, którego główną funkcją jest autoryzacja wydruków wykonywanych przez użytkownika w systemie Windows. Autoryzacja obejmuje wydruki wykonywane na drukarki lokalne i sieciowe oraz na drukarki objęte systemem Printoscope Terminal Server. Opcjonalną funkcją PM jest rozliczanie wydruków na projekty w systemie Printoscope Cost Control. 1.2. Instalacja Instalacja PM wymaga uprawnień administratora systemu operacyjnego. Instalacja PM może się odbyć na dwa sposoby. Pierwsza z nich to instalacja interaktywna, wymagająca udziału użytkownika. W czasie instalacji pojawiają się okna dialogowe, które zmieniają się dopiero po naciśnięciu przez użytkownika przycisku. Druga z instalacji, tzw. cicha, nie wymaga żadnej interakcji ze strony użytkownika. 1.2.1. Instalacja interaktywna Instalację interaktywną uruchamia się poprzez plik PMSetup.msi. Opcjonalnie plik można uruchomić z parametrem pdahost, w którym określa się adres serwera z modułem PDA Server, np. PMSetup.msi pdahost=155.158.252.234 Jeśli parametr pdahost nie zostanie podany, to instalator domyślnie przyjmie wartość localhost. W przypadku systemu Windows Vista należy pamiętać, aby plik PMSetup.msi uruchomić jako administrator (na pliku należy wywołać menu kontekstowe i wybrać opcję Uruchom jako administrator). W przypadku uruchomienia pliku z parametrem pdahost, należy stworzyć plik o rozszerzeniu bat i umieścić w nim polecenie msiexec z bezwględną ścieżką do pliku w drugim parametrze, np. msiexec /i c:\instalki\pmsetup.msi pdahost=155.158.252.234 Na instalację interaktywną składa się następujący ciąg okien dialogowych: 1

Rysunek 1. Instalator Print Mastera - okno powitalne Rysunek 2. Instalator Print Mastera - wybór katalogu docelowego 2

Rysunek 3. Instalator Print Mastera - potwierdzenie instalacji Rysunek 4. Instalator Print Mastera - pasek postępu instalacji 3

Rysunek 5. Instalator Print Mastera - okno końcowe instalacji zakończonej sukcesem 1.2.2. Instalacja cicha Instalacja cicha charakteryzuje się tym, że w trakcie nie pojawia się żadne okno dialogowe. Instalator wykonuje wszystko automatycznie przyjmując wartości domyślne. Aby wywołać cichą instalację PM, należy plik PMSetup.msi uruchomić z dodatkowym parametrem /q, np. PMSetup.msi /q pdahost=155.158.252.234 1.2.3. Zawartość katalogu Domyślnie PM zostaje zainstalowany w katalogu c:\program Files\Printoscope Print Master. W katalogu tym znajdują się następujące katalogi i pliki: katalog Agent Katalog z instalatorem modułu Printoscope Agent. katalog Jobs Katalog, w którym Print Monitor zapisuje wydruki i logi. Część wydruków i logów może znajdować się w podkatalogu Jobs katalogu C:\Documents and Settings\ %USERNAME%\Ustawienia lokalne\dane aplikacji\pmprintmonitor, gdzie %USERNAME% to nazwa użytkownika wykonującego wydruk. Dzieje się tak wówczas, gdy użytkownik wykonujący wydruk nie posiada uprawnień administratora systemu operacyjnego. katalog Logs 4

Katalog z logami (oprócz logów Print Monitora). Część logów może znajdować się w podkatalogu Logs katalogu C:\Documents and Settings\%USERNAME% \Ustawienia lokalne\dane aplikacji\pmprintmonitor, gdzie %USERNAME% to nazwa użytkownika wykonującego wydruk. Dzieje się tak wówczas, gdy użytkownik wykonujący wydruk nie posiada uprawnień administratora systemu operacyjnego. plik PMCPLApplet.cpl Plik wykonywalny apletu w Panelu Sterowania o nazwie Printoscope Print Master Ustawienia. plik PMCustAct.dll Program narzędziowy. plik PMHook.dll Program narzędziowy. plik PMPrintMonitor.dll Główna biblioteka Print Monitora. plik PMPrintMonitorUI.dll Biblioteka Print Monitora wymagana w systemach serwerowych. plik PMUIMod.dll Program narzędziowy. plik PMGUIDispatcher.exe Program narzędziowy. plik PMPrintMonitorInstall.exe Program narzędziowy. plik PMService.exe Plik wykonywalny usługi o nazwie PM Monitor Service. plik RepProc.exe Program narzędziowy. plik PrintMaster.ini Plik konfiguracyjny. 5

Pliki PMPrintMonitor.dll, PMPrintMonitorUI.dll, PMUIMod.dll, PMHook.dll, PMCPLApplet.cpl i PMPrintMonitorInstall.exe podczas instalacji zostają skopiowane do katalogu %WINDIR%\system32, natomiast plik PrintMaster.ini do katalogu %WINDIR%. Gdy użytkownik na oknie autoryzacji wybierze opcję Pamiętaj mnie, to wówczas w katalogu C:\Documents and Settings\%USERNAME%\Ustawienia lokalne\dane aplikacji\pmprintmonitor powstaje plik PrintMaster.ini z parametrami DefaultUserName i DefaultPassword, gdzie %USERNAME% to nazwa użytkownika wykonującego wydruk. 1.2.4. Operacje wykonywane podczas instalacji Podczas instalacji dodawany jest nowy typ portu o nazwie PMPrintMonitor. Drukarka w systemie operacyjnym, której zostanie ustawiony ten typ portu, stanie się drukarką objętą systemem Printoscope Terminal Server, co oznacza, że wydruki wykonane na tej drukarce po autoryzacji użytkownika trafią najpierw do centralnego serwera, a dopiero podczas sesji użytkownika na Print Terminalu zostaną wydrukowane na fizycznym urządzeniu. Podczas instalacji na potrzeby PM tworzony jest nowy użytkownik w systemie operacyjnym o nazwie PrintoscopeUser. Dzięki umieszczeniu tego użytkownika w gałęzi rejestru: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ Winlogon\SpecialAccounts\UserList pozostaje on niewidoczny na ekranie logowania do systemu Windows. W innej gałęzi rejestru: HKEY_LOCAL_MACHINE\SOFTWARE\Printoscope Print Master podczas instalacji powstają dwie wartości. Pierwsza z nich to InstallDir, określająca katalog, w którym został zainstalowany PM. Druga z nich to UniqueId, pozwalająca w jednoznaczny sposób zidentyfikować PM przez moduł PDA Server. Wartość UniqueId zostaje stworzona tylko wtedy, gdy nie istnieje (jeśli istnieje, to pozostaje bez zmian). 1.2.5. Log Log instalacji PM powstaje w katalogu C:\Documents and Settings\%USERNAME%\Ustawienia lokalne\dane aplikacji\pmprintmonitor, gdzie %USERNAME% to nazwa użytkownika zalogowanego w systemie operacyjnym, w którego sesji jest wykonywana instalacja PM. Plik logu nazywa się ppmsetup_log.txt. 1.2.6. Deinstalacja Aby odinstalować PM, należy uruchomić Start Panel Sterowania Dodaj lub usuń programy, a następnie odszukać na liście Printoscope Print Master i wybrać przycisk Usuń. 6

Rysunek 6. Wywołanie deinstalatora Print Mastera Jeśli w systemie operacyjnym będzie istniała co najmniej jedna drukarka z portem typu PMPrintMonitor, to wówczas PM nie zostanie całkowicie odinstalowany. Pozostaną wszystkie wymagane przez Print Monitor katalogi i pliki. Jeśli więc chcemy całkowicie usunąć PM z systemu, należy wcześniej zadbać o zwolnienie portów typu PMPrintMonitor przez drukarki. 1.3. Konfiguracja 1.3.1. Dodanie portu Aby dodać port typu PMPrintMonitor, należy uruchomić Start Ustawienia Drukarki i faksy. Następnie, wywołując menu kontekstowe, należy wybrać Właściwości serwera (Rysunek 7, Dodanie portu - właściwości serwera ). W wyniku otrzymamy okno, w którym na zakładce Porty znajduje się lista portów (Rysunek 9, Dodanie portu - lista portów ). Należy wówczas wybrać przycisk Dodaj port, a następnie na liście typów portów należy zaznaczyć PMPrintMonitor i wybrać przycisk Nowy port (Rysunek 10, Dodanie portu - lista typów portów ). W wyniku otrzymamy okno, w którym należy podać serwer i kolejkę, czyli parametry centralnego serwera wydruku (Rysunek 11, Dodanie portu - serwer i kolejka ). 7

Rysunek 7. Dodanie portu - właściwości serwera 8

Rysunek 8. Dodanie portu - właściwości serwera (Windows Vista) 9

Rysunek 9. Dodanie portu - lista portów Rysunek 10. Dodanie portu - lista typów portów Rysunek 11. Dodanie portu - serwer i kolejka 10

W wyniku dodania portu typu PMPrintMonitor, na liście portów pojawi się port, którego nazwa, nadawana automatycznie, składa się z następujących części: portn (gdzie N jest liczbą całkowitą), nazwy serwera i nazwy kolejki (poszczególne części oddzielone są średnikiem), np. port1;155.158.252.234;q_mp2000 Rysunek 12. Wynik dodania portu 1.3.2. Ustawienie portu drukarce Po dodaniu portu typu PMPrintMonitor, należy ustawić port wybranej drukarce zainstalowanej w systemie operacyjnym. W tym celu należy wywołać Właściwości drukarki (Rysunek 13, Ustawienie portu drukarce - właściwości drukarki ). W wyniku otrzymamy okno, w którym na zakładce Porty znajduje się lista portów. Należy wówczas odszukać port typu PMPrintMonitor i wybrać go dla drukarki (Rysunek 14, Ustawienie portu drukarce - wybór portu typu PMPrintMonitor ). W wyniku po każdym żądaniu wydruku na drukarce z portem typu PMPrint- Monitor, użytkownikowi pokaże się okno autoryzacji (Rysunek 15, Okno autoryzacji Print Mastera ). Dopiero po pomyślnym zalogowaniu się (podaniu nazwy użytkownika i hasła), wydruk zostanie "wydrukowany", tzn. trafi do centralnego serwera wydruku. 11

Rysunek 13. Ustawienie portu drukarce - właściwości drukarki 12

Rysunek 14. Ustawienie portu drukarce - wybór portu typu PMPrintMonitor Rysunek 15. Okno autoryzacji Print Mastera 13

1.3.3. Zmiana parametrów konfiguracyjnych Istnieje możliwość zmiany parametru pdahost podawanego podczas instalacji PM, określającego serwer z modułem PDA Server. W tym celu należy otworzyć do edycji plik PrintMaster.ini, znajdujący się w katalogu %WIN- DIR%, i odnaleźć w nim sekcję PDAServer z parametrem Host. Przy kolejnym żądaniu wydruku na drukarce z portem typu PMPrintMonitor, PM zwróci się do nowo skonfigurowanego serwera w celu autoryzacji użytkownika. 1.3.4. Zapamiętanie użytkownika i hasła Autoryzacja wymaga od użytkownika podania nazwy użytkownika i hasła. Dzieje się tak po każdym żądaniu wydruku na drukarce z portem typu PMPrintMonitor. Istnieje możliwość zapamiętania użytkownika i hasła. W tym celu na oknie autoryzacji znajduje się pole wyboru Pamiętaj mnie. Jeśli pole to zostanie zaznaczone i autoryzacja użytkownika po wybraniu przycisku OK zakończy się sukcesem, to przy kolejnym żądaniu wydruku na drukarce z portem typu PMPrintMonitor, pola Użytkownik i Hasło zostaną wypełnione zapamiętanymi danymi. Rysunek 16. Zapamiętanie użytkownika i hasła Nazwa użytkownika i hasło są zapamiętywane w pliku PrintMaster.ini w parametrach odpowiednio DefaultUserName i DefaultPassword. Plik ten z tymi dwoma parametrami znajduje się w katalogu C:\Documents and Settings\%USERNAME%\Ustawienia lokalne\dane aplikacji\pmprintmonitor, gdzie %USERNAME% to nazwa użytkownika wykonującego wydruk. 1.3.5. Autoryzacja poprzez bazę danych Printoscope Jeśli autoryzacja użytkownika odbywa się poprzez bazę danych Printoscope, tzn. nazwa i hasło użytkownika są zapisane w tej właśnie bazie, to przed wykonaniem pierwszego wydruku na drukarce z portem typu PMPrint- 14

Monitor, użytkownik musi wykonać kilka czynności. Na początku należy wywołać aplet Printoscope Print Master Ustawienia. W tym celu należy uruchomić Start Panel Sterowania Printoscope Print Master Ustawienia. Na ekranie pokaże się okno autoryzacji z dwoma dodatkowymi przyciskami. Rysunek 17. Okno autoryzacji Print Mastera - konfiguracja loginu i hasła Przycisk z zieloną zębatką służy do podania adresu email użytkownika (Rysunek 18, Okno do przesłania na podany adres email loginu i hasła ). Ważne, aby ten sam adres email istniał w systemie Printoscope Cost Control i został przypisany właściwemu użytkownikowi. Na podany adres email zostanie wysłana wiadomość, w której użytkownik otrzyma login i hasło (Rysunek 19, Wiadomość z loginem i hasłem ). Aby aktywować hasło, należy kliknąć w link znajdujący się w wiadomości. Rysunek 18. Okno do przesłania na podany adres email loginu i hasła 15

Rysunek 19. Wiadomość z loginem i hasłem Przycisk z czerwną zębatką służy do zmiany hasła. Aby użytkownikowi pokazało się okno, w którym należy podać nowe hasło, należy prawidłowo wypełnić pola Użytkownik i Hasło w oknie autoryzacji. Rysunek 20. Okno do zmiany hasła 1.4. Procedura drukowania Każde żądanie wydruku na drukarce z portem typu PMPrintMonitor spowoduje wyświetlenie na ekranie okna autoryzacji (Rysunek 21, Okno autoryzacji Print Mastera ). Jeśli system PDA został tak skonfigurowany, że także wydruki lokalne i sieciowe mają być autoryzowane, to okno autoryzacji pojawi się również z każdym żądaniem wydruku na drukarce lokalnej lub sieciowej. 16

Rysunek 21. Okno autoryzacji Print Mastera W momencie pokazania się okna autoryzacji, użytkownik proszony jest o podanie nazwy użytkownika i hasła, które pozwolą mu wykonać wydruk. Jeśli pola Użytkownik i Hasło zostaną wypełnione danymi, użytkownik powinien wybrać przycisk OK. Jeśli w danej chwili wystąpią problemy w połączeniu z serwerem PDA, to na oknie autoryzacji pojawi się stosowny komunikat (Rysunek 22, Błąd autoryzacji - brak połączenia z serwerm PDA ). Podobnie, gdy nazwa użytkownika lub hasło są nieprawidłowe (Rysunek 23, Błąd autoryzacji - nieprawidłowy login lub hasło ). 17

Rysunek 22. Błąd autoryzacji - brak połączenia z serwerm PDA Rysunek 23. Błąd autoryzacji - nieprawidłowy login lub hasło 18

Jeśli użytkownik nie uda się przejść procesu autoryzacji i wybierze przycisk Anuluj, wówczas wydruk zostanie skasowany, a na ekranie pokaże się następujący komunikat. Rysunek 24. Komunikat o skasowaniu wydruku w wyniku niepomyślnej autoryzacji W przypadku, gdy autoryzacja użytkownika zakończy się pomyślnie, to wówczas możliwe są dwa scenariusze. Pierwszy scenariusz zakłada, że użytkownik został przypisany do aktywnych projektów w systemie Printoscope Cost Control. Wtedy zanim wydruk zostanie wydrukowany użytkownik musi wykonać jeszcze jedną czynność, a mianowicie wybrać projekt, na który zostaną rozliczone koszty wydruku (Rysunek 25, Komunikat o konieczności wyboru projektu ). Możliwe jest także, aby koszty wydruku nie zostały rozliczone na żaden z projektów. Wówczas użytkownik na liście z projektami musi wybrać pozycję Brak (Rysunek 26, Wybór projektu z listy ). Drugi scenariusz to sytuacja, gdy użytkownik nie jest przypisany do żadnego aktywnego projektu w systemie Printoscope Cost Control. Wówczas po pomyślnej autoryzacji okno zostanie zamknięte, a wydruk zostanie wydrukowany. Rysunek 25. Komunikat o konieczności wyboru projektu 19

Rysunek 26. Wybór projektu z listy Zależnie od tego, jaka drukarka została wybrana przez użytkownika w celu wykonania wydruku, po takim czasie na ekranie pojawi się okno autoryzacji. Jeśli została wybrana drukarka z portem typu PMPrintMonitor, czas ten zależy od czasu, jaki bufor wydruku potrzebuje na zbuforowanie wydruku (zapis do pliku). W tym przypadku okno autoryzacji pojawi się dopiero wtedy, gdy status wydruku w kolejce drukarki zmieni się na Drukowanie (Rysunek 27, Stan kolejki i status wydruku przy wydruku na drukarce z portem typu PMPrintMonitor ). Jeśli system PDA został tak skonfigurowany, że także wydruki lokalne i sieciowe mają być autoryzowane, to przy wydruku na drukarę lokalną lub sieciową okno autoryzacji pojawi się natychmiast, zanim jeszcze w kolejce drukarki pojawi się wydruk (Rysunek 28, Stan kolejki przy wydruku na drukarce lokalnej lub sieciowej ). Dla wydruków lokalnych i sieciowych autoryzowanych przez system PDA charakterystyczne jest to, że ich nazwa w kolejce drukarki po pomyślnej autoryzacji wygląda inaczej niż przed autoryzacją. Do początkowej nazwy wydruku doklejane są trzy parametry: LoginPDA, ProjectID i CRC (Rysunek 29, Nazwa wydruku zmodyfikowana przez Print Mastera ). 20

Rysunek 27. Stan kolejki i status wydruku przy wydruku na drukarce z portem typu PMPrintMonitor 21

Rysunek 28. Stan kolejki przy wydruku na drukarce lokalnej lub sieciowej Rysunek 29. Nazwa wydruku zmodyfikowana przez Print Mastera 22