Troubleshooting Infrastructure Management
The following section lists various issues that you may encounter with Infrastructure Management and solutions to the issues:
- Authentication issues
- Resource not found issues
- No matching monitor found to create an SLO
- UI not displayed
- UI performance is slow
- Preview for policy does not display any values
- Monitor instances are removed in the TrueSight Infrastructure Management Server
- The log file displays a stats queue limit exceeded error message
Authentication issues
If the Authentication failed (HTTP error code 401) error message is displayed, perform the following actions:
- Ensure that the user credentials are valid. You can do this by trying to log on to the administrator console and verifying that the login was successful.
- On the Central Server Router, ensure that the routerGatewayHostName property does not have the router's name as the value in the pw\pronto\conf\bppmws.properties file.
- On the Child Server, ensure that the isRouter property is set to False in the pw\pronto\conf\bppmws.properties file.
- Ensure that the registeredNGPs property in the pw\pronto\conf\servers.properties file lists the name of the registered child servers for the Central Server Router and the name of the router for the Child Servers.
Resource not found issues
If the Not found (HTTP error code 404) error message is displayed, perform the following actions:
- Ensure that the web service request uses the correct calling method. For example, for a web service API that uses the POST method, if you use the GET method, this error is displayed. Also, ensure that the content type is specified correctly in the body of the web service request.
- On the Child Server, ensure that the routerGatewayHostName property has the router's name as the value in the pw\pronto\conf\bppmws.properties file.
- On the Central Server Router, ensure that the registeredNGPs property lists the name of the child server in the pw\pronto\conf\servers.properties file.
- If the name of the child server is not registered, restart the child server so that it is registered with the Central Router Server.
- If the child server is not registered in the router, on the child server, check the value of the bppmwsGatewayProtocol and selfHostBPPMAPIPort properties in the pw\pronto\conf\bppmws.properties file. If the gateway protocol is http, then the port number must be 80, and if the gateway protocol is https, then the port number must be 443.
- If the TrueSight Infrastructure Management Server is integrated with Remedy SSO, ensure that the child server is configured properly, and verify that the:
- User names are added to Remedy SSO
- Default user groups that are part of TrueSight Infrastructure Management Server are created in Remedy SSO
- Custom groups are also created in Remedy SSO, Central Server, and the child servers
- Servers are integrated with the same Remedy SSO
- if the TrueSight Infrastructure Management Server is integrated with Remedy SSO, ensure that the mapping of the TrueSight Infrastructure Management Server user group and Remedy SSO user groups is done . To verify this, open the ldap_ppm_group_mapping file located in the pw\pronto\conf folder and check for the group mapping. If the mapping is not done, this error message is displayed.
If the TrueSight Infrastructure Management Server is integrated with Remedy SSO, ensure that the authentication type used in TrueSight Infrastructure Management Server is added as an authentication module in Remedy SSO. This error is displayed if the authentication type is not added to Remedy SSO. For more information about the authentication module, see the Remedy SSO Administration documentation.
No matching monitor found to create an SLO
If the No matching monitor found (JSON error code BPPM-RWS40029E) error message is displayed when you try to create an SLO, it may be due to the following reasons:
- There is no matching monitor found with the specified filter identifier for the specified device.
- Attribute set may not be present for the specified SLO type. To verify this, on the SLO Management console, try creating an SLO. If you cannot create it, try adding an attribute set to the SLO type, and retry creating an SLO.
For information about creating an SLO on the SLO Management console and adding an attribute set to the SLO type, see Creating an SLO with REST APIs.
UI not displayed
The TrueSight Infrastructure UI might not be displayed because of one of the following reasons:
- Cross Site Request Forgery (CSRF) validation - The TrueSight Infrastructure Management Server validates all incoming requests to prevent CSRF attacks. If you are connecting to the TrueSight Infrastructure Management Server with an alias or a proxy name, the UI might not be displayed.
- Changed load balancer name - If you change the load balancer name after starting the TrueSight Infrastructure Management Server, and then if you try to connect to the TrueSight Infrastructure Management Server with the changed loadbalancer name, the UI might not be displayed.
Solution
- Provide all aliases, proxies, or load balancer names in the custom/conf/pronet.conf file. If multiple hosts or aliases are assigned to the TrueSight Infrastructure Management Server, provide them as comma-separated values, for example:
pronet.tsim.proxy.hosts=alias1,alias2,proxy1,proxy2,changedloadbalancername - Run the following command to load the host and aliases in the cache:
pw jproperties reload
UI performance is slow
The UI performance might be slow because the TrueSight Infrastructure Management Server validates all incoming requests to prevent Cross Site Request Forgery (CSRF) attacks. Disabling the CSRF filter might improve the UI performance. However, your security will be compromised. BMC recommends not disabling the validation.
Perform the following steps to disable the CSRF filter:
- Update the following property in the custom/conf/pronet.conf file to disable the filter. The filter is enabled by default.
pronet.tsim.csrf.filter=false - Run the following command:
pw jproperties reload
Preview for policy does not display any values
While creating a policy with the Agent IP Adress equals condition, when you click Preview, the matching PATROL Agents are not displayed. This happens because the PATROL Agents have dual IP addresses.
Solution
While creating a policy, make sure that you use the PATROL Agent IP address that is used on the Device Details page for the PATROL Agent.
Monitor instances are removed in the TrueSight Infrastructure Management Server
If there are multiple aliases for the PATROL Agent and one alias for the configuration management database (CMDB), the monitor instances are removed from the TrueSight Infrastructure Management Server after the device is consolidated for the CMDB. The PATROL Agent device is moved out of the VCenter hierarchy.
Solution
If you have set the ServiceModelDeleteDuplicateCI property to Yes in the installationDirectory/pw/server/etc/<cellname>/mcell.conf file, you must add the following property in the installationDirectory/pw/custom/conf/pronet.conf file: component.delete.duplicate.device=true
Once you modify the preceding files, ensure that you restart the Infrastructure Management server.
The log file displays a stats queue limit exceeded error message
An error message is displayed in the TrueSight.log file with the following format:
Solution
Perform the following steps only if a few (around three or so) monitor type IDs are displayed in the log. If the log contains more monitor type IDs, contact Support for assistance.
- From the TrueSight.log file, obtain the monitor type ID.
For example: Max L2Stats Q limit exceeded for motypeId [ 501002 ]
The monitor type ID is 501002. - Set the following properties in the installatedDirectory\pw\custom\conf\pronet.conf file:
pronet.ngp.perf.queue.manager.motypes <comma separated list of monitor type IDs>
pronet.ngp.perf.queue.manager.queue.<monitor type ID>.size
For the monitor type ID 501002, you could set the properties as:
pronet.ngp.perf.queue.manager.motypes 501002
pronet.ngp.perf.queue.manager.queue.501002.size=100000