konfiguracja w˛ezła

konfiguracja wezła
˛
INFORMACJE O DOKUMENCIE
tytuł
wersja
wersja oprogramowania
data
GICOMP - konfiguracja wezła
˛
2.0
GICOMP 1.0
26 września 2012
SPIS TREŚCI
Słownik poje˛ ć
3
Wstep
˛
O tym podreczniku
˛
. . . . .
Wymagania systemowe . .
Konfiguracja komputera . .
Przedstawienie środowiska
.
.
.
.
4
4
4
4
4
.
.
.
.
.
.
.
5
5
5
5
6
7
7
8
Obsługa programu
Właczanie
˛
i wyłaczanie
˛
programu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Pliki konfiguracyjne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Rejestrowanie zdarzeń . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10
10
10
11
Rozwiazywanie
˛
problemów
Instalator nie uruchamia sie˛ . . . . . . . . . . . .
Bład
˛ rejestracji . . . . . . . . . . . . . . . . . . .
Nieznany bład
˛ pojawia sie˛ na konsoli lub w logu
Komputer nie łaczy
˛
sie˛ z serwerem . . . . . . . .
.
.
.
.
11
11
11
12
12
Deinstalacja
Deinstalacja z Panelu sterowania . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Deinstalacja z wykorzystaniem pliku .msi . . . . . . . . . . . . . . . . . . . . . . . . .
Derejestracja manualna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13
13
14
14
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Instalacja
Plik instalatora . . . . . . . . . . . . .
Zmiany wprowadzane na komputerze
Metody instalacji . . . . . . . . . . . .
Parametry instalacji . . . . . . . . . .
Komponenty programu . . . . . . . . .
Przebieg instalacji cichej . . . . . . . .
Przebieg instalacji graficznej . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
SŁOWNIK POJE˛Ć
komputer zarzadzany,
˛
wezeł
˛
komputer, który ma być pod kontrola˛ oprogramowania GICOMP
(zarzadzanie
˛
stanem komputera, zbieranie statystyk)
gicomp-node, aplikacja wezła
˛
niewielka aplikacja instalowana na każdym z komputerów zarzadzanych
˛
PCSS Poznańskie Centrum Superkomputerowo-Sieciowe, twórca oprogramowania GICOMP
XMPP, Jabber protokół komunikacyjny wykorzystywany przez system GICOMP
JID identyfikator użytkownika protokołu XMPP, o obowiazuj
˛ acym
˛
formacie:
użytkownik@domena/zasób
3 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
WSTEP
˛
O TYM PODRECZNIKU
˛
Niniejszy podrecznik
˛
ma służyć jako pomoc osobie odpowiedzialnej za instalacje˛ oprogramowania GICOMP na maszynach zarzadzanych.
˛
Nie przewidziano podrecznika
˛
dla użytkowników
końcowych maszyn. Działanie aplikacji powinno być niewidoczne dla użytkownika, oprócz ostrzeżeń systemowych wyświetlanych przed wyłaczeniem
˛
komputera.
Podrecznik
˛
opisuje jedynie proces instalacji i konfiguracji programu gicompnode. Dostepne
˛
sa˛ osobne podreczniki
˛
opisujace
˛ instalacje˛ systemu GICOMP
oraz jego użytkowanie (webgui).
WYMAGANIA SYSTEMOWE
Przedstawione informacje dotycza˛ systemu Windows – do prawidłowego działania aplikacji
wymagana jest wersja XP, Vista lub 7. Proces instalacji na każdej z tych wersji jest identyczny.
Oprogramowanie GICOMP jest rozwijane dla innych systemów operacyjnych, ale na ten moment nie jest dostepne
˛
publicznie. Jeśli chcesz poznać aktualny stan prac skontaktuj sie˛ z
administratorem GICOMPa (adres e-mail umieszczono na końcu dokumentu).
KONFIGURACJA KOMPUTERA
Nie jest konieczne instalowanie żadnego dodatkowego oprogramowania na komputerze, na
którym ma być zainstalowany program GICOMP. Należy jednak zadbać o odpowiednie skonfigurowanie połaczenia
˛
sieciowego, gdyż konieczne jest połaczenie
˛
z serwerem.
Należy otworzyć wychodzacy
˛ port 5222 dla wszystkich pakietów oraz wchodzacy
˛ port 5222 dla
pakietów połaczonych
˛
(established), gdyż właśnie na nim odbywa sie˛ komunikacja. Połaczenie
˛
jest szyfrowane – GICOMP korzysta z protokołu TLS.
PRZEDSTAWIENIE ŚRODOWISKA
Środowisko GICOMP składa sie˛ z dwóch cz˛eści: oprogramowania instalowanego po stronie
klienta (gicomp-node) i serwera GICOMP.
Program gicomp-node musi być obecny na wszystkich maszynach zarzadzanych.
˛
Jest to
niewielka aplikacja, której instalacja zajmuje około dwóch minut. Instalacja jest opisana w tym
podreczniku.
˛
Aby wykorzystać opcje˛ Wake-on-LAN (GICOMP może przykładowo obudzić komputery, aby
umożliwić automatyczne aktualizacje programów) jedna z maszyn (waker) w sieci lokalnej musi
pozostać właczona.
˛
Poszczególne komponenty systemu GICOMP komunikuja˛ sie˛ ze soba˛ wykorzystujac
˛ protokół
XMPP (Jabber). Każdy z komponentów posiada własny konto jabberowe, identyfikowane przez
4 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
JID.
Elementem serwera, który bezpośrednio komunikuje sie˛ z wezłami
˛
jest serwis. Maszyny
zarzadzane
˛
musza˛ znać jego JID, aby komunikować sie˛ z serwerem.
Po pomyślnej instalacji i uruchomieniu oprogramowania dostep
˛ do wszystkich funkcji GICOMPa
uzyskuje sie˛ poprzez interfejs webowy (webgui). Można go używać w każdej przegladarce
˛
zaopatrzonej we wtyczk˛e Flash Player.
Jeśli korzystasz z serwera GICOMPa hostowanego przez PCSS, możesz skontaktować sie˛ z
nami w celu uzyskania JIDu serwisu, klucza serwera i adresu webgui.
INSTALACJA
PLIK INSTALATORA
Instalator jest dostepny
˛
jako plik .msi na stronie GICOMPa:
http://apps.man.poznan.pl/gicomp_web/download.html
Dla każdego dostepnego
˛
jezyka
˛
instalacji przygotowano odrebny
˛
plik. Jezyk
˛
instalacji nie ma
wpływu na jezyk
˛
wykorzystywany przez sama˛ aplikacje˛ – jest to jezyk
˛
angielski (wyłaczaj
˛
ac
˛
wykorzystywane komunikaty systemowe).
ZMIANY WPROWADZANE NA KOMPUTERZE
Instalacja gicomp-node składa sie˛ z trzech etapów:
• skopiowania plików programu do folderu wskazanego w procesie instalacji,
• zarejestrowania komputera na serwerze (jeśli taka opcja zostanie wybrana w instalatorze)
• uruchomienia aplikacji jako usługi systemowej, właczanej
˛
automatycznie po każdym włacze˛
niu komputera.
Podczas rejestracji na serwerze tworzone jest konto jabberowe, które umożliwia komunikacje˛
z komponentami GICOMPa. Jeśli konto zostało już wcześniej utworzone (na przykład przez
administratora systemu) nie ma potrzeby powtórnej rejestracji.
METODY INSTALACJI
Instalacja może być przyprowadzona z wykorzystaniem interfejsu graficznego albo w trybie
cichym (okienka nie bed
˛ a˛ wyświetlane).
Dla obu metod dostepne
˛
sa˛ te same parametry instalacji. W przypadku cichej instalacji parametry musza˛ zostać podane podczas uruchomienia:
msiexec /i gicomp.msi /l*v log.txt /quiet PARAM1=value1 PARAM2=value2
Program msiexec jest wykorzystywany do przeprowadzania instalacji z wykorzystaniem plików
.msi. Cicha instalacja jest wybierana poprzez przełacznik
˛
quiet. Ponieważ komunikaty o
błedach
˛
nie bed
˛ a˛ wyświetlane, konieczne może być właczenie
˛
logowania z wykorzystaniem
5 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
przełacznika
˛
/l*v nazwa-pliku. Dodatkowe wiadomości od GICOMPa sa˛ poprzedzone
oznaczeniem ---> Gicomp installer message:
PARAMETRY INSTALACJI
Poniżej zostana˛ przedstawione parametry, które można wykorzystać do dostosowania aplikacji
wezła.
˛
Obok nazwy pojawiajacej
˛ sie˛ w interfejsie użytkownika w nawiasie wpisana jest nazwa
parametru, który należy podać w wywołaniu w przypadku cichej instalacji. Jeśli dla parametru
nie opisano wartości domyślnej, jego podanie jest konieczne, w przeciwnym przypadku cicha
instalacja zakończy sie˛ niepowodzeniem.
Wartości parametrów nie powinny zawierać białych znaków i w wiekszości
˛
przypadków także
znaków specjalnych.
Nazwa użytkownika (USERJIDNAME) stanowi pierwsza˛ cz˛eść JIDu wezła.
˛
Domyślna˛ wartościa˛ jest nazwa sieciowa komputera (hostname). W nazwie użytkownika możliwe jest
wykorzystanie kropek, które oddzielaja˛ elementy hierarchii grup, do których należy wezeł.
˛
W˛ezły należace
˛ do jednej grupy moga˛ być później wspólnie zarzadzane
˛
w interfejsie
webowym (na przykład możliwe jest wyłaczenie
˛
wszystkich maszyn znajdujacych
˛
sie˛ w
danym pomieszczeniu). Najbardziej ogólna grupa powinna znajdować sie˛ na poczatku
˛
nazwy użytkownika, ostatni jej człon powinien odnosić sie˛ do konkretnego wezła,
˛
przykładowo:
departament2.pokoj23.adamnowak
Domena (USERJIDDOMAIN) druga cz˛eść JIDu wezła.
˛
W interfejsie graficznym pole nie jest
podpisane, miejsce na jego wpisanie znajduje sie˛ po symbolu @, gdyż JID przyjmuje
forme˛ użytkownik@domena/zasób (instalator sam uzupełnia zasób w pliku konfiguracyjnym). Domena jest zwykle zgodna z adresem URL serwera, jednak możliwe jest takie
skonfigurowanie serwera Jabbera, by korzystał z innej domeny lub kilku domen.
URL serwera (SERVERURL) adres serwera GICOMPa.
Klucz serwera (PRESENCEKEY) właściwy danemu serwerowi klucz konieczny do ustanowienia
komunikacji, powinien być dostarczony przez administratora systemu GICOMP.
Hasło (PASSWORD) hasło użytkownika dla konta jabberowego. Hasło powinno być możliwie długie i skomplikowane, nie bedzie
˛
konieczności wpisywania go przez użytkownika.
Domyślnie generowane jest hasło 10-literowe, złożone z dużych, małych liter i cyfr.
Potwierdź hasło w interfejsie graficznym konieczne jest powtórzenie hasła w celu unikniecia
˛
błedu
˛ (hasło jest wykropkowane). W przypadku cichej instalacji nie ma takiej konieczności.
Zarejestruj nowy wezeł
˛
na serwerze (REGISTER) rejestracja jest domyślnie przeprowadzana
w obu trybach. Aby jej nie wykonywać należy odznaczyć pole, a w przypadku cichej instalacji podać parametr o pustej wartości: REGISTER=""
JID serwisu (SERVICEJID) adres serwisu w postaci użytkownik@domena/zasób powinien
zostać dostarczony przez administratora systemu GICOMP. W przypadku podania adresu
w niepoprawnej formie cicha instalacja zakończy sie˛ błedem.
˛
Informacja o zużyciu energii przez komputer jest konieczna do przygotowywania statystyk,
wyświetlanych przez webgui. Wartości sa˛ podawane w watach, jako liczba z cz˛eścia˛ ułamkowa˛
oddzielona˛ kropka.
˛
6 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
Minimum (POWERMIN) minimalna wartość zużycia pradu
˛ przez komputer rozumiana jako
zużycie w przypadku właczonej
˛
(nie uśpionej) maszyny przy 0% obciażenia
˛
procesora.
Domyślna˛ wartościa˛ jest 98.
Maksimum (POWERMAX) maksymalna wartość zużycia pradu
˛ przez komputer rozumiana
jako zużycie w przypadku właczonej
˛
maszyny przy 100% obciażenia
˛
procesora. Domyślna˛
wartościa˛ jest 135.
Jeśli wartości parametrów podane zostana˛ w nieprawidłowym formacie albo wartość maksymalna jest mniejsza od minimalnej cicha instalacja nie powiedzie sie.
˛
KOMPONENTY PROGRAMU
Podczas instalacji możliwe jest wybranie komponentów aplikacji, które maja˛ zostać zainstalowane.
Program gicomp-node składa sie˛ z czterech komponentów.
Program pliki wykonywalne aplikacji, komponent jest konieczny dla działania programu.
Pliki konfiguracyjne ich obecność jest również konieczna dla uruchomienia aplikacji. Komponent nie musi być instalowany jeśli jest potrzeba zachowania w niezmienionej formie
plików konfiguracyjnych już obecnych w folderze instalacji. W przypadku, gdy pliki sa˛
obecne, a komponent zostanie zainstalowany, pliki nie zostana˛ całkowicie nadpisane,
dlatego możliwe jest zachowanie pewnych ustawień niestandardowych.
Usługa systemowa zainstalowanie tego komponentu pozwoli na automatyczne właczanie
˛
programu gicomp-node przy każdym starcie sytemu bez ingerencji użytkownika (jest to zalecana forma użytkowania programu). Jeśli komponent zostanie wybrany, usługa zostanie
uruchomiona już w trakcie instalacji (nie jest konieczne wykonanie restartu komputera).
Instrukcja użytkownika wybranie tej opcji zainstaluje niniejszy podrecznik
˛
w folderze instalacji. Nie jest on potrzebny użytkownikowi końcowemu w czasie normalnej pracy programu, może sie˛ okazać pomocny jedynie w celu zmiany konfiguracji lub deinstalacji
aplikacji.
PRZEBIEG INSTALACJI CICHEJ
W przypadku instalacji cichej domyślnie instalowane sa˛ pierwsze trzy komponenty (bez instrukcji użytkownika). Aby zainstalować wszystkie komponenty należy ustawić wartość 1000
dla zmiennej INSTALLLEVEL:
msiexec /i gicomp.msi /quiet
SERVERURL=gicomp.man.poznan.pl PRESENCEKEY=somekey1234
[email protected]/GicompService
INSTALLLEVEL=1000
Wybór poszczególnych komponentów jest możliwy poprzez zmienna˛ ADDLOCAL. W przykładzie
angielskie identyfikatory komponentów wystepuj
˛ a˛ w kolejności przedstawionej w podsekcji powyżej.
msiexec /i gicomp.msi /quiet
SERVERURL=gicomp.man.poznan.pl PRESENCEKEY=somekey1234
[email protected]/GicompService
ADDLOCAL=MainProgram,Configuration,WindowsService,UserManual
7 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
Program msiexec nie umieszcza na konsoli żadnych wiadomości nawet w przypadku, gdy instalacja zakończy sie˛ niepowodzeniem. Ewentualne problemy można sprawdzić w pliku logu
właczanym
˛
przez przełacznik
˛
/l*v nazwa-pliku.
W przypadku niepowodzenia rejestracji wezła
˛
w logu pojawi sie˛ wiadomość:
---> Gicomp installer message:
Registration failed.
Bład
˛ rejestracji opisany jest w sekcji Rozwiazywanie
˛
problemów. Wystapienie
˛
tego błedu
˛
nie przerywa procesu instalacji.
PRZEBIEG INSTALACJI GRAFICZNEJ
W tej podsekcji zostanie opisany przebieg instalacji wykorzystujacej
˛ graficzny interfejs użytkownika. W celu jej uruchomienia wystarczy dwukrotnie kliknać
˛ na plik instalatora.
Na poczatku
˛
konieczne jest zaakceptowanie licencji produktu GICOMP. Po zaznaczeniu pola
możliwe jest przejście do nastepnego
˛
kroku.
Rysunek 1: Akceptacja umowy licencyjnej.
Kolejne dwa ekrany umożliwiaja˛ uzupełnienie parametrów opisanych powyżej. W przypadku,
gdy format danych jest nieprawidłowy, instalator wyświetli okienko informujace
˛ na czym polega
bład.
˛
Niemożliwe jest przejście do kolejnego kroku bez podania danych w akceptowanym
formacie.
Nastepny
˛
ekran umożliwia wybór typu instalacji. Typ instalacji ma wpływ na to, jakie komponenty programu zostana˛ zainstalowane na komputerze.
Typowa instalowane sa˛ wszystkie komponenty oprócz instrukcji użytkownika.
Niestandardowa możliwe jest wybranie komponentów, które maja˛ zostać zainstalowane (Rysunek 5), a także zmiana ścieżki instalacji programu.
Pełna instalowane sa˛ wszystkie cztery komponenty.
Jeśli wybrano zarejestrowanie nowego wezła,
˛
ale rejestracja nie powiedzie sie,
˛ instalator wyświetli komunikat (otworzy nowe okno konsoli). Należy potwierdzić przeczytanie komunikatu wciskajac
˛ ENTER.
8 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
Rysunek 2: Dane połaczeniowe.
˛
Rysunek 3: Dane dotyczace
˛ zużycia energii.
Rysunek 4: Wybór typu instalacji.
Rysunek 5: Okienko instalacji niestandardowej.
Rysunek 6: Bład
˛ rejestracji.
Bład
˛ rejestracji opisany jest w sekcji Rozwiazywanie
˛
problemów. Wystapienie
˛
tego błedu
˛
nie przerywa procesu instalacji.
9 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
OBSŁUGA PROGRAMU
WŁACZANIE
˛
I WYŁACZANIE
˛
PROGRAMU
Jeśli gicomp-node został zainstalowany jako usługa systemowa użytkownik końcowy nie musi
podejmować żadnych działań. Program bedzie
˛
uruchamiany automatycznie po starcie systemu.
Aby sprawdzić czy usługa została zainstalowana i właczona
˛
należy przejść w Panelu sterowania do: Narz˛
edzia administracyjne\Usługi. W przypadku widoku kategorii ikona Narz˛
edzia
administracyjne jest dostepna
˛
w kategorii:
Wydajność i konserwacja – Windows XP
System i konserwacja – Windows Vista
System i zabezpieczenia – Windows 7
Rysunek 7: Okienko Usługi.
Za pomoca˛ tego okna możliwe jest właczanie
˛
i wyłaczanie
˛
usługi.
W przypadku recznego
˛
uruchamiania (bez wykorzystania usługi), należy przejść do folderu, w
którym program został zainstalowany i uruchomić plik:
smoa-dev-node.exe
Uruchomione okno konsoli nie powinno sie˛ samo wyłaczyć
˛
– świadczy to o wystapieniu
˛
błedu.
˛
Nie wszystkie komunikaty wypisywane sa˛ na konsole,
˛ cz˛eść trafia jedynie do pliku logu (podsekcja Rejestrowanie zdarzeń).
PLIKI KONFIGURACYJNE
Pliki konfiguracyjne gicomp-dev-node.xml i gicomp-dev-auth.xml znajduja˛ sie˛ w folderze instalacji w podkatalogu etc.
W pliku gicomp-dev-node.xml możliwa jest zmiana wszystkich ustawień ustawień uzupełnianych podczas procesu instalacji. W przypadku zmiany adresu serwisu należy go zmienić w
obu plikach, zachowujac
˛ format, w jakim jest wprowadzony.
Element Config/Handlers/Module/CanWakeUp w pliku gicomp-dev-node.xml zawiera
liste˛ wezłów
˛
(każdy ujety
˛ w osobnym tagu JID), które dany wezeł
˛
może wybudzać za pomoca˛
10 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
mechanizmu Wake-on-LAN. Domyślnie sa˛ to wszystkie wezły
˛
należace
˛ do tej samej domeny
(znak * oznacza dowolna˛ wartość).
Po wprowadzeniu zmian w plikach konfiguracyjnych konieczne jest ponowne uruchomienie programu.
REJESTROWANIE ZDARZEŃ
Domyślny rejestr zdarzeń gicomp-node znajduje sie˛ w folderze instalacji w podkatalogu etc w
pliku gicomp.log. Ścieżka do pliku jest konfigurowalna w pliku etc\gicom-dev-node.xml.
w tagu Config/Core/LogPath. Usuniecie
˛
tagu spowoduje, że w przypadku uruchomienia
manualnego wszystkie komunikaty bed
˛ a˛ wypisywane na konsoli.
Limit wielkości pliku logu wynosi 2MB. Po osiagni
˛ eciu
˛
tego rozmiaru tworzony jest nowy plik.
Nazwa poprzednich plików logu jest zmieniana (dodawana jest lub inkrementowana cyfra na
końcu nazwy). Maksymalnie może powstać sześć plików (w przypadku, gdy istnieje już plik z
cyfra˛ 5, zostanie on napisany przez przesuniecie
˛
zawartości z pliku z cyfra˛ 4).
ROZWIAZYWANIE
˛
PROBLEMÓW
Poniższa sekcja zawiera opis problemów, które moga˛ sie˛ pojawić podczas instalacji i użytkowania programu oraz potencjalne kroki zaradcze. Jeśli poniższa lista nie zawiera rozwiazania
˛
wystepuj
˛ acego
˛
problemu, prosimy o kontakt PCSS.
Ponieważ program działa domyślnie jako usługa systemowa, odkrycie źródła
problemu może być utrudnione. W celu wykrycia przyczyn błedu
˛
możliwe
jest uruchomienie programu w postaci konsolowej (podsekcja Właczanie
˛
i
wyłaczanie
˛
programu) lub odczytanie pliku logu (podsekcja Rejestrowanie
zdarzeń).
INSTALATOR NIE URUCHAMIA SIE˛
Obecna wersja programu GICOMP jest przeznaczona dla systemu Windows XP, Vista i 7. W
przypadku innego systemu operacyjnego instalator lub program może sie˛ nie uruchamiać lub
nie działać właściwie.
BŁAD
˛ REJESTRACJI
Przyczyne˛ błedu
˛
moga˛ stanowić:
• brak połaczenia
˛
internetowego,
• nieprawidłowo skonfigurowany firewall (podsekcja Konfiguracja komputera),
• nieprawidłowe dane do połaczenia
˛
z serwerem (bład
˛ w adresie serwera, identyfikatorze
serwisu),
• wybranie istniejacej
˛ w danej domenie nazwy użytkownika,
• bład
˛ serwera GICOMPa.
11 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
Informacje wypisywane przez program rejestrujacy
˛ moga˛ wskazać źródło problemu. W przypadku instalacji graficznej sa˛ one zawarte w komunikacie o błedzie.
˛
W przypadku instalacji
cichej sa˛ umieszczane w logu.
Bład
˛ rejestracji nie przerywa instalacji programu. Możliwe jest późniejsze reczne
˛
stworzenie konta jabberowego, na przykład przez administratora systemu GICOMP. Jeśli dane identyfikacyjne zmienia˛ sie˛ wystarczy poprawić pliki konfiguracyjne i zrestartować program (lub usługe).
˛
Nie jest konieczne przeinstalowanie aplikacji. Należy jednak pamietać,
˛
że bład
˛ rejestracji może świadczyć
o problemach z połaczeniem
˛
z serwerem, a bez prawidłowo skonfigurowanego
połaczenia
˛
aplikacja nie bedzie
˛
działać poprawnie.
NIEZNANY BŁAD
˛ POJAWIA SIE˛ NA KONSOLI LUB W LOGU
W przypadku pojawienia sie˛ błedu
˛ można spróbować uruchomienia programu jako administrator – zwykły użytkownik może na przykład nie posiadać praw zapisu do danego folderu.
Wiadomość zwiazana
˛
z błedem
˛
powinna dobrze opisywać przyczyne˛ problemu i zwykle pozwala
go rozwiazać.
˛
Jeśli to sie˛ nie powiedzie, prosimy o kontakt z PCSS i jeśli to możliwe załaczenie
˛
komunikatów wypisywanych przez program.
KOMPUTER NIE ŁACZY
˛
SIE˛ Z SERWEREM
Program może informować o błedzie
˛
połaczenia
˛
lub wezeł
˛
nie jest widoczny w interfejsie przegla˛
darki owym (webgui).
Prawdopodobne przyczyny błedu
˛
to:
• brak połaczenia
˛
internetowego,
• nieprawidłowo skonfigurowany firewall (podsekcja Konfiguracja komputera),
• nieprawidłowe dane do połaczenia
˛
z serwerem (bład
˛ w adresie serwera, identyfikatorze
serwisu),
• wezeł
˛
nie jest zarejestrowany na serwerze (rejestracja nie powiodła sie˛ lub nie została
przeprowadzona).
W przypadku wystapienia
˛
problemów zalecane jest sprawdzenie poprawności plików konfiguracyjnych (czy pliki nie sa˛ uszkodzone, czy zachowano prawidłowy format danych, czy dane
konieczne do połaczenia
˛
sa˛ poprawne).
Inna˛ możliwa˛ przyczyna˛ problemu jest bład
˛ serwera GICOMPa – w takim przypadku konieczny
jest kontakt z jego administratorem.
12 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
DEINSTALACJA
W procesie deinstalacji:
• usuwane sa˛ z systemu operacyjnego informacje o programie (w tym usuwana jest usługa
systemowa),
• przeprowadzana jest derejestracja wezła
˛
(opcjonalnie)
• usuwane sa˛ pliki programu i folder instalacji.
Derejestracja pozwala na zwolnienie zajmowanej w danej domenie nazwy użytkownika. Nie
jest jednak konieczna, w przypadku gdy planowana jest ponowna instalacja programu. Jeśli w
danym momencie derejestracja nie powiedzie sie,
˛ możliwe jest zachowanie plików koniecznych
do jej późniejszego przeprowadzenia.
Poniżej przedstawione sa˛ różne metody deinstalacji programu.
DEINSTALACJA Z PANELU STEROWANIA
Aby wyświetlić okienko przedstawiajace
˛ zainstalowane programy należy przejść do:
Panel sterowania\Programy\Odinstaluj program
lub:
Panel sterowania\Dodaj lub usuń programy
w przypadku Windowsa XP.
Podczas deinstalacji zostana˛ wyświetlone pytania (za pomoca˛ otwieranych okien konsoli). Na
pytania należy odpowiadać za pomoca˛ podanych liter (t dla tak i n dla nie) potwierdzanych
klawiszem ENTER.
Deinstalator zapyta, czy należy przeprowadzić derejestracje.
˛
Rysunek 8: Pytanie o derejestracje.
˛
W przypadku niepowodzenia derejestracji zostanie wyświetlony komunikat o błedzie.
˛
Jeśli
derejestracja nie zostanie przeprowadzona lub nie powiedzie sie,
˛ deinstalator zapyta, czy należy
pozostawić pliki potrzebne do późniejszego przeprowadzenia derejestracji (podsekcja Derejestracja manualna).
13 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
DEINSTALACJA Z WYKORZYSTANIEM PLIKU .MSI
W przypadku, gdy zachowany został plik instalatora, możliwe jest jego uruchomienie w trybie
graficznym (podwójne klikniecie
˛
na plik) lub cichym (uruchomienie z wiersza poleceń z podaniem odpowiednich parametrów).
W przypadku deinstalacji w trybie graficznym należy wybrać: Dalej\Usuń\Usuń. Późniejszy
proces jest identyczny jak w przypadku deinstalacji z Panelu sterowania.
Cicha deinstalacja może zostać wywołana poleceniem:
msiexec /x gicomp.msi /quiet /l*v log.txt UNREGISTER=1
UNREGISTER_FAIL_REMOVE=1
Domyślnie derejestracja nie jest wywoływana. Aby ja˛ właczyć
˛
należy w wywołaniu ustawić
wartość dla parametru UNREGISTER (tak jak podano w przykładowym wywołaniu). Aby w przypadku niepowodzenia pliki zwiazane
˛
z derejestracja˛ zostały usuniete
˛ należy ustawić wartość
również dla parametru UNREGISTER_FAIL_REMOVE. W przypadku niepowodzenia derejestracji informacja o błedzie
˛
w pliku logu.
DEREJESTRACJA MANUALNA
Po deinstalacji aplikacji manualna˛ derejestracje˛ można przeprowadzić właczaj
˛
ac
˛ program:
user-unregister.exe
dostepny
˛
w folderze instalacji. W przypadku powodzenia program usunie wszystkie pozostałe
pliki. Po wyłaczeniu
˛
możliwe jest usuniecie
˛
samego programu i folderu instalacji.
14 | Poznańskie Centrum Superkomputerowo-Sieciowe | GICOMP
W przypadku pytań prosimy o kontakt mailowy.
Adres administratora: [email protected]