ILM Quickie* : rapidly creating basic documentation of your ILM setup

* as in Quickie (informal), something made or done rapidly. ūüėČ

Of course you’ll find more sophisticated and nice (3rd party) solutions, but sometimes you don’t wont to spend money on it. (And time is money…)
MIIS/ILM and the MIIS Resource toolkit contain some basic tools to quickly create some more or less graphical documentation.
(I’ll refer to MIIS, meaning MIIS 2003 and ILM 2007…)
 
To start with, you need
– Existing Installation of MIIS/ILM server, with
o MIIS/ILM Server configuration
o MA configuration
o MV configuration
– Microsoft Identity Integration Server 2003 Resource Tool Kit, with
o Management Agent Configuration Viewer (GUI)
o AttributeFlowViewer (CMD)
o MVConfigurationViewer (CMD)
 
First you need to export some configuration data.
 
Exporting the MIIS server configuration
Open the MIIS administration console (Identity Manager).
Run the file menu > Export Server Configuration (short cut key combination CTRL+SHIFT+E)
clip_image002
You’ll get a warning:
clip_image002[4]
Select an empty directory to export the configuration.
clip_image002[6]
If not :
clip_image002[8]
 
Exporting the MA configuration
Go to the Management Agents section in the Identity Manager Console.
clip_image002[10]
For each management agent, export the management agent to an XML file.
(Tip: use a separate directory for the MIIS server export, the MA exports and the MV configuration export.)
clip_image004
AD MA XML config 
 
Exporting the MV configuration
Go to the Metaverse designer display in the Identity Manager Console
clip_image002[12]
Right click an object under the Metaverse Designer Object types.
Then right click the object and select Export Metaverse Schema.
(Or select the option under menu Actions, alternatively press CTRL+S)
clip_image004[4]
Export the MV schema to an XML file (by preference in a separate directory).
 
Creating documentation
The Microsoft Identity Integration Server 2003 Resource Tool Kit is free to download.
When you install the tool kit, it offers an utility to quickly document your MA configuration.
Start the Management Agent Configuration Viewer via the Windows Programs menu.
clip_image002[14]
clip_image004[6]
As the base (source) XML file, select the exported XML file from the management agent you wish to document.
Using the Open window, browse to the directory with the MA export file.
AD MA XML config 
Select the correct XML file.
Next use the <TAB> button to jump to the ‚ÄúTarget HTML File‚ÄĚ field.
In this way the target HTML file name is generated for you.
Of course you can type a name at will, but keeping the source (XML) and target files (HTML) together is handy.
clip_image008
Next click the ‚ÄúShow Configuration‚ÄĚ button.
The Wizard will generate the HTML file for you.
AD MA html config 
To create another MA configuration HTML file, return to the MAConfiguration viewer.
Select another XML source file.
Be sure to refresh the target HTML file name (for example by first deleting the old name and using the <TAB> and <shift+TAB> button again…)
 
Documenting attribute flows
Open the MIIS Resource Tool kit Command prompt.
clip_image002[16]
Running the attributeflowviewer command without options, explains how to use the command.
clip_image004[8]
Run the tool with the MIIS server configuration export directory as parameter.
C:\Program Files\Microsoft Identity Integration Server 2003 Resource Tool Kit>AttributeFlowViewer.exe "C:\_MIISbackup\MIIS Server Config Export"
By default the HTML target file is created in the same directory as the executable
Microsoft Identity Integration Server Attribute Flow Viewer v2.0
Copyright (c) 2004 Microsoft Corporation. All rights reserved.
The Attribute Flow information has been populated
You can view this information in the AttributeFlowViewer.html file
C:\Program Files\Microsoft Identity Integration Server 2003 Resource Tool Kit>
It will be like:
image
Tip: Move the HTML file to a safe location.
 
Documenting the MV configuration
Open the MIIS Resource Tool kit Command prompt.
clip_image002[18]
Running the MVConfigurationViewer command without options, explains how to use the command.
clip_image004[10]
As XML source file use the exported MV configuration file.
As XSL tranformation file, check for the MVConfigTransform.xsl file.
clip_image006[8]
The command becomes something like:
C:\Program Files\Microsoft Identity Integration Server 2003 Resource Tool Kit>MVConfigurationViewer "C:\_MIISbackup\MIIS MV Config Export\MV export.xml" MVConfigTransform.xsl
The transformed HTML file is put in the same directory as the executable:
Microsoft Identity Integration Server Metaverse Configuration Viewer v2.0
Copyright (c) 2004 Microsoft Corporation. All rights reserved.
Done transforming MV Config file. New file created is TransformedMVConfig.html
C:\Program Files\Microsoft Identity Integration Server 2003 Resource Tool Kit>
clip_image008[4]
This is the final result:
clip_image010[4]
Now you have
– MV configuration documentation in HTML (1)
– MA configuration doc in HTML (1 per MA)
– attribute flow documentation in HTML (1)
 
 
Advertisements

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s