Updating Multiple Contacts and Locations from ESA

Before you begin

Systems that are managed by an ESA instance can span multiple data centers. IBM® Electronic Service Agent addresses these modifications as shown in the following user scenarios. For more information, see Field Description table.
  1. If the customer needs to update existing configurations:
    1. The customer uses the node.properties file to perform the update.

Procedure

  1. The default contact information is provided during the activation of ESA and cannot be deleted. The addition of contacts is possible by using Rest API as follows: 
    curl -X POST 'https://xxx.yyy.zzz.ddd:wxyz/rest/v1/contacts' --header 'Accept: application/json' --header 'Authorization: Bearer Bearer PrimarySystem:XXXXXXXXXXXXXYYYYYYYYYYYYYYYY' --header 'Content-Type: application/json' --data '{"contact.type": "UKContact","contact.data":{"secondary.alternate.telephone.number": "XXXXXYYYYYY","telephone.number": "YYYYYZZZZZ","secondary.contact.name": "Rahul","email.address": "test.primary@ibm.com","secondary.telephone.number": "XXXXXYYYYY","contact.name": "Rohith","secondary.email.address": "test.secondary@ibm.com","alternate.email.address": "test123@ibm.com","is.communicate.in.english": true,"contact.type.id": 1,"alternate.telephone.number": "XXXXXYYYYYY","pager.number": "yyyyyzzzzz"}}' -k

  2. After the location is updated, "location": "UK Location1" (default location) is removed from the node config.

    In order to update the location from the node config file for a registered system:

    node1 = {"type": "HP ILO5", "ipaddress": "a.bbb.ccc.ddd", "endpointname": "test", "username": "IBM_Monitor", "password": "password", reconfig: "false", "location": "UK Location1"}

  3. View the location details in the All Systems page and update.

    The details in this page can be filtered based on user selection. The above steps can be performed to override the default location configuration.

    Table 1. Default Configuration
    Default location Details Default Contact Details
    name: Default (case sensitive) Id: 0 name: Default (case sensitive) Id: 0
    Table 2. Contact Details
    Field Name Is Mandatory Comments
    contact.type Yes
    1. Length<=50
    2. Only contain numbers, capital and small case letters, '–' and '_'.
    3. Case insensitive
    contact.name Yes Length<=50
    telephone.number Yes
    • For US and Canada, 10=<Length<=30, can contain letters or numbers, not contain dash.
    For all other countries, 5=<Length<=30
    email.address Yes Valid email format
    alternate.email.address   Alt email format
    is.communicate.in.english   Y/N (String)
    alternate.telephone.number  

    1)For US and Canada, 10=<Length<=30, can contain letters or numbers, not contain dash.

    2)For all other countries, 5=<Length<=30.
    pager.number   0=<Length<=30
    secondary.contact.name yes Length<=50
    secondary.alternate.telephone.number  

    1)For US and Canada, 10=<Length<=30, can contain letters or numbers, not contain dash

    2)For all other countries, 5=<Length<=30
    secondary.email.address yes Normal email format
    secondary.telephone.number yes

    1)For US and Canada, 10=<Length<=30, can contain letters or numbers, not contain dash

    2)For all other countries, 5=<Length<=30
    Table 3. Location Details
    Field Name Is Mandatory Comments
    location.type Yes

    1) 0<Length<=50

    2) case insensitive
    location.data    
    contact.type.id yes Contact should be created first using the URL mentioned in #
    Country yes Check list of valid country codes
    State yes Check list of valid state codes
    postal.code No 0<Length<=20
    City yes 0<Length<=30
    street.address yes 0<Length<=100
    building.floor.office yes 0<Length<=100
    telephone.number   Phone numbers must be 5 to 30 characters in length. Phone numbers for the United States and Canada must be 10 to 30 alpha numeric characters in length and not contain any dashes.