Enter Case number reference for associated cases.

Ticket # SUPDT-45194

Type: dynaTrace

Include any information that is for INTERNAL use only

https://dev-jira.dynatrace.org/browse/JLT-199729
https://dev-jira.dynatrace.org/browse/JLT-218545

Information:

Detail the contextual information specific to the issue; i.e. Product, Version, Agent, System, etc.

PHP 7.0+ on Linux

AppMon 7.0

Describe the problem, from the user perspective

Failed switch PHP agent to one agent platform with error message like below:

PHP Startup: dtphpagent (bootstrap failed, see dtagent log for details): Unable to initialize module Module compiled with module API=0

Clearly list the Steps to resolve the issue

Solution 1:

Install AppMon 7.1 agent and start up PHP agent with 7.1 bootstrap agent:

  • For 64 bit applications:
php.ini

extension=<agentFolder>/lib64/libdtagent.so

  • For 32 bit applications:
php.ini
extension=<agentFolder>/lib/libdtagent.so

 

Solution 2:

Step 1. Download one agent bootstrap file "liboneagentloader" by switching any other agents (Web Server, Java, Node.js, etc) to one agent.
Step 2. Manually add the agent name, agent location and collector address to php.ini file as below:

php.ini
phpagent.server=https://<appmonCollector>:<port>/
phpagent.agentname=<agentname>
extension=<agentFolder>/downloads/one/agent/7.0.x.x/linux-<architecture>/liboneagentloader.so



Note the underlying reason for the problem

A bug in AppMon 7.0 bootstarp agent. Unfortunately bootstrapper is the part of the file system which can not be updated with product updates so fix is only available in AppMon 7.1+.