Special thanks to the following people for reviewing this document and providing valuable feedback:
This Wiki articles is an extract and updated version of a post on the ILM forum. The post has been updated with the latest product versions.
Whether you’re a first time user or a long-time expert, when you post a question to a forum, you expect an answer that is quick, to-the-point, and preferably customized to your needs.
But in lots of cases it actually takes a while (meaning additional questions and answers back and forth) before the community actually can get to the root cause of the issue.
I would like to provide you with practical hints and tips, and background information of them, to get the maximum result from your postings on the forum, with the minimum of effort.
If you ask the right question, the right way, you’ll get your answer much faster.
What do you expect if you post a question on a forum? A quick answer, solving the issue you’re struggling with, in a timely fashion? However, the reality looks often different:
What's the most efficient way to allow the community to help you?
The key to the quick solution is how you present the question.
In this article, I will give you suggestions and recommendations that will help you to get the most out of this forum.
As a first step, you should gather all data that is related to your question. What the right data is depends on the type of answer you expect. A general, more high-level question in conjunction with the architecture and the design requires a different approach than a practical question to troubleshoot an issue. When troubleshooting your setup:
Even for more general architectural questions, take a moment and ask yourself:
In most cases, there are some core components you should address in your initial question. These components include:
The following list highlights important data points regarding your FIM/MIM server configuration:
The build version of the platform is really essential, as specific builds solve specific known issues (or cause specific issues for the pessimists among us.).
Just an illustration: the Microsoft Help and Support site is one of the sources that provides hotfixes and services packs.
If you check for the ILM/MIM hotfixes and service packs, you’ll immediately notice the build numbers.
Most of these articles also provide detailed information which issues are fixed.
The version number is pretty important and also easy to retrieve.
To get the version number, perform the following steps:
The following screenshots show examples for these steps.
Carefully check the license type which you used to install your FIM/MIM with. It represents an important data point in the context of upgrading your system, as certain upgrade paths are not supported.
(Reference: FIM/MIM FAQ)
The kind of server (development, test or production) you’re working with influences the approach to troubleshooting.
For example, on a development server, it usually doesn’t hurt to take drastic measures, like completely deleting data, cleaning connector spaces or cleaning the metaverse and start all over again.
However, in production, deleting a connector space with 100K or more objects shouldn’t happen without planning.
If your audience is aware of your server type, you will get better suited troubleshooting suggestions.
As the backend for the managed data, SQL server plays an essential role in your deployment.
This is why you should include some information about your SQL server configuration into your post.
When you review some of the posts on this forum, you will find many questions that are related to the performance of an environment.
For example, using ILM with a remote SQL server has a significant impact on the overall performance of a deployed solution.
Another reason to include information about your SQL setup is network and server security.
A configuration with a remote SQL server requires a slightly different approach, in comparison with SQL installed on the ILM server.
Typical SQL server parameters are:
When you post a question, at a minimum, provide these SQL server parameters:
Management agents are used to exchange data between ILM and connected data sources. The type of a management agent used in your environment has a big impact on the response you get. When posting a question, you should address the following questions about your management agents:
Information about your management agent configuration helps to get a global picture of the setup. Again, the management agent configuration influences the kind of approach to take for a specific configuration.
If you get an error when configuring a MA, verify that the version of your data source is supported. Check the FIM/MIM FAQ for more information, first.
The MV and CS object count is a practical indicator for the system load.
The ratio of the CS objects and the MV objects provides an overview of the join and projection rules.
Error codes play an essential role in a troubleshooting scenario. However, in many posts I have seen, people tend to provide incomplete information about the errors that are documented by a system. In conjunction with error codes, you should follow the following guidelines:
This is the easy part. Just make sure you catch enough details:
In the previous section I’ve discussed components strictly related to the configuration basics of ILM/MIM components, which you can retrieve in real-time.
It’s clear that the complete ILM infrastructure exists of different parts, each depending on each other: the ILM application, the operating system, the SQL server, the .NET framework, the Visual Studio extensions, and more … It’s a complex balance, even a small change in one of these components, might cause trouble.
Ideally you manage the complete ILM infrastructure yourself. But in my experience, this is rarely the case, as most live server setups are managed by a group of people. And, not every member of the team knows the in and outs of every part.
So, when your ILM system starts behaving badly, just suddenly or intermittently, while it has been in operational mode for quite a while, it’s not always easy to determine the root cause.
When you’re troubleshooting your ILM/MIM setup, also take a wider look on the technical infrastructure. I can guarantee it is worthwhile to log the changes you make on your system configuration from the very start. Additionally, make sure the events and errors are logged accurately.
Change logs and events logs allow you to answer the following list of questions:
You should post this kind of information in your initial post, as it is very helpful.
Another important type of information you should provide in your post, is NOT of a technical kind.
It’s not about the FIM/MIM configuration, neither.
It concerns the actions you have done when troubleshooting, before you posted your question.
What kind of steps have you already done to get an answer?
It might be obvious, but it wouldn’t be the first time someone posted personal, secret, identifiable data on the web. It would not take too much effort to use it maliciously.
Make sure you mask:
The forum is an excellent resource if you just need some assistance solving a problem on architectural level. The following list of hints and questions should allow you to provide the basics in your post:
Provide as much detail as possible to make your case with examples and/or (anonymized) screenshots.
When troubleshooting your setup:
When you need help or an insight on a design issue:
In both cases provide as much detail as possible to make your case.
Providing examples or (a link to) screenshots, help to understand.
The check list summarizes the topics I have discussed in this article and should help you to make sure that you include all details that are relevant to your issue.
1. Basic Server info (general)
Results / notes / remarks
q
- FIM/MIM build version
.............................................
- SQL Server build version
- SQL installed locally or remotely?
- License type (MSDN, eval, production, …)
2. Specific server info (details on configuration)
- Which MA's configured?
- MA & MV object count?
- Particular attributes, attribute flows, extensions?
- Provide code bits of your extensions
(when applicable)
3. Error conditions
- Provide exact error codes*
- Drill down to the detailed content of the error message*
- Check the event viewer
- If applicable, check logs created by extensions or services (e.g. PCNS)
*(HINT: copy/paste info into post)
4. Circumstances & particular details
- Any particular configuration on your setup?
- Particular conditions or features?
- Has the system changed recently? Like update/upgrade, hotfixes,...?
- When exactly does the error condition occur?
- Are you able to reproduce the error condition?
- Is the error occurring intermittently?
5. What actions have you already performed?
- Have you already followed certain procedures?
- Any articles or posts you looked at?
- Results achieved so far? Details?
This article and the check list are also available for download, for offline use.
See below: