IBM Notes Client Struktur - admincamp.de

1 IBM Notes Client verstehen und supporten (Understanding the IBM Notes Client structure) 21. September 2015, AdminCamp 2015 Alexander Novak, Tel.: +49 89 38 40 850 edcom Software & Consulting GmbH, Baierbrunner Stra e 39, 81379 M nchen / Seite 2 Agenda IBM Notes Client Aufbau Welche Dateien sind im Programm- und Datenverzeichnis Was sind features & plugins Erkl rung des Notes Standard Client Startprozesses Wo finde ich die Notes Eclipse Einstellungen (eclipse workspace) Notes Client Paketierung MSI/XML, Erweiterung/Austausch der Pakete ( Sametime) Notes Client Einstellungen Automatischer ODS Wechsel und Eclipse Workspace Neuerstellung Fehlersuche (Debugging, Logdateien) Seite 3 IBM Notes Client typen Seite 4 Notes clients Notes BASIC Client (properit r / C++ Basis) sa / basic (sollte nicht verwendet werden) > UseBasicNotes=1 Notes STANDARD Client / / / / Basiert auf Java-Technologie Eclipse V Framework (open Source, Platform unabh ngig)

2 Expeditor V Built-in Java IBM JRE V Seite 5 IBM Notes Client Aufbau Notes Programmdateien (PROG) Single Installation > Notes Datendateien (DATA) Single Installation DATA oder Netzlaufwerk Multi User Installation %UserProfile%\AppData\Local\Lotus\ Notes \ Data MUI - SharedDATA = ALLUSERS Profil (NTF, , HELP) Eclipse Pfade ..\Prog\Framework: Eclipse Binaries (Java) ..\Data\Workspace: Eclipse Userdaten, Plugins, Arbeitsbereich Seite 6 IBM Notes - Programmdateien Dateiname Funktion / Beschreibung Initialisiert alle Notes Prozesse & Services Nlnotes, ntaskldr, notes2, rcplauncher Notes Client Prozess startet Benutzer Password Dialog w hrend des Notes Initialisierungsprozesses background Notes Prozess Zust ndig f r Replikation, Volltext- & Ansichtsindizierung Eclipse/Expeditor Initialisierung (wird nach Initialisierung wieder beendet) Notes Standard Java Prozess (Eclipse/Expeditor) Expeditor Framework Startreihenfolge ENABLE_EARLY_AUTHENTICATION=1 ( Notes , , ) - Vorgabe ENABLE_EARLY_AUTHENTICATION=0 ( Notes , , ) & & kommunizieren via secure sockets Wenn die Kommunikation blockiert wird startet der Standard Client nicht ( via Permeo Software)

3 Notes + Preloader l scht inaktive Roaming user Daten "Lotus Notes Cleanup Service/Utility "Multi-User Cleanup Service Notes + Lotus Notes Smart Upgrade Service f r SURunAs (Smart Upgrade Super User Installation) Seite 7 IBM Notes Datenbanken/Dateien Datei L schen Was geht verloren? Wie neu erstellen? Lesezeichen, Startseite, History Automatisch (NTF) Workspace (Kacheln) Automatisch Client startet nicht Restore/Backup, Notes Roaming Client Setup ( ) Inhalte von RSS Feeds Automatisch (NTF) Roaming Daten (Plugins, Eclipse Einstellungen) Automatisch (NTF) Benutzerdaten (Abonnements) Automatisch (NTF) zeitgesteuerte Automatisch Client startet nicht Original zur ckspielen, oder Default ini und neu konfigurieren Benutzerdaten (Cache) Automatisch (NTF) Client startet nicht (ohne ID Vault) ID Vault holt die ID automatisch Seite 8 IBM Notes - Dateien Datei / Verzeichnis L schen Was geht verloren?

4 Wie neu erstellen? Notes Prog, JVM Client startet nicht, bzw. Features funktionieren nicht Reparatur oder Neuinstallation framework Client startet nicht, bzw. Features funktionieren nicht Reparatur oder Neuinstallation data\workspace\.config Runtime Daten und Eclipse Updates automatisch, Features m ssen neu installiert werden data\workspace\.metadata Benutzereinstellungen automatisch, aber Konfiguration muss neu gemacht werden data\workspace\applications selbstinstallierte Plugins m ssen neu installiert werden data\workspace\logs Log-Dateien automatisch Andere Funktion des clients evtl beeintr chtigt Neu- oder Reparaturinstallation Seite 9 IBM Notes Verzeichnisstruktur PROG Datei / Verzeichnis Funktion / Beschreibung \ Notes Core: DLLs, EXE und andere Ressourcen Dateien \jvm Java Virtual Machine (JVM) f r den Notes Client \license Produkt Lizenz Dateien (inkl. non_ibm_license) \icc DLL Dateien f r Crypto \xmlschemas Schemas zur Nutzung f r DXL (Domino XML) Validierung \xsp XPages JAR Dateien & Themes \mui Multi User Interface (MUI) f r verschieden Sprachen (enth lt Sprachen DLLs, EXE, etc) \framework\rcp\deploy\ Extras\ : Vorgabe RSS Feed Adressen kithistory\ Speichert aktualisierte install manifest Dateien.

5 : Notes security keystore : Provisioning manifest file \framework\rcp\ : Platform launcher executable : Beinhaltet Einstellungen f r den platform launcher : Command Line ISA log collector utility \framework\rcp\eclipse\ Plugins f r XPD Platform \framework\rcp\scripts\ Contains three debug level setting files for CAI \framework\rcp\shared\ Plugins f r shared applications (werden in der definiert) Seite 10 IBM Notes Verzeichnisstruktur DATA Datei / Verzeichnis Funktion / Beschreibung %UserProfile%\AppData\Local\ Lotus\ Notes \Data UserData Verzeichnis f r MUI (Multi User) Installation Notes MUI DataHome : Benutzer NTF: Schablonen f r MUI Notes Clien \Activities IBM Connections (Activities) Konfigurationsdatei \IBM_Technical_Support Diagnose Dateien (NSD) f r Abst rze, Protokolldateien ( ) \workspace\. \workspace\. Speichert die Prozessor ID (PID) des Notes Expeditor Prozesses ( ) \workspace\.config\ User Configuration Data Area : Benutzer Instanz der : Standard Properties Datei f r Eclipse Konfigurationen : Startreihenfolge der Ecplise Konfigurationen ( ) : Eclipse Core Runtime data : RCP launcher cache data : cache data of OSGI bundles that need to be loaded at Client launch : Eclipse Update manager data \workspace\.

6 Metadata\ User Instance Data Area .plugins\ - Speichert Benutzerdaten f r jedes Eclipse plugin \ \.settings = Eclipse Prefrence Store \applications\ Java Plugins die im Benutzercontext installiert wurden ( nachtr gliche XTAF Dictionaries) \logs\ : Notes Client Installationslog (Install/Update/Fixes) : Protokoll der feature Installationen (provisioning) : Eclipse/Expeditor Fehlermeldungen : Eclipse/Expeditor Protokollmeldungen (siehe f r Detaillevel) %AllUsers%\AppData\Local\ Lotus\ Notes \Data SharedData Verzeichnis f r MUI (Multi User) Installation : Vorgabe (wird beim Setup in das UserProfil bernommen NTF: Schablonen f r MUI Notes Client Seite 11 IBM Notes Java Startprozess ..\notesprog\framework\rcp\ 1 READ ..\framework\rcp\ CHECK ENTRY vs..\notesdata\workspace\.config\ READ ENTRY \:/${ }/rcp/ READ ENTRY ${ }/AppData/Local/Lotus/ Notes /Data/workspa ce READ ENTRY ${ }/rcp/eclipse/ <version> 2 READ.)

7 \framework\rcp\deploy\ 3 READ ..\notesdata\workspace\.config\ LOGGING: ..\notesdata\workspace\logs\ & START ..\notesprog\framework\rcp\eclipse\plugi ns\ <version>\win32\x86\ Seite 12 IBM Notes Standard - Aufbau ..\notesprog\framework\rcp\ IBM Quelle Expeditor Dokumentation Enth lt Informationen (properties) welche bei dem Ecplise/Expeditor Start f r globale Aktionen verwendet werden & Wert ist identisch ${ }/.. \:/${ }/rcp/ ${ }/../jvm/bin/ * ${ }/AppData/Local/Lotus/ Notes /Data/workspa ce ${ }/rcp/eclipse/ <version> branding Eistellungen Seite 13 IBM Notes Standard - Aufbau Notesdata\workspace\.config\ IBM Quelle Expeditor Dokumentation bernahme der Einstellungen aus der Bei Abweichung des Eintrages (Binary Zeitwert des Installationszeitpunktes) erfolgt ein Expeditor Client Update ..\workspace\.config ..\workspace\.configbak Aktivierung/Erh hung des Expeditor Debugging ( Sametime, etc) !

8 !! Probleme bei Citrix Farmen sollte in allen Notes Installationen gleich sein (zeitintensiver Expeditor Client Update) Seite 14 IBM Notes Standard - Aufbau Notesprog\framework\deploy\ IBM Quelle Expeditor Dokumentation Enth lt Konfigurationen (properties) welche bei dem Ecplise/Expeditor Start f r die Java Umgebung (JVM) verwendet werden (max. execution memory) (min. startup memory) (increasing block size memory) :name= ,controlDir=${ },groupAccess,keep,singleJVM,nonfatal ${ }/. ;jvm/bin/j9vm Seite 15 IBM Notes Standard Aufbau Notesdata\workspace\.config\ IBM Quelle Expeditor Dokumentation Parameter f r Expeditor OSGI start Notesprog\framework\rcp\ IBM Quelle Expeditor Dokumentation Vorgabewerte f r Expeditor Einstellungen/Anwendungen (Managed Settings) Notesprog\framework\deploy\ Verf gbare Eclipse Plugins/Features aus der Notes Standard Installation Evtl. sind Verweise fehlerhaft (Netzwerkinstallation, doppelte Eintr ge) Seite 16 IBM Notes Standard - Aufbau Application Management Zeigt alle installierten Features & Plugins Aktivierung, Deaktivierung und Deinstallation m glich notesdata\workspace\.

9 Config\ \ Beispiel <feature id=" " url=" " version=" "> </feature> Im Unterverzeichnis History werden Sicherungen anhand des config date angelegt Seite 17 IBM Notes Standard Aufbau Notesdata\workspace\.metadata\.plugins\* IBM Notes Eclipse Einstellungen ( Sametime, Widgets, etc.) .\workspace\.metadata\.plugins\ \.settings\*.prefs Eclipse Plugins Reference Area = Plugin basierte Einstellungen Seite 18 IBM Notes Standard Aufbau Wie finde ich ein IBM Notes Eclipse Setting? Einstellung an einem IBM Notes Client ndern und im Verzeichnis ..\ \settings\ die ge nderte PREFS Datei genauer begutachten Seite 19 Eclipse Settings Vorgabeparameter verteilen Methoden der Verteilung von Eclipse/ST Einstellungen Notes Desktop Policy (Vorgabe / ENFORCE) (Vorgabe) XML Providerfile (Vorgabe / ENFORCE) Community_ Empfehlung = XML Providerfile oder Policy Methods to configure ST Connect Client 8 user preferences Seite 20 Eclipse Settings Notes Desktop Policy Notes Desktop Policy erstellen / Managed settings pluginID/preferenceID=preferenceValue pluginID = Java Klasse preferenceID = Parameter preferenceValue = Wert Seite 21 Eclipse Settings XML Fileprovider Zuweisung des XML Fileprovider via Domino Policy ://c:/ Sametime Policy XML Aufbau <ManagedSettings> <!

10 Aufbau eines XML Fileprovider Datei f r Eclipse Vorgaben > <settingGroup name= pluginID lastModDate= 20150921T120000Z > <setting name="preferenceID" value="preferenceValue" isLocked="true/false overwriteUnlocked= true /> </settingGroup> </ManagedSettings> Seite 22 IBM Notes + Preloader L dt Teile der Notes API und Subsysteme, Teile der Java JVM und einige wichtige Notes Datenbanken vorab in den Arbeitsspeicher (w hrend OS Anmeldung) um den Notes Client Start zu beschleunigen des Users muss existieren (Multi User) IBM Notes + Preloader Start Ruft den Prozess NotesInit auf, welcher low level Notes DLLs und Dateien l dt Liest Benutzer Datenbank aus ( , , & ) L dt einige Java JVM DLLs Debug : DEBUGGINGWCTENABLED=16386 in die Virus EXCLUDE Liste aufnehmen !!! (Quelle IBM) Understanding Lotus Notes preloader Seite 23 IBM Notes Standard Eclipse Features/Plugins .. UpdateSite\ Homepage f r Ecplise Features/Plugins.