Customize Agent Installer

This page explains how to fine-tune the Agent Installer configuration. Changes apply to the Agent Installer Platform configuration file, config.json.

Customize Agent Installer Platform Configuration

The Agent Installer Platform has several commands available to customize the configuration. You can run the commands during or after installation. You can issue the commands to the zeroctl executable, a binary located in the Agent Installer Platform directory. The Agent Installer Platform periodically checks the configuration file and applies the changes.

You should only use these commands in the zeroctl executable. Do not modify the zero-config.json file directly as this may result in undefined behavior.

Command Name	Description
`configure`	Modify the Agent Installer Platform configuration file.
`stop`	Stop running the Agent Installer Platform.
`stop` `<agent>`	Stop running an individual agent on the Agent Installer Platform.
`start`	Start or restart the Agent Installer Platform. Automatically done for `sudo` installations.
`start` `<agent>`	Start or restart an individual agent on the Agent Installer Platform.
`status`	View or print the status of the managed agents.
`purge`	Remove the Agent Installer Platform, Java, and Machine Agents and all configuration files from your machine.
`uninstall`	Remove the Agent Installer Platform, Java, and Machine Agents from your machine, but retain the configuration files.

View Command Flags

To view the available flags for a command, enter:

<install-directory> bin/zeroctl <command> -h

BASH

For example, to view the available flags for the install command, enter:

<install-directory> bin/zeroctl install -h

BASH

The output example displays the flags with the data type for the parameters and descriptions for the install command:

<install-directory> bin/zeroctl install -h
...
Install Agent Installer Platform


Usage:
  zeroctl install [flags]


Flags:
      --log-level string                 Logging level (choose from [panic fatal error warning info debug trace])
      --max-log-rate int                 Maximum log msg rate (default -2)
      --disable-instrumentors strings    Instrumentors to disable (choose from [java tomcat jboss glassfish weblogic websphere all])
      --enable-instrumentors strings     Instrumentors to enable (choose from [java tomcat jboss glassfish weblogic websphere all])
      --application string               Controller application name
      --account string                   Controller account name
      --access-key string                Account access key
      --service-url string               Service URL
      --javaagent string                 Java agent (choose from [dynamic ibm sun])
      --jboss-log-manager-modify         LogManager args for JBoss (choose from [true false])
      --proxy-url string                 Proxy URL
      --install-path string              Agent Installer Platform installation path (default "/opt/appdynamics/zeroagent")
      --systemd                          Install in systemd (default true)
  -h, --help                             help for install

BASH

Run Commands with Flags During and After Installation

You can run commands in the zeroctl binary after installation. To make changes during installation, add flags to the installation script.

For example, to configure the log level to info:

During installation (as a flag), enter:

sudo ./zero-agent.sh install --application 'AgentInstallerTestApp' --account 'project-zero' --access-key 'myaccesskey' --service-url 'https://test.saas.appd-test.com' --log-level=info

BASH

After installation (using the zeroctl executable), enter:
```
<install-directory> bin/zeroctl configure --log-level=info
```
BASH

Connect the Agent Installer Platform to a Proxy

The Agent Installer supports connections with unencrypted proxies only. To configure the zeroctl executable to use a proxy connection, enter:

<install-directory> bin/zeroctl configure --proxy-url=http://localhost:1001

BASH

Change Tier Names

The Agent Installer automatically creates a name for every instrumented tier. To create names, the installer extracts information from the Java process, such as the application server name.

Contact AppDynamics Support to change the name of an instrumented tier. Because an AppDynamics Support representative applies the changes, you need to create a new user named appd_rule_user, and then give appd_rule_user Install Agent permission only. This secures your sensitive data.

When you contact AppDynamics Support, provide the log in credentials for appd_rule_user.

Override `Systemd` Integration

If you do not want the Agent Installer to integrate with systemd in a sudo installation, add -systemd false to the install command (step 5a in Use the Agent Installer). For example:

sudo ./zero-agent.sh install --application 'AgentInstallerTestApp' --account 'project-zero' --access-key 'myaccesskey' --service-url 'https://test.saas.appd-test.com' --systemd=false

BASH

Maintain Continuous Operation with `watchdog`

The Agent Installer includes a watchdog process to ensure continued operation of these standalone agents and their related processes:

Agent Installer Platform Daemon
Machine Agent

If you integrate the Agent Installer with systemd, a profile is created for the watchdog process to ensure that it starts after a planned or unplanned reboot of the system. The systemd profile also restarts the watchdog process if it was terminated during regular operation.

If you do not integrate the Agent Installer with systemd (by setting --systemd=false), you can create a systemd profile after installation.

If you do not have a systemd profile, then you must start the watchdog process manually to ensure operation of the standalone agents and their related processes.

If you enabled the SELinux module on your system, then you must configure it to ensure that the watchdog and other Agent Installer Platform processes are not blocked.

To start the watchdog process, enter:

<install-directory> bin/zeroctl start

BASH

To stop the watchdog process, enter:

<install-directory> bin/zeroctl stop

BASH

See Agent Installer for more information.

Start or Stop Individual Agents

You can use the watchdog process to start and stop individual agents (Machine or Zero) on the Agent Installer Platform. You can also view or print the status of the managed agents.

For example, to start the Machine Agent, enter:

<install-directory> bin/zeroctl start machine
Starting Machine Agent 
...
Machine Agent started successfully

BASH

For example, to stop the Zero Agent, enter:

<install-directory> bin/zeroctl stop zero
Stopping Zero Agent 
... 
Zero Agent stopped successfully

BASH

To view or print the status of the managed agents, enter:

<install-directory> bin/zeroctl status

BASH