How do I troubleshoot the Action_MAPIMail knowledge script? (NETIQKB6678)

  • 7706678
  • 02-Feb-2007
  • 27-Oct-2010

Environment

NetIQ AppManager 6.x
NetIQ AppManager 7.0.x

Situation

How do I troubleshoot the Action_MAPIMail knowledge script?

Resolution

This is a basic guide to configure and trouble-shoot Action_MAPIMail for AppManager.

Use this Knowledge Script to send mail to one or more email users. By default, AppManager automatically constructs the Subject and Body of the message to include the following: job ID, managed client machine name, Knowledge Script name, the object where the event is raised, the event ID, event short message, and event detail message.

You can also attach a file to the email message by entering the path to the file. The email is sent using the Microsoft MAPI mechanism. The recipients can be one or many MAPI clients.

  • Testing Action_MAPIMail for One or More Recipients
    Example:
    Recipients Name: name@company.com;name_two@company.com
    NetIQ MCs Profile Name: NetIQ Profile
    Attachment Path: <blank>
    Custom Subject: Test Message
    Custom Message Body: This is a test.
  • Testing Action_MAPIMail using the Command Prompt
    netiqmapimail

    -t<Recipient_Email;Recipient_Email>
    -s<Subject>
    -m<Message>
    -p<Profile>
    -w<Password>
    -f<Attachment_Path>

    NOTE: All email addresses used must be fully qualified, valid email addresses.

netiqmapimail tname@company.com;name_two@company.com -sTest Message -mThis is a test. -pNetIQ Profile -w<password>

  • Verifying the Profile is Correct
    To verify that the Profile is correct, the user needs to logon to the machine that will be sending the email (i.e. the Management Server if it will be an MS Action, the Managed Client if it will be an MC Action) with the NT Account that is associated with the Mailbox being used. Once logged on, go to Control Panel | Mail and go to Show Profiles; make sure that only one Profile is listed and that it matches the value being used by the user.

    If the user cannot logon to the machine with the NT Account, for any reason, please refer to Step 8 and using the Prof.exe utility.
  • Verifying the Services are Using the Proper Accounts
    The NetIQccm and NetIQmc Services on the Management Server or the Managed Client, depending if the Action is set to be an MS Action or MC Action, needs to start with the same account that is the primary owner of the Mailbox and Profile being used.

    This can be verified by logging onto the appropriate machine (MS or MC) with the NT Account that is being used to start the NetIQccm and NetIQmc Services. Using Control Panel | Mail, you can verify that the Mailbox and Profile names are correct.
  • Verifying the Registry Keys are Populated Properly
    The values in the following key need to be an exact match of what is being used on the Management Server (MS Action) or Managed Client (Agent, MC Action).

HKEY_LOCAL_MACHINE\Software\NetIQ\NetIQmc\Exchange Mailbox
HKEY_LOCAL_MACHINE\Software\NetIQ\NetIQmc\Exchange Profile
HKEY_LOCAL_MACHINE\Software\NetIQ\NetIQmc\Exchange Server

  • Re-start the NetIQccm and NetIQmc Services
    After any changes to the Registry or to the Services, the NetIQccm and NetIQmc Services need to be stopped and then re-started.
  • Updating AppManager Security Manager
    The values in the Security Manager, under Computers | Server_Name | Exchange tab, need to match the same values entered in the Registry for Exchange Profile and Exchange Mailbox Alias.
  • Using the Prof.exe Utility
    SYNTAX for Prof.exe
    prof -s <exchange_servername> -m <mailboxname> -notm -p <profilena.
    me>

    NotP vs. NotM
    -notp means do not create the profile
    -notm means do not create the mailbox

    A wildcard can also be used for the servername to do the following: prof -s <exchange_servername> -m netiq-%% -notp -p netiq-%%

    To specify a mailbox that is not in the recipients container, then specify the mailbox name in the following fashion:
    a. Container at same level as recipients: /Containername/mailboxname
    b. Container created under recipients: Containername/mailbox name (not no preceding '/' )

    In addition:
    1. If it has -registry command line parameter, if creates "SOFTWARE\NetIQ\NetIQmc\Exchange Profile" registry key value.
    2. If the mailbox name is XXXX%%, it replaces %% with machine name.
    3. If the profile name is XXXX%%, it replaces %% with machine name.

    ERROR CODES for Prof.exe

    0: correct
    1: command format wrong
    2: MAPI Initializing failed
    5: no server name (for creating profile on Exchange client machine)

    For creating mailbox:
    3: service down
    4: no user name
    11: load dapi.dll failed
    12: No permission to create mailbox.
    13: Invalid mailbox name.
    14: The container doesn't exist.

    For creating profile:
    21: general mapi error
    22: The existing profile can't be removed
    23: There is no Exchange service mapi configuration in the mapisvc.inf
  • Default Mail Client (TechNet Article Q223877)
    If you have installed multiple e-mail programs on the same computer, when you send mail from any non-mail program the mail may not be sent from Outlook. For example, if you have Outlook, Outlook Express, and Thunderbird all installed on the same computer, and you send a message in Microsoft Excel, Outlook may not be used to send the mail. Also, if you click a Mailto: link on a web page, your system may not open an e-mail message, or may use a mail program other than Outlook.

    When you send a document from a program by clicking Send on the File menu, or by pointing to Send To on the File menu, and then clicking Mail Recipient, the e-mail program that is set as your default Simple MAPI client is used to send the document.

    To change the default mail client in Microsoft Internet Explorer:

    Internet Explorer:

    1. Start Internet Explorer.
    2. On the Tools menu, click Internet Options.
    3. Click the Programs tab.
    4. In the E-mail list, click Microsoft Outlook.
    5. Click OK.

Additional Information

Formerly known as NETIQKB6678