Changing Diagnostics Collector settings

You can change the BMC Application Diagnostics Collector settings in the collector.properties file located in the following directories:

Windows
installationDirectory\collector\properties

Linux
installationDirectory/collector/properties

Note

After making changes directly to the the collector.properties file, restart the Diagnostics Collector service.

This topic presents the following procedures:

To change the host name for communication with the Diagnostics Collector

By default, the Diagnostics Collector uses the operating system’s configured host name to communicate between components.

Override the default host name configuration for any of the following situations:

If the default Collector host name is incorrect, for example, if the automatically detected host name is not the fully qualified device name (FQDN), you must replace the host name with the FQDN.
If the Collector requires an IP address for connection, such as from behind a firewall, you must replace the automatically detected host name with an IP address.

The property value directs end-user browser data through the load balancing or reverse proxy server and must be accessible from all Diagnostics Agents. You must configure the load balancing or reverse proxy server to forward requests to the assigned Collectors.

Perform the following procedure to override the default host name configuration:

Open the collector.properties file.
Change the callback.address value to the required host name or IP address.
Restart the Diagnostics Collector service.

To change the port numbers

Modify the BMC Application Diagnostics Collector's HTTP listening port.
The default port is 8200.
```
tomcat.http.listening.port=8200
```
Modify the BMC Application Diagnostics Collector's HTTPS listening port.
The default port is 8243.
```
tomcat.https.listening.port=8243
```
Restart the Diagnostics Collector service.

To set security properties

Set the security level of http connection:
```
connection.security.level=not_secured
```
The following options are valid:
- not_secured
- encrypted_authenticated
Restart the Diagnostics Collector service.

To configure the Diagnostics Portal connection

Set the Diagnostics Portal connection:
```
portal.connection.ip=localhost
portal.connection.http.port=8100
portal.connection.https.port=8143
```
Note

When entering IPv6 addresses, you must enter the IP address in square brackets. For example:
portal.connection.ip=[::1]
Restart the Diagnostics Collector service.

To modify database settings

Modify the database location.

database.url=jdbc:mysql://localhost:3306/adops_collector

Modify the password to access the database.
The password is encrypted. To change your password, encrypt it first.
```
database.password.enc=ABCD1234
```
Modify the database retention time and size.
The retention time is in days.
The database size is in MB.
```
retention.time=35
db.max.size=102400
```
Restart the Diagnostics Collector service.

To set or modify proxy settings

If the Collector uses a proxy to connect to the Portal, configure the proxy details. If you do not need to configure a proxy, leave the values empty.

Set the proxy details for HTTP:
```
http.proxy.host=
http.proxy.port=
```
Set the proxy details for HTTPS:
```
https.proxy.host=
https.proxy.port=
```
Set the proxy details for SOCKS:
```
socks.proxy.host=
socks.proxy.port=
```
Note

If you configure the proxy settings, you must make additional configuration changes to the BMC Application Diagnostics Agent settings.
Restart the Diagnostics Collector service.

Page tree