populating your domino directory or any domino database with tivoli directory integrator
DESCRIPTION
TRANSCRIPT
![Page 1: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/1.jpg)
Populating Your Domino Directory (Or ANY Domino Database)
With Tivoli Directory Integrator
Marie Scott
Thomas “Duffbert” Duff
![Page 2: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/2.jpg)
• Introduction to TDI architecture/concepts
• Discuss TDI entitlement
• Examples
• Resources
Agenda
![Page 3: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/3.jpg)
IBM Tivoli Directory Integrator:
“Tivoli Directory Integrator (TDI) is a graphical integration toolkit
for accessing and detecting changes in practically any type of
system, data store, protocol, or API. It also lets you transform,
filter, and validate this data before driving it to the output targets
of your choosing.”
Source: Redpaper IBM Lotus Domino Integration Using IBM
Tivoli Directory Integrator
● Use for migration of data between IBM Lotus® Domino® and other data
sources
● Use for integration of data and directories between Domino and other
data sources, such as Microsoft® Active Directory®
● Use for synchronization of data and directories
![Page 4: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/4.jpg)
Remember to think “outside the box”
● TDI works with these IBM/Lotus products
– IBM Lotus Domino
– IBM Lotus Sametime®
– IBM Lotus Quickr®
– IBM Connections®
– IBM LotusLive™
● So don't let the “directory integrator” fool you into thinking this tool is
only for directories! It's NOT!
![Page 5: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/5.jpg)
TDI Architecture
![Page 6: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/6.jpg)
What Will TDI Connect To?
![Page 7: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/7.jpg)
TDI Definitions and Concepts: Part 1
● AssemblyLine – just like a factory assembly line!
─ TDI uses AssemblyLine to push, pull, move, transform or sync data
─ Can have multiple AssemblyLines running at same time
● Data Source – data system or group of data objects
● Connector – Device used to connect Data Sources to AssemblyLine
─ Set up authentication
─ Set up attribute mapping
─ Connect to services like LDAP, AD, JDBC, Domino
─ Batch or event-driven
─ You can write your own!
![Page 8: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/8.jpg)
TDI Definitions and Concepts: Part 2
● Entries – Data Sources contain entries or records
● Attributes – Each entry contains attributes or fields
● Work Entry – is the entry that is manipulated by the AssemblyLine
● Conn Entry – is the local work store for each connector
● Attribute Map – links the data movement between the Conn Entry and
the Work Entry for each Connector
![Page 9: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/9.jpg)
TDI Definitions and Concepts: Part 3
● Connector Modes
─ Iterator mode: iterate thru each entry, reads values of attributes,
provides values of attributes to Assembly Line
─ Lookup mode: used to join data from different sources
─ AddOnly mode: add new data entries to a data source
─ Update mode:add or modify data in a data source
─ Delete mode: delete data from a data source
─ Delta mode: used to track incremental modifications to connected
system
![Page 10: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/10.jpg)
TDI Definitions and Concepts: Part 4
• Link Criteria
• Used to tell a connector in Update, Lookup or
Delete mode how to define a match between
attributes so that they can perform work.
• Hooks
• Built-in “waypoints” in the AssemblyLine that
allow you to add scripts to extend your
processes to add logging or parsing
• Example: Hook: Before Execute
• You could add some JavaScript to do
parsing or write a message to the log
![Page 11: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/11.jpg)
A few things we hope you’ll learn in this session….
• TDI is FREE*
*As long as Domino is included in your AssemblyLine, it may only be valid for
directory work, your mileage may vary…
![Page 12: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/12.jpg)
12
Is TDI still “FREE, FREE, FREE”?
● Sort of...
● Entitled to use TDI if either the data source or data target involves
Domino.
● Prior to Domino 8.5.2, this applied to both directories AND data.
● As of Domino 8.5.2, IBM changed this for directories only, but there
is still confusion on the wording and IBM is still working on this.
● For Active Directory/Domino synchronization, the answer is still “TDI
is FREE, FREE, FREE”
● For data migration/synchronization/integration, we're still not sure.
![Page 13: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/13.jpg)
TDI Downloads
● C1IF0ML (Microsoft® Windows® x86-32)
● C1IF1ML (Windows x86-64)
● C1IF2ML (IBM AIX®)
● C1IF3ML (Linux x86-32)
● C1IF4ML (Linux x86-64)
● C1IF5ML (Linux zSeries)
● C1IF7ML (Oracle® Solaris® SPARC™)
![Page 14: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/14.jpg)
Finding TDI on IBM Passport Advantage
1. Select your Domino
software type
2. Next screen – be sure to
select the Download
options – “If available
would you like to see
associated products
included at no additional
charge.”
3. Expand the “Associated
products included at no
additional charge”
selection
4. Choose the version of TDI
you’d like to download
![Page 15: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/15.jpg)
TDI isn’t only for directories….
• TDI connects to many systems:
Domino, Lotus Connections, LDAP, Active Directory,
JDBC, RDBMS, HTTP/Rest, Oracle, PeopleSoft, SAP,
etc., etc.
Connectors are the building blocks of your AssemblyLine
TDI is a tool you’ll want to start using!
![Page 16: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/16.jpg)
Possibilities
• Domino Directory - need to update from corporate LDAP directory (or
Active Directory)
• Domino Directory - need to update from Corporate HR directory
• Domino app - need to keep synched with Oracle database
• Domino app - need to update with xml file downloaded from app each
night on schedule
• Domino Directory - need to update IBM Connections
• Domino Directory - need to update LotusLive
• Other uses with Notes databases (we think developers might like)
Connect to SQL db (or other relational db) to update Domino web
page or database (scheduled or event driven)
Notes db to Notes db (one time event)
SAP or Peoplesoft connectors
Output Notes to XML with data scrubbing
![Page 17: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/17.jpg)
Installing TDI
• TDI 7.0 and 6.1 currently supported versions
• We’re going to cover 7.0 in our slides
• Let’s get started!
![Page 18: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/18.jpg)
Use the install_tdiv70_win_x86.exe instead of
launchpad.exe... It works better
Starting the install…
![Page 19: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/19.jpg)
If you want to have console start at bootup...
This would be useful if you were installing this on a server and wanted
TDI to start up automatically on server startup.
![Page 20: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/20.jpg)
You might see this…
This seems to be quite common on install, even when I think I have
everything “cleaned up”. So long as you're not upgrading, you can ignore it.
![Page 21: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/21.jpg)
Choose your install directory...
This is my default directory when installing onto a Microsoft Windows 7
platform on my laptop
![Page 22: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/22.jpg)
Installing everything (disk space is cheap!)
A true server installation would leave out Javadocs, examples, and
IEHS. I'm installing here so that I have access to everything locally.
![Page 23: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/23.jpg)
Choose your solutions directory...
You will have a chance to change this when you start up TDI.
Your Assembly Lines and jobs will be stored in this directory.
![Page 24: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/24.jpg)
Select the embedded console...
Again, choosing this for local installation and no existing ISC anywhere.
![Page 25: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/25.jpg)
Taking the default ports for TDI...
![Page 26: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/26.jpg)
If all goes well, you're good to go!
Since we're going directly into testing to see if TDI starts up,
the Start the Configuration Editor option can remain selected.
![Page 27: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/27.jpg)
Starting up TDI & selecting solution directory
This is where you can change your solution directory, aka the “Workspace”.
This can be useful if you want to have separate workspaces for different
customers or jobs.
![Page 28: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/28.jpg)
And we're there!
If all goes well, this is the screen we'll first see. Once you select the Go
to Workbench option, you'll open up to that screen when you start up in
subsequent sessions.
![Page 29: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/29.jpg)
Job #1 after install... install fix packs!
http://www.ibm.com/support/fixcentral/
As I learned, admins get really peeved if you don't
do this. Fix Central is very easy to navigate, and
should be a “must visit” site for the IBM software
that you run and maintain.
![Page 30: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/30.jpg)
And to connect to Domino...
In order to connect to IBM Lotus Domino with TDI, you
will need to copy the Notes.jar file from your IBM Lotus
Notes installation...
![Page 31: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/31.jpg)
Into the TDI directory...
… into the TDI installation under /IBM/TDI/V7.0/jars/3rdparty/IBM. Without
this, you'll get Java errors when trying to connect.
![Page 32: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/32.jpg)
Example – CSV to Notes
• In this scenario, we’re going to demonstrate the creation of
an Assembly Line that imports data from a CSV file into a
Notes database
![Page 33: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/33.jpg)
To begin...
You have a comma-separated values (.csv) file with data that you want to
get into a Notes database.
Truly nothing fancy here... four fields in a .csv file, four fields in the
Notes database.
![Page 34: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/34.jpg)
Creating the Project for our job...
Create a Project to store our AssemblyLine
(File > New > Project), name it
TDIBookListProject, and we'll see that
Project created in the Navigator tab.
![Page 35: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/35.jpg)
Creating the AssemblyLine...
Now we create the AssemblyLine
(File > New > AssemblyLine), name
it TDIAssemblyLine, and it appears
in the Navigation tab under our
Project.
![Page 36: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/36.jpg)
First job is to build the Feed Connector...
In our AssemblyLine, we'll create our first feed
component that will allow us to read our .csv file.
Click the Add component button...
![Page 37: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/37.jpg)
Choose the File System Connector...
Choose the File System
Connector in the
Iterator mode. That
connects to any
external file and reads it
line by line.
![Page 38: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/38.jpg)
Get the actual location of the file...
Choose the location of the .csv file that you'll be reading in...
![Page 39: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/39.jpg)
The next option selects the parser...
Next, choose the type of Parser that
will be needed to read the file. Since
we're reading a .csv file, I'll choose the
CSV Parser...
![Page 40: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/40.jpg)
Make sure the parser is configured...
You may have to configure the parser. In this case, I needed to change the
Field Separator from ; to , to make it conform to my file.
![Page 41: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/41.jpg)
The Feed Connector is now configured...
The File System Connector is now complete, set to iterate through the file
and parsing the lines via the comma separator.
![Page 42: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/42.jpg)
Test your connection to the file...
Cool feature... test your connection by clicking the Connect button. It will use the first
line of the .csv file for field names, and will walk through your file line by line.
![Page 43: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/43.jpg)
Now, we'll configure the Data Flow Connector...
Next, configure the Data Flow
connector using the Lotus Notes
Connector in AddOnly Mode since
we'll be writing out data to that data
connector.
![Page 44: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/44.jpg)
Configuration of the Lotus Notes Connector...
For this example, we'll use a LocalClient session, enter the password of our
Notes ID, and choose the database we'll be connecting to...
![Page 45: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/45.jpg)
And if that connection works...
And if our Lotus Notes Connector is configured correctly, we should see a message
in the Problems box that says we connected to the Domino Sever, which means
our local client.
![Page 46: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/46.jpg)
Get the fields from the File Connector...
Back in our File
Connector, we'll click the
Add button under
Mappings to select the
fields we'll be reading...
![Page 47: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/47.jpg)
And here's how the configuration looks...
And when finished, it should look like this on the File System Connector page...
![Page 48: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/48.jpg)
Select the fields from the Notes Connection...
Then, we choose what fields we'll map to in the Lotus Notes Connector...
![Page 49: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/49.jpg)
And now we have the other end configured...
And like before, the finished configuration should look like this...
![Page 50: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/50.jpg)
And now we can run it!
All that's left is to run it. On the console, you'll see the parser config, the
connection to Domino, the iteration through the file, and the printing of
statistics... All in less than two seconds...
![Page 51: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/51.jpg)
And we look at our Notes database output...
![Page 52: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/52.jpg)
Intro to TDI and Directories
• Directory related connectors
• LDAP configuration related details
• Only need to update corporate data?
Use an LDAP connector
Easy to set up, attributes easy to customize
Doesn’t provision Notes accounts
![Page 53: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/53.jpg)
TDI is fantastic for working with directories…
• Connectors already included for Directory work:
LDAP Connector:
Use to connect to LDAP directories (including AD & Domino)
Domino Change Detection Connector
Detects changes on objects in a Notes database (add, modify,
delete). Includes actions on the names.nsf.
Active Directory Change Detection Connector
Detects changes on AD objects.
Domino Users Connector
Use when you want to create, delete or modify Notes user
information (in names.nsf or admin4.nsf). Can be used to
create or delete Notes accounts.
![Page 54: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/54.jpg)
54
• Know your LDAP schema (or work with your LDAP team).
• You'll need the following:
• LDAP userid that can read and/or write to the LDAP directory.
• Organizational Unit
• OrgClass
• Another invaluable tool is Softerra's LDAP Browser (FREE!)
• http://www.softerra.com/download.htm
• If you considering an assembly line to create Lotus Notes accounts:
• LDAP connection will not create full Notes users
• Use Lotus Domino Users Connector in order to provision new accounts
Details for LDAP Connections
![Page 55: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/55.jpg)
Why should you care about LDAP or AD details?
• Search Base – use the O or OU level qualifier for what you want to
search for. If you only need to run the AssemblyLine for an OU rather
than O qualifier, don't use the O qualifier – extra overhead.
• Search Filter – use a search filter so that you don't get objects you
don't want (especially if your LDAP or AD contains many customized
objects). The more specific the search filter, the fewer “junk” items
you'll retrieve.
• Credentials - sure you are logging in with credentials that has access
to all O's or OU's and containers, so the AssemblyLine can process
the work and run successfully.
![Page 56: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/56.jpg)
56
A little Domino LDAP config check:
• Confirm that domain configuration document has the following set on the LDAP tab.
• You can control security via Security settings and/or XACL.
![Page 57: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/57.jpg)
57
Domino LDAP Schema
• Domino LDAP Schema is stored in the schema.nsf
• Review classes and attributes to see how Domino might be using them and what type of data is stored (string, domain name, etc.)
![Page 58: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/58.jpg)
58
Create Domino LDAP Connector
• Create a connector for Domino – using base LDAP Connector
• Create in Iterator Mode
![Page 59: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/59.jpg)
59
Configure the Domino LDAP Connector
• Add the specifics for your Domino LDAP connection (Connector Tab)
![Page 60: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/60.jpg)
60
Browsing LDAP data: How & Why
• Click the Connect button. Once you’ve established a connection you can begin to browse your data.
• Review each record by clicking Next to review the data in each attribute.
• This allows you to determine if you need to make any editing changes when performing an update or data match.
• You'll also see what attributes are available in the schema.
![Page 61: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/61.jpg)
61
Browsing Domino Directory Data
![Page 62: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/62.jpg)
Example: Active Directory to Domino Sync
• Create an assembly line(s) to do the following:
Connect to Active Directory
Connect to Domino names.nsf
Detect any additional users created for Active Directory and create them in Domino names.nsf
Detect any changes to information in Active Directory and update in Domino names.nsf (but don't change internet address)
Detect any accounts deleted from Active Directory and delete in Domino (via admin4.nsf)
Detect any changes in Domino and update to Active Directory.
Detect any deletes in Domino and update to Active Directory.
• Going to use IF and ELSE IF Branches
• And some javascripting for good measure!
![Page 63: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/63.jpg)
So how are we going to do all that?
• Create a project
• Create “template” connectors
• Create a new AssemblyLine
• Create Feed connector based on template connector
• Create IF ELSE logic
![Page 64: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/64.jpg)
Create a new TDI Project
![Page 65: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/65.jpg)
Create your Connector “templates”
• Create the connectors you will use throughout the Assembly line
• ADChanges – based on ActiveDirectoryChangeDetector
• DominoUsers – based on DominoUsersConnector
![Page 66: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/66.jpg)
Create Connector: ADChanges
• Use Active Directory Change Detection Connector template
• Use Iterator mode
![Page 67: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/67.jpg)
Connector Config: ADChanges
• See LDAP search base
• LastChangeInAD parm
• Inherits from ADChangelog connector template
![Page 68: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/68.jpg)
Create Connector: DominoUsers
• Uses DominoUserConnector template
• Set up in Iterator Mode
![Page 69: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/69.jpg)
Connector Config: DominoUsers
• Detects changes to users
• Uses local client connection
![Page 70: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/70.jpg)
Notes client configuration
• Change the following security property to allow for DominoUsers connection without prompt
![Page 71: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/71.jpg)
AssemblyLine next...
• Setup AssemblyLine with data feed and data flow
• Will map attributes that will match between AD and Domino
• Will set up any exception processes
• Create scripts or IF/Else/IF/ElseIF logic
![Page 72: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/72.jpg)
Create AssemblyLine: SyncAD_to_Domino
• Let's create our AssemblyLine
![Page 73: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/73.jpg)
Create Data Feed Connector:ADChanges
• Create Connector based on ADChanges and include all work attributes
![Page 74: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/74.jpg)
Connector Config: ADChanges
• See LDAP search base
• LastChangeInAD parm
• Inherits from ADChangelog connector template
![Page 75: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/75.jpg)
Add IF BRANCH - delete
![Page 76: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/76.jpg)
Create IF-delete script
![Page 77: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/77.jpg)
Add ELSE Branch – add or modify
![Page 78: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/78.jpg)
Create Connector: DeleteDomino
• Use the DominoUsers connector as your template
![Page 79: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/79.jpg)
Create DeleteDomino Link Criteria
• Create the link criteria to match objects between AD & Domino
![Page 80: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/80.jpg)
Create UpdateDomino Connector
• Created based on DominoUsers connector
• Created in update mode
![Page 81: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/81.jpg)
Create UpdateDomino Link Criteria
![Page 82: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/82.jpg)
UpdateDomino Mapping
• Essential “working engine” of the AssemblyLine
• Includes JavaScript to modify the field data
![Page 83: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/83.jpg)
Create BeforeModify Script
![Page 84: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/84.jpg)
Create BeforeModify Script
• Not updating internetaddress object
![Page 85: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/85.jpg)
Let’s start the assembly line!
• Click Run to start SyncAD_to_Domino
• Confirm that the process is “Iterating”
![Page 86: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/86.jpg)
SyncAD_to_Domino Final AssemblyLine
![Page 87: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/87.jpg)
Provisioning Notes Accounts
• You can take this type of AssemblyLines and build a process to
provision Notes accounts.
• See this document for more information regarding the specific objects
you need to pass to adminp to set up accounts.
http://www.tdi-
users.org/twiki/pub/Integrator/HowTo/IntegratingDominowithTDIv1.1.pdf
![Page 88: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/88.jpg)
Additional Resources
• IBM Tivoli Directory Integrator Users Group - http://www.tdi-users.org
• Consultant in Your Pocket Webcasts: TDI Admin Perspective & TDI Developer
Perspective
http://consultantinyourpocket.com/ciyp/ciyp.nsf/
• Domino Integration Specific Info: http://sites.google.com/site/dominointegration
• IBM DeveloperWorks – Tivoli - https://www.ibm.com/developerworks/tivoli/
• TDI User Forum - http://groups.google.com/group/ibm.software.network.directory-
integrator/topics?gvc=2
• Learning TDI - http://www.tdi-users.org/twiki/bin/view/Integrator/LearningTDI
• Domino Integration with TDI - http://www.tdi-users.org/twiki/bin/view/Integrator/Domino
• TDI Redbooks/Redpieces –
http://www.redbooks.ibm.com/cgi-
bin/searchsite.cgi?query=tivoli+AND+directory+AND+integrator
• And Marie and Tom have done a series of TDI articles on at:
http://www.crashtestchix.com
• Thanks to Eddie Hartman “TDI Story Teller” [email protected]
![Page 89: Populating your domino directory or any domino database with tivoli directory integrator](https://reader033.vdocuments.site/reader033/viewer/2022051210/54bee4684a79592c448b4630/html5/thumbnails/89.jpg)
Questions? Comments?
Marie Scott – [email protected]
Blog: CrashTestChix - http://www.crashtestchix.com
Twitter: marie_scott
Thomas “Duffbert” Duff - [email protected]
Blog: Duffbert's Random Musings -
http://www.duffbert.com
Twitter: duffbert