Sterownik aplikacji Lotus Notes

Sterownik Lotus Notes* umożliwia synchronizacje danych w drzewie NDS z danymi przechowywanymi w Domino* Directory lub innej bazie danych Notes. Sterownik dla Notes wymaga oprogramowania Notes w wersji R5 lub nowszej.

Sterownik Notes jest obsługiwany tylko w NDS eDirectory dla Windows NT/2000. Nie jest obsługiwany w NetWare® i w UNIX*.


Konfiguracja serwera Notes

Niniejszy rozdział zawiera informacje dotyczące konfiguracji serwera Notes Domino, który będzie współdziałał ze sterownikiem Notes. Przed rozpoczęciem konfiguracji należy zapoznać się z administracją i zastosowaniem serwera Lotus Notes Domino.

Sterownik Notes musi być zainstalowany na komputerze, na którym znajduje się serwer NDS i docelowy serwer Notes. Jest tak, gdyż API Notes wymagają, aby sterownik zarejestrował obiekty użytkowników NDS jako użytkowników Notes po dokonaniu ich migracji do Domino Directory. W systemie docelowym musi być też zainstalowany klient Notes, gdyż interfejsy API Java* używane przez sterownik Notes są zależne od działającego klienta.

  1. Skopiuj następujące pliki z DirXML CD do określonego miejsca lub upewnij się, czy instalator DirXML zainstalował już te pliki w bieżącej lokalizacji.

    Plik Opis Miejsce docelowe

    COMMONDRIVERSHIM.JAR

    Zapewnia funkcjonalność sterownika. Rozszerzeniem tego sterownika jest plik NotesDriver.jar.

    Katalog .\LIB w drzewie podrzędnym serwera NDS eDirectory.

    NOTESDRIVERSHIM.JAR

    Wykorzystuje funkcjonalność Notes do subskrybowania zmian z NDS i publikowania zmian Notes w NDS

    Katalog .\LIB w drzewie podrzędnym serwera NDS eDirectory.

    NOTES.JAR

    Ogólnie dostępny plik firmy Lotus. Możesz użyć pliku dostarczonego w tej wersji lub pliku z nowszej wersji z katalogu LOTUS\DOMINO.

    Katalog .\LIB w drzewie podrzędnym serwera NDS eDirectory.

    NDSREP.EXE

    Dodatek do serwera Notes dla uzyskania obsługi replikacji baz danych pomiędzy Lotus Notes i NDS. (program NDSREP kontroluje liczniki czasu serwera Notes, aby określić czas sprawdzania zmian w katalogu wejściowym; NDSREP odczytuje zmiany, określa reprezentowany przez nie typ zdarzeń i filtruje aktualizacje w oparciu o obiekty i atrybuty określone w filtrze wydawcy w ramach konfiguracji sterownika w NDS;

    działanie programu NDREP.EXE jest uzależnione od bibliotek DLL w katalogach LOTUS\DOMINO oraz LOTUS\NOTES). Należy dodać następujące katalogi:

    \LOUTS\DOMINO.

    Instalator DirXMl nie wykrywa obecności i lokalizacji serwera Notes. Konieczne będzie skopiowanie tego pliku ręcznie.

    IMPORT.XML

    Określa podstawowy plik konfiguracyjny dla sterownika Notes. Jest on używany w ConsoleOne przez kreatora tworzenia sterownika aplikacji do tworzenia obiektów i reguł dla podstawowej konfiguracji sterownika Notes.

    \NOVELL\CONSOLEONE\SNAPINS\DIRXML

  2. Upewnij się czy NLSXBE.DLL (plik Notes DLL) znajduje się na wspólnej ścieżce w środowisku.

    NLSXBE.DLL znajduje się w katalogu LOTUS\NOTES. Po dodaniu katalogu NOTES do ścieżki systemowej, ponownie uruchom komputer, w celu zapisania zmiany w ścieżce.

  3. Utwórz identyfikator użytkownika Notes, który będzie wykorzystywane wyłącznie przez sterownik Notes, oraz wprowadź wszystkie uprawnienia administracyjne dla docelowej bazy danych Notes (zwykle NAMES.NSF).

  4. Zmodyfikuj reguły umieszczania, aby odzwierciedlały ścieżki zawartości w katalogach NDS i Notes. Przykładowe reguły umieszczania odzwierciedlające następujące struktury:

    \DIRXML-NDS\Provo\Notes
    \DIRXML-NDS\Provo\Groups

    Przykładową domeną Notes jest o=Provo. Przykładowa nazwa domeny to cn=Joe User/o=Provo.

  5. Postępuj zgodnie z instrukcjami zawartymi w Konfiguracja i obsługa NDSREP.

  6. Postępuj zgodnie z instrukcjami zawartymi w Konfiguracja sterownika Notes.


Konfiguracja i obsługa NDSREP

NDSREP.EXE jest dodatkowym procesem serwera Notes, który wdraża replikacje bazy danych pomiędzy Lotus Notes i NDS. (program NDSREP kontroluje liczniki czasu serwera Notes, aby określić czas sprawdzania zmian w katalogu wejściowym; Następnie odczytuje zmiany, określa typ zdarzenia, jaki reprezentuje zmiana, i filtruje aktualizacje oparte na obiektach oraz atrybuty określone w filtrze wydawcy, w konfiguracji sterownika NDS.

działanie programu NDREP.EXE jest uzależnione od bibliotek DLL w katalogach LOTUS\DOMINO oraz LOTUS\NOTES). Należy dodać te katalogi do ścieżki.

  1. Skopiuj NDSREP.EXE z katalogu DIRXML\DRIVERS\LOTUSNOTES\BIN na DirXML CD do \LOTUS\DOMINO.

  2. Uruchom plik NDSREG.EXE, aby ustawić następujące opcje konfiguracyjne dla NDSREP.EXE.

    Opcja Opis

    Harmonogram replikacji

    Określa częstość sprawdzania aktualizacji wejściowej bazy danych przez NDSREP.

    Format DN

    Określa format nazw domen publikowanych przez NDSREP. Reguły tworzone przez plik importu kreatora dla sterownika Notes (IMPORT.XML) oczekują ukośnika. Jeśli nie planujesz ponownego zapisu tych reguł w innym formacie, ustaw wartość w tym polu na SLASH.

    Wykrywanie pętli

    Uaktywnia filtrowanie przez NDSREP aktualizacji w bazie danych Notes dokonywanych przez NotesDriverShim. Aby uaktywnić wykrywanie pętli, wprowadź nazwę domeny Notes dla ID użytkownika używanego przez NotesDriverShim przy łączeniu się z serwerem Notes.

    Wejściowa baza danych

    Określa nazwę bazy danych Notes, którą NotesDriverShim będzie synchronizować z NDS. Może ona zostać zdefiniowana bez pełnej ścieżki dostępu. Ta nazwa pliku musi być zgodna z polem Wejściowa baza danych w oknie Parametry sterownika (dla sterownika Notes) w ConsoleOne.

    Wejściowa BD = Notes Directory

    Określa, czy wejściowa baza danych jest prywatną czy publiczną książką adresową.

    Wyjściowa baza danych

    Określa nazwę bazy danych Notes, którą NDSREP utworzy i użyje do publikowania filtrowanych aktualizacji wykorzystywanych przez NotesDriverShim. Ta nazwa pliku musi być zgodna z polem Wyjściowa baza danych w oknie Parametry sterownika (dla sterownika Notes) w ConsoleOne.

    Filtr wydawcy

    Określa nazwę pliku, który będzie zawierał filtr wydawcy określony dka kanału publikowania sterownika Notes. Plik ten tworzony jest przy uruchamianiu NotesDriverShim. Ta nazwa pliku musi być zgodna z polem Filtr wydawcy w oknie Parametry sterownika (dla sterownika Notes) w ConsoleOne.

  3. Załaduj NDSREP.EXE do konsoli serwera Notes.

    Dodaj NDSREP do instrukcji TASKS= w pliku NOTES.INI w katalogu LOTUS\DOMINO lub wpisz LOAD NDSREP w oknie konsoli serwera Notes.

  4. Do sterowania programem NDSREP służą następujące polecenia TELL na konsoli serwera Notes:

    Polecenie TELL Opis

    Replicate (Replikacja)

    Powoduje, iż NDSREP natychmiast rozpoczyna proces replikacji, w oparciu o przechowany datownik poprzedniej replikacji.

    Migrate (Migracja)

    Powoduje, iż NDSREP natychmiast rozpoczyna proces replikacji, w oparciu o przechowany datownik 0. Wynikiem tego jest migracja wszystkich obiektów katalogu Domino, które pasują do filtra przechowanego w NDS.

    Suspend (Wstrzymanie)

    Powoduje, iż NDSREP ignoruje wyzwalacze datownika, które rozpoczynają replikację.

    Resume (Wznowienie)

    Powoduje, iż NDSREP powraca do przetwarzania zdarzeń datownika i replikacji.

    SchVal wartość

    Powoduje, iż NDSREP zmienia interwał datownika pomiędzy zdarzeniami repliakcji. Wartość zostaje zmieniona zarówno w procesie wewnętrznym jak i rejestrze systemowym.

    SchUnits jednostka

    Powoduje, iż NDSREP zmienia jednostki czasowe stosowane w parametrze TimeVal, ustawionym w procesie NDSREP. Wartości jednostek czasowych są ustawione zarówno wewnętrznie jaki i w rejestrze systemowym.

    LoopDetect zał/wył

    Włącza lub wyłącza kod NDSREP, w celu określenia czy aktualizowany rekord reprezentuje potwierdzenie zmiany, dokonanej przez Domino VrD. Właściwość LoopDetectID należy ustawić przed włączeniem funkcji LoopDetect.

    LoopDetectID dn

    Ustawia ID, które zostanie wyszukane przez kod wykrywania pętli, we właściwości $UpdatedBy, w rekordzie nagłówka. Dana właściwość powinna zostać ustawiona w identyfikatorze Notes, używanym przez Domino VrD, podczas aktualizacji katalogu Domino.

    ShowConfig (Pokaż konfigurację)

    Powoduje, iż ustawienia konfiguracyjne NDSREP pojawiają się w oknie konsoli.

    ShowFilter (Pokaż filtr)

    Powoduje, iż pojawia się filtr używany przez NDSREP do filtrowania aktualizowanych rekordów, przekazywanych do wydawcy.

    RefreshConfig (Odśwież konfigurację)

    Powoduje, iż NDSREP odświeża informacje dotyczące konfiguracji z rejestru Windows.

    SaveConfig (Zapisz konfigurację)

    Powoduje, iż NDSREP zachowuje bieżącą konfigurację w rejestrze Windows.

    OutputDB ścieżka

    Powoduje, iż NDSREP zmienia wyjściową bazę danych, do której zapisuje aktualizacje katalogów dla katalogu Domino.

    InputDB ścieżka pliku

    Ustawia w pełni kwalifikowaną nazwę ścieżki pliku .NSF, używaną przez NDSREP w celu uzyskania dostępu do katalogu Domino. Zwykle jest to \LOTUS\DOMINO\DATA\NAMES.NSF.

    FilterFile ścieżka pliku

    Ustawia w pełni kwalifikowaną nazwę ścieżki do pliku .XML, określając filtr wydawcy, używany do filtrowania aktualizacji katalogu.

    RefreshRate wartość

    Powiadamia NDSREP, jak często powinien odświeżać informacje dotyczące konfiguracji z rejestru Windows. Umożliwia to programowi VrD zapis aktualizacji konfiguracji NDS w rejestrze Windows i automatyczne odzyskiwanie danych i ponowną konfigurację NDSREP. Wartość zawsze podana jest w minutach.

    AutoRefresh zał/wył

    Włącza lub wyłącza funkcję AutoRefresh. Funkcja AutoRefresh powoduje, iż NDSREP odświeża informacje dotyczące konfiguracji z rejestru Windows, tak, jak jest to określone w poleceniu RefreshRate.


Konfiguracja sterownika Notes

W ConsoleOne użyj kreatora tworzenia sterownika aplikacji w celu wykonania następujących operacji konfiguracyjnych i administracyjnych w odniesieniu do sterownika Notes:

  1. W ConsoleOne kliknij Kreatorzy > Utwórz nowy sterownik aplikacji.

  2. Kliknij W nowym zestawie sterowników > kliknij Dalej > wprowadź nazwę nowego zestawu sterowników > wybierz kontekst i obiekt serwera, który będzie obiektem głównym dla zestawu sterowników DirXML > kliknij Dalej.

    lub

    Kliknij W istniejącym zestawie sterowników > wybierz sterownik, który ma zostać użyty > kliknij Dalej.

  3. Kliknij Import prekonfigurowanego sterownika.

  4. Wybierz plik konfiguracyjny IMPORT.XML sterownika Lotus Notes znajdujący się w katalogu NOVELL\CONSOLEONE\1.2\SNAPINS\DIRXML.

  5. Kliknij Dalej > postępuj zgodnie z instrukcjami.

    Podczas przetwarzania pliku importu kreator będzie monitować o wprowadzenie następujących danych:

    • Nazwa serwera Notes, z którym ma nastąpić powiązanie sterownika. Powinna ona zostać podana w formacie DN (bez typu) Notes. Informacje te znajdują się na pasku tytułu okna serwera Notes.
    • Nazwa domeny Notes dla ID użytkownika Notes, której ma używać sterownik przy łączeniu się z serwerem Notes. Użytkownik ten musi posiadać uprawnienia administracyjne zarówno względem wejściowej, jak i wyjściowej bazy danych. Zaleca się utworzenie tego ID specjalnie pod kątem sterownika i przeznaczenie go do wykorzystania tylko przez sterownik.
    • Nazwa domeny Notes. Będzie wykorzystywana w odniesieniu do reguły umieszczania publikacji do określania miejsca pochodzenia użytkowników Notes i miejsca docelowego w NDS dla tych użytkowników. Zmodyfikuj obiekt reguły umieszczania w obiekcie wydawcy sterownika Notes (w NDS), aby dostosować ją do własnych potrzeb.
    • Katalog w NDS, w którym znajdować się będą użytkownicy Notes.
    • Katalog w NDS, w którym znajdować się będą grupy Notes.
    • Ścieżka i nazwa pliku SERVER.ID serwera Notes.
    • Ścieżka i nazwa pliku USER.ID serwera Notes.
    • Ścieżka i nazwa pliku pliku CERTIFIER.ID Notes dla wystawcy certyfikatów wykorzystywanego przez sterownik do certyfikowania użytkowników.
    • Hasło dla pliku CERTIFIER.ID.
    • Nazwa docelowej bazy danych Notes. Nazwa ta odpowiada wejściowej bazie danych Notes zdefiniowanej w NDSREG.EXE.
    • Jeśli docelową bazą Notes jest Notes Directory (nazwa publiczna lub prywatna oraz książka adresowa), wpisz Tak. Jeśli nie, wpisz Nie.
    • Nazwa docelowej bazy danych aktualizacji. Odpowiada ona wyjściowej bazie danych Notes zdefiniowanej w NDSREG.EXE. Jest ona tworzona przez NDSREP przy jego uruchamianiu.
    • Wprowadź Nie w oknie dialogowym Powiąż zdalnie. Będzie to obsługiwane w następnej wersji.
    • Jeśli chcesz certyfikować użytkowników Notes przy dodawaniu, wpisz Tak w oknie dialogowym Certyfikuj użytkowników Notes. Jeśli nie, wpisz Nie.
    • Wprowadź ścieżkę i nazwę pliku, gdzie sterownik Notes będzie przechowywał identyfikatory Notes.
    • Wprowadź ścieżkę i nazwę pliku dla pliku CERTLOG.NSF Notes.
    • Wprowadź Tak aby funkcja aktualizacji książki adresowej uaktualniała książkę adresową Notes przy certyfikowaniu.
    • Wprowadź Tak aby zapisać identyfikatory Notes w książce adresowej Notes.
    • Jeśli serwer znajduje się w Ameryce Północnej, wpisz Tak w oknie dialogowym Serwer północnoamerykański.
    • Wprowadź wartość określającą okres (w latach) ważności nowych ID.
    • Wprowadź domyślne hasło Notes przypisywane nowo certyfikowanym użytkownikom.
    • Wprowadź ścieżkę i nazwę pliku dla pliku wyjściowego wydawcy. Zawiera on filtr wydawcy dla sterownika. Powinien być zgodny z danymi wprowadzonymi w NDSREG.EXE.
    • Wprowadź częstosć odpytywania w ms. Parametr ten określa częstość, z jaką sterownik sprawdza bazę danych aktualizacji pod kątem zmian.

  6. Po zakończeniu importu kliknij Tak, aby zdefiniować równoważnik zabezpieczeń dla importowanego sterownika.

    1. Kliknij Dodaj > wybierz obiekt z uprawnieniami administratora (lub innymi uprawnieniami, które chcesz przypisać do sterownika).

    2. Kliknij Zastosuj > Zamknij.

  7. Kliknij Zakończ.


Definiowanie hasła sterownika

  1. W ConsoleOne kliknij prawym przyciskem myszy obiekt sterownika Notes.

  2. Kliknij Właściwości > karta Konfiguracja sterownika DirXML.<

  3. Kliknij Uwierzytelnienie.

  4. W polu Hasło aplikacji wprowadź hasło sterownika Notes.

  5. Kliknij Zastosuj > OK.


Uruchamianie sterownika Notes

  1. W ConsoleOne kliknij prawym przyciskiem myszy obiekt zestawu sterowników DirXML sterownika Notes.

  2. Kliknij Właściwości > karta DirXML-Sterowniki.

  3. Wybierz sterownik Notes > kliknij Start.

  4. Kliknij OK.


Uwagi o bazie danych

Mimo, iż sterownik Notes jest sterownikiem synchronizacji katalogu dla katalogu Notes, jest możliwe aby skonfigurować sterownik, w celu wykorzystania bazy danych Notes innej niż NAMES.NSF. W tym przypadku, należy upewnić się czy reguła mapowania schematu jest odpowiednia dla schematu docelowej bazy danych. Patrz Formularz versus typ , aby uzyskać więcej informacji na ten temat.


Format CN

Najodpowiedniejszy format danych w CN dla Lotus Notes to <firstname> <lastname>. Można go osiągnąć, poprzez utworzenie reguły Transformacji wyjściowej, która łączy w sobie Podaną nazwę i Nazwisko w CN. Można również utworzyć <imię> <nazwisko> format CN w katalogu NDS.

Patrz Tworzenie i dodawanie arkuszy stylów w celu uzyskania szczegółowych informacji na temat reguł Transformacji wyjściowej.


Formularz versus typ

W książce nazw i adresów Notes każdy dokument posiada pola Typ i Formularz. Pole Typ obsługuje serwer LDAP Notes zapewniając nazwę klasy. Pole Formularz jest standardowym polem dokumentu Notes, które wskazuje który formularz ma zostać użyty do wyświetlenia dokumentu. Element formularza nie jest wymagany i jeśli nie występuje, klient Notes użyje formularza domyślnego.

DiRXML nie umożliwia mapowania pojedynczego atrybutu DS do wielokrotnych atrybutów aplikacji docelowej. Oznacza to, że reguła mapowania schematu nie może zostać wykorzystana do mapowania klasy obiektu na formularz lub typ. Aby temu zaradzić, ekran konfiguracji sterownika w ConsoleOne zawiera pole, które zapytuje, czy baza danych katalogu na pewno jest katalogiem Notes. Jeśli tak, nazwa klasy w DSEntry (przemieszczona do przestrzeni nazwy Notes) jest używana jako wartość dla typu.

Atrybut klasa-obiekt w obiekcie DSAttribute może zostać wykorzystany do aktualizacji elementu formularza, jeśli został określony w regule mapowania schematu. Umożliwia to ustawienie obu atrybutów i zapewnienie mapowania umożliwiającego zróżnicowanie wartości typu i formularza. Jeśli reguła mapowania schematu zawiera mapowanie pomiędzy atrybutem NDS i formularzem, konieczne jest przemieszczenie zawartości atrybutu NDS. Jest to możliwe przy pomocy reguły przekształcenia wyjściowego. Reguła przekształcenia wejściowego jest z kolei stosowana w celu translacji zawartości z obszaru nazw Notes do obszaru nazw NDS.

Jeśli źródłem katalogu nie jest katalog Notes, żaden element typu nie zostanie zapisany przez sterownik Notes. Zamiast tego atrybut nazwy klasy zostanie zapisany do elementu formularza. Jeśli element formularza pojawi się w filtrze, zostanie zignorowany przez sterownik Notes i NDSREP.

Jeśli sterownik Notes jest skonfigurowany przy użyciu katalogu Notes, przemieszczone wartości nazwy klasy zostaną zapisane w elemencie typu, w bazie danych Notes, a formularz zostanie zawarty w regułach mapowania schematu. Jeśli sterownik Notes jest skonfigurowany przy użyciu bazy danych Notes innej niż katalog, przemieszczone wartości nazwy klasy zostaną zapisane w elemencie formularza, w bazie danych Notes, a formularz nie zostanie zawarty w regułach mapowania schematu.


Mapowanie schematu

Przykładowa reguła mapowania schematu Notes, dostępna wraz ze sterownikiem na DirXML CD (DIRXML\DRIVERS\LOTUSNOTES\RULES\SCHEMAMAP.XML) jest przeznaczona dla katalogu Notes. Jeśli sterownik jest skonfigurowany w bazie danych Notes innej niż Nazwy i Książka adresowa, należy stosownie skorygować regułę mapowania schematu.

Kolejnym problemem dotyczącym mapowania schematu Notes, o istnieniu którego należy wiedzieć, jest sposób w jaki Notes zarządza CN i DN w katalogu. Patrz Przenieś/Zmień nazwę , aby uzyskać więcej informacji na ten temat.


Przenieś/Zmień nazwę

Funkcje Przenieś i Zmień nazwę działają w kanale subskrybenta dla nie zarejestrowanych użytkowników. W Notes, element Pełnej nazwy jest najbliższym ekwiwalentem nazwy domeny (DN) w NDS. Tak więc, należy zachować ostrożność przy mapowaniu do tego elementu. Kiedy flaga katalogu jest ustawiona, sterownik Notes i NDSREP wyjątkowo zarządzają elementem Pełnej nazwy, tak aby współpracowała z zagadnieniami zarządzania DN i CN.

Ze względu na sposób, w jaki program Notes zarządza CN i DN w pełnej nazwie nie jest możliwe rozróżnienie funkcji Przenieś i Zmień nazwę w NDSREP. Kiedy NDSREP określa, iż element Pełnej nazwy uległ zmianie, generuje zarówno Przenieś jak i Zmień nazwę.