Lab B:CreatingTemplatestoImport
Data intotheMetadirectory
Objectives
After completing this lab, you will be able to:
!
Create and configure an instance of the Generic management agent to
integrate information from a data source (for which there is no predefined
MA) intothe metadirectory.
!
Use template language to create Parsing and Construction templatesto
import the connected directory dataintothe metadirectory.
Prerequisites
Before working on this lab, you must have:
!
Knowledge about attribute flow rules.
!
Experience joining connector namespace entries with metaverse entries.
!
Experience operating management agents.
!
Knowledge about logging levels.
!
Knowledge about connector namespace holograms.
Lab Setup
To complete this lab, you need the following:
!
MMS Server and MMS Compass installed.
!
The metaverse namespace populated with Microsoft Exchange Server 5.5
entries.
Estimated time to complete this lab: 30 minutes
2 LabB:CreatingTemplatestoImportDataintotheMetadirectory
BETA MATERIALS FOR MICROSOFT CERTIFIED TRAINER PREPARATION PURPOSES ONLY
Exercise 1
Creating a Generic Management Agent
In this exercise, you will create an instance of the Generic management agent and edit the MA
control script to connect tothe SQL Server and create an import file with the employee's telephone
numbers.
Scenario
At Northwind Traders, a Microsoft SQL Server
™
database stores employee telephone numbers,
which need to be integrated intothe metaverse. To perform the integration, you must create an
import file.
Tasks Detailed Steps
1.
Log on to Windows 2000,
start MMS Compass, and
then log on to your MMS
server.
a.
Log on to Windows 2000 as Administrator with a password of
password.
b.
Start MMS Compass, and then log on to your MMS server as
mmsadmin@nwtraders.msft with a password of password.
2.
Create an instance of the
Generic management agent
called Telephone Number
MA and configure it to run
in association mode.
a.
On the control pane of MMS Compass, click Bookmarks, click
Management Agents, and then click Create New Management
Agent.
b.
In the Create Management Agent dialog box, in the Name of the
Management Agent box, type Telephone Number MA and in the
Type of the Management Agent box, click Generic Management
Agent, and then click Create.
c.
In the Configure Management Agent dialog box, on the Connected
Directory Specifics tab, on the Mode and Namespace Management
tab, under Management Agent Mode, click Association, and then
click OK.
3.
Copy the cdir_oledb.vbs
script from
c:\moc\2062a\labfiles folder
to the working folder of the
Telephone Number MA.
a.
In the directory pane, right-click Telephone Number MA, and then
click Properties.
b.
In the Management Agent Properties dialog box, display the
Intermediate Files and Logs tab.
What is the management agent’s working directory for the Telephone Number management agent?
c:\zoomserv\Data\ds\
nnnnnnnn
(where
nnnnnnnn
is a number).
3. (continued)
c.
Click OK to close the Management Agent Properties dialog box.
d.
Copy the file c:\moc\2062a\labfiles\cdir_oledb.vbs tothe
management agent’s working directory.
LabB:CreatingTemplatestoImportDataintotheMetadirectory 3
BETA MATERIALS FOR MICROSOFT CERTIFIED TRAINER PREPARATION PURPOSES ONLY
Tasks Detailed Steps
4.
Configure Notepad.exe as
the Compass script editor.
a.
In the control pane, click Design MA.
b.
In the Design MA dialog box, on the Control MA Operations tab, on
the MA Control Script tab, right-click in thedata box, and then click
Manage Editor.
c.
In the Manage editor dialog box, in the Path of the executable box,
type notepad.exe select the Set as default editor check box, click
Add, and then click OK.
5.
Modify the MA control
script to use the Visual
Basic custom discovery
procedure.
a.
On the MA Control Script tab, right-click in thedata box, and then
click Edit.
b.
In Notepad, find the script block for %zcMAProcessUsers%. In this
script block, replace the series of echo statements between the asterisks
with the following line.
EXECUTE cmd /c cscript
!%zcDSDirectory%\cdir_oledb.vbs
!/action:discovery /debug:%zcDSMALoggingLevel%
Note: The previous text must be typed on one line.
c.
Save and then close Notepad.
d.
Click OK to close the Design MA dialog box.
6.
Operate the MA to only
discover the users in the
SQL server database.
a.
In the control pane, click Operate MA.
b.
In the Operate the Management Agent dialog box, on the
Operational Settings tab, on the When Running the Management
Agent tab, under Tasks to Run, clear the Update themetadirectory
check box, ensuring that only the Discover Connected Directory
check box is selectted.
c.
Under Types of Objects to Process, clear the Process Organizing
Structures check box, ensuring that only the Process Users check box
is selected.
d.
On the Management Agent Logs tab, display the Operator’s Log tab.
e.
Click Run the Management Agent.
The Operator's Log displays a message indicating that 1000
entries were discovered.
f.
Click OK to close the Operate the Mangement Agent dialog box.
4 LabB:CreatingTemplatestoImportDataintotheMetadirectory
BETA MATERIALS FOR MICROSOFT CERTIFIED TRAINER PREPARATION PURPOSES ONLY
Exercise 2
Updating the Connector Namespace
Scenario
At Northwind Traders, a SQL server database stores the employee telephone numbers. This
information needs to be integrated intothe metaverse namespace. A connection has already been
established by using a custom discovery script, and an import file has already been created. The
connector namespace needs to be updated with the information in theimport file.
Goal
In this exercise, you will analyze the record format of theimport file and create Parsing and
Connector Namespace templatesto populate the connector namespace with the employee's
telephone numbers.
Tasks Detailed Steps
1.
Analyze the record format
by reviewing theimport file.
a.
In Notepad, open the file called import with no extension located in the
working directory of the MA.
What type of format does this data set represent?
Label/value pairs.
2.
Create an Add Parsing
template to parse the records
in theimport file.
a.
In the directory pane of MMS Compass, ensure that Telephone
Number MA is selected, and then in the control pane, click Design
MA.
b.
In the Design MA dialog box, on the Control Metadirectory tab, on
the Parsing Templates tab, on the Add tab, right-click in thedata box,
and then click Edit.
c.
Copy the first record set from theimport file and paste it intothe
Notepad window for the Add script.
d.
Replace all the attribute values with variables as follows:
Record: $dummy
Employee_ID: $cd.uid
Name: $cd.cn
Title: $cd.title
Phone: $cd.telephoneNumber
Fax: $cd.facsimileTelephoneNumber
Mobile: $cd.mobile
Pager: $cd.pager
Note: There must be no spaces after the variables.
1. (continued)
e.
Save the document, and then close the Notepad window for the Add
script.
LabB:CreatingTemplatestoImportDataintotheMetadirectory 5
BETA MATERIALS FOR MICROSOFT CERTIFIED TRAINER PREPARATION PURPOSES ONLY
Tasks Detailed Steps
3.
Create a Connector
Namespace Construction
template to construct the
distinguished name and the
object class.
a.
In the Design MA dialog box, on the Control Metadirectory tab, on
the Construction Templates tab, on the Connector Space tab, right-
click in thedata box, and then click Edit.
b.
In the Notepad window, create the DN entry by typing the following:
$cs.dn = uid=$cd.uid,$MA()
c.
In the Notepad window, assign an object class of zcAliasThing tothe
entry by typing the following:
$cs.zcoc = zcAliasThing
d.
Save the document, close the Notepad window containing the
connector namespace construction template, and then click OK to close
the Design MA dialog box.
4.
Operate the management
agent and verify that the
entries were created in the
connector namespace.
a.
In the control pane, click Operate MA.
b.
In the Operate the Management Agent dialog box, on the
Operational Settings tab, on the When Running the Management
Agent tab, under Tasks to Run, clear the Discover Connected
Directory check box, and then select the Update themetadirectory
check box.
c.
On the Management Agent Logs tab, display the Operator’s Log tab.
d.
Click Run the Management Agent.
The Operator's log indicates that 1000 disconnectors were
added.
e.
Click OK to close the Operate the Management Agent dialog box.
f.
In the directory pane, expand Telephone Number MA, and then click
the first entry AU0002288.
g.
In the control pane, click View Hologram.
h.
In the Hologram Attributes dialog box, note that the attributes and
their values are now in the connector namespace, and then click OK.
6 LabB:CreatingTemplatestoImportDataintotheMetadirectory
BETA MATERIALS FOR MICROSOFT CERTIFIED TRAINER PREPARATION PURPOSES ONLY
Exercise 3
Updating the Metaverse Namespace
Scenario
At Northwind Traders, a SQL server database stores the employee telephone numbers. This
information needs to be integrated intothe metaverse namespace. A connection has already been
established by using a custom discovery script, and an import file has already been created. The
Parsing and Connector Namespace Construction templates have also been created. The employee
telephone numbers are already in the connector namespace. The metaverse namespace needs to be
updated with the information from the connector namespace and joined with the existing metaverse
namespace entries.
Goal
In this exercise, you will create the Metaverse Construction template and then join the connector
namespace entries with the existing metaverse namespace entries.
Tasks Detailed Steps
1.
Create the Metaverse
Construction template by
assigning the DN, object
class, and all telephone
number attributes.
a.
In the directory pane of MMS Compass, click Telephone Number
MA, and then in the control pane, click Design MA.
b.
In the Design MA dialog box, on the Control Metadirectory tab, on
the Construction Templates tab, on the Metaverse tab, right-click in
the data box, and then click Edit.
c.
Create the DN for the entry by typing the following:
$mv.dn = cn=$cd.cn,$MA($zcMAUNSBase)
d.
Assign an object class by typing the following:
$mv.zcoc = zcPerson
e.
Assign attributes for all telephone numbers in the connector namespace
entry by typing the following:
$mv.telephoneNumber = $cd.telephoneNumber
$mv.facsimileTelephoneNumber =
!$cd.facsimileTelephoneNumber
$mv.mobile = $cd.mobile
$mv.pager = $cd.pager
f.
Save and close the Metaverse Construction template.
g.
Click OK to close the Design MA dialog box.
2.
Test the Metaverse
Construction template by
running the MA on only the
first five entries.
a.
In the control pane, click Operate MA.
b.
In the Operate the Management Agent dialog box, on the
Operational Settings tab, on the Limits tab, in the Process a
maximum of box, type 5
c.
On the Management Agent Logs tab, display the Operator’s Log tab.
d.
Click Run the Management Agent.
The Operator's log displays that 5 entries were processed.
LabB:CreatingTemplatestoImportDataintotheMetadirectory 7
BETA MATERIALS FOR MICROSOFT CERTIFIED TRAINER PREPARATION PURPOSES ONLY
Tasks Detailed Steps
3.
Join the Telephone Number
MA connector namespace
entries intothe metaverse.
a.
On the Operational Settings tab, on the Limits tab, delete the value in
the Process maximum of box.
b.
On the Operational Settings tab, on the Logging tab, under Logging
Details, in the Logging detail level box, select 2, and then click OK.
c.
In the control pane, click Join.
d.
In the Server-Based Join dialog box, on the Configure the join tab, in
the Search using these attributes box, type the following:
$cd.uid
e.
Click OK to close the Server-Based Join dialog box.
4.
Configure Attribute Flow
rules and update the
telephone numbers in the
metaverse with the SQL
server data.
a.
In the control pane pane, click Attribute Flow.
b.
In the Configure Attribute Flow dialog box, on the General
Attribute Flow tab, under Metadirectory Attributes, click When the
metaverse attribute can be constructed from the connected
directory, and then click OK.
c.
In the control pane, click Operate MA.
d.
In the Operate the Management Agent dialog box, on the
Management Agent Logs tab, display the Operator’s Log tab.
e.
Click Run the Management Agent.
The Operator's log displays the results of the management
agent process
.
f.
Click OK to close the Operate the Management Agent dialog box.
g.
At the top of the directory pane, click The Known Universe.
h.
In the directory pane, click Aarika Quek under Accounting, and then
in the control pane, click Properties.
i.
In the Aarika Quek dialog box, click the Office tab
Notice that Aarika's has telephone numbers.
j.
Click OK to close the Aarika Quek dialog box.
5.
Close MMS Compass, and
then log off of
Windows 2000.
a.
Close MMS Compass, and then close any open windows.
b.
Log off of Windows 2000.
THIS PAGE INTENTIONALLY LEFT BLANK
.
entries.
Estimated time to complete this lab: 30 minutes
2 Lab B: Creating Templates to Import Data into the Metadirectory
BETA MATERIALS FOR.
f.
Click OK to close the Operate the Mangement Agent dialog box.
4 Lab B: Creating Templates to Import Data into the Metadirectory
BETA MATERIALS