Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. BlackBerry AtHoc Integrations
  4. IIM Health Monitoring Installation and Configuration Guide
  5. BlackBerry AtHoc alert template IIM error notifications
  6. Create an IIM alert template

Create an IIM alert template

To create an IIM alert template for IIMAgent Errors in the associated BlackBerry AtHoc organization, complete the following steps:
  1. Create an IIM template for IIMAgent Errors.
  2. In the 
    Template Title
     add the following text: 
    [[IIM Agent Error Type]]
     at 
    [[IIM ID]]
    .
    [[IIM ID]] is replaced with the IIM ID provided in the 
    IIMAgent.exe.config
     file.
  3. Add the following text in Alert Template Body: 
    [[IIM Agent Error Type]]
     occurred at IIM 
    [[IIM ID]][[Error Message Body]]
    [[IIM Agent ErrorType]]
     is replaced with the value of the Error Type (Service Error or Java Error) that is passed to the SDKAlert. 
    [[Error Message Body]]
     is replaced with the error message that is passed in the 
    SDKAlertTemplate
    .
  4. Save the alert template.
  5. Note down the alert template common GUID, Organization ID, SDK user name, and password.
  6. Open Notepad as an administrator.
  7. Open 
    C:\Program Files\capnode\iim\IIMAgent.exe.config
    .
  8. Add the following parameters: 
    <add key="SDKURL" value="https://iwshostname/sdk/listener/listen.asp"/>
<add key="SDKUserName" value="username"/>
<add key="SDKPasswordEncrypted" value="no"/>                                    
<add key="SDKPassword" value="password"/>
<add key="SDKVPSId" value="1234567"/>
<add key="SDKAlertTemplateCommonName" value="85b0b856-7637-4862-abe8-dd9ea6be2524"/>
<add key="IIMId" value="IIM-IP_OR_IIM_Name"/>
#
#SDKAlertTemplateCommonName-value for this parameter must be the alert template Common Name for Error Template that we have created in IWS steps.
#
#SDKURL-Add the URL of the BlackBerry AtHoc management server you are using.
#
#SDKUserName-Add the SDK username according to your SDK server.
#
#SDKPasswordEncrypted-When installing for first time, value should be "no", later this SDKPasswordEncyted is updated as"yes" once SDKPassword is encrypted.
#
#SDKPassword-Add SDK password according to your SDK server (text format).Later this is updated in Di-cipher text (encrypted format).
#                                      
#SDKVPSId-This is the BlackBerry AtHoc management system organization ID.
#
#IIMId-IIM ID of the IIM on which you are installing the IIMAgent.
  9. Save 
    C:\Program Files\capnode\iimm\IIMAgent.exe.config
    .
  10. Open 
    Component Services
    , search for 
    IIMAgent Service
     in the service list.
  11. Right-click and select 
    Properties
    .
  12. Change the 
    Startup Type
     to 
    Automatic (Delayed)
    .
  13. Click 
    Apply
     > 
    OK
     and then run the service.
    Do not set the 
    Startup Type
     to 
    Automatic
    , it should be 
    Automatic (Delayed)
    .
  14. Start and stop the service to check the installation. If the service is starting and stopping properly, then the installation is successful.
  15. Optionally, if you already ran the 
    createWinCounters_v1.ps1
     file for setting up Java counters, do not run it again. For detailed information about how to create Windows Performance Counters from IIM Java code, see Install all Windows performance counters.
  16. Start the IIMAgent Service from Component services.