How to import CI Locations and associated IP Ranges in to HEAT

Version 2

    Details

    In some cases, CI's will need to be linked to locations based on IP Ranges.  Before these CI types can be imported the Location and IP Ranges must be imported first to allow proper linking of CI's.


    Resolution

    Please note that the CI Location (LocationGroup#CI business object) must be imported before the IP Range (DeviceSubnet# business object) is imported.  The IP Range is linked to the location by the SubnetLocation link field.  Due to this type of link, it is highly recommended that the CI locations have unique names, otherwise the IP Range may show in both CI Locations and incorrectly link other CI types.


    1. Log in to HEAT as an administrator
    2. Click Configure Application
    3. Expand the Integration Tools menu option in the left menu pane
    4. Create a new connection
    5. Name the connection (Location)
    6. Select Manual File Upload
    7. Choose a .csv file (location_sample.csv)


    8. Click Next
    9. Create a new mapping
    10. Name the new mapping (Location)
    11. Save the Mapping by clicking Save New
    12. Choose the Source Unique Key (CILocation)


    13. In the Target business object, type in:  CI and click Filter by Name
    14. Choose the LocationGroup#CI object
    15. Click Next


    16. Click next to not include a filter
    17. The field mapping should be automatic if the sample file is used, map the source to the CILocation field
    18. Click Next


    19. Click Publish & Run Now
    20. Return to the HEAT Location workspace and verify that the locations are created as desired


    21. Return to the Configure Application screen and create a new data import connection
    22. Enter a connection name (Devicesubnets)
    23. Choose Manual File Upload
    24. Select the desired .csv file (device_subnet_sample.csv)
    25. Click Next


    26. Choose the new mapping option and set a name for the map (Device)
    27. Select SubnetLocation as the Source unique key


    28. In the target business Object search type in:  device and click Filter by Name
    29. Choose the DeviceSubnet# business object
    30. Click Next


    31. Click next to not use a filter
    32. Map the addressranges and location as desired (Note that the SubnetLocation is a linked field to LocationGroup#CI.CILocation.  The names must match, this is the link between the two business objects.
    33. Click Next


    34. Click Publish & Run
    35. Return to the CI Location workspace and verify that the IP address are added as desired


    Please review the attached import samples for location and IP Ranges.