Configuration Options for Machine Agent

This includes the custom configuration options for Machine Agent.

Install

OptionDescriptionRequiredNote
--agent_version stringSet the AgentVersion.NoN/A
--analytics_event_endpoint stringSet the AnalyticsEventEndpoint.NoN/A
--application_name stringSet the ApplicationName.NoN/A
--autostart_agentSet the AutostartAgent.NoThe default value is true.
--backup_dir stringThe agent backup directory.

This is used for saving the current directory of the agent to preserve and use during rollback.

The default value is the parent directory of the Smart Agent. For example,

If Smart Agent path is /opt/appdynamics/smartagent, the backup_dir path will be /opt/appdynamics/smartagent/backup.

NoN/A
--controller_account_access_key stringSet the ControllerAccessKey.YesN/A
--controller_account_name stringSet the ControllerAccountName.YesN/A
--controller_cert_file stringSet the ControllerCertFile.NoN/A
--controller_global_analytics_account_name stringSet the ControllerGlobalAnalyticsAccountName.NoN/A
--controller_host_name stringSet the ControllerHostName.YesIf using proxy, set appropriate proxy values.
--controller_port stringSet the ControllerPort.YesIf not using proxy and enable_ssl is set to true, set controller_port=443. If using proxy, set appropriate proxy values.
--dotnet_compatibility_mode stringSet the DotnetCompatibilityMode.NoN/A
--download_protocol stringSet the DownloadProtocol.NoThe default value is appd.
--download_uri stringSet the DownloadURI.NoThe default value is https://download-files.appdynamics.com.
--enable_analytics_agent stringSet the EnableAnalyticsAgent.NoN/A
--enable_orchestration stringSet the EnableOrchestration.NoThe default value is false.
--enable_sslSet the ControllerEnableSSL.NoN/A
--group stringSet the Group.NoN/A
-h, --helphelp for machineNo
--hostname stringSet the Hostname.NoN/A
--ini stringconfig fileNoThe default value is config.ini.
--install_agent_from stringSet the InstallAgentFrom.NoN/A
--java_system_properties stringSet the JavaSystemProperties.NoN/A
--keep_backupSet the KeepBackup.NoN/A
--{os}_custom_agent_install_path stringSet the AgentCustomInstallPath.NoRecommended. The Supported os types are linux and windows. If no value is provided, agent will install under <smart-agent-home-dir>/../machine-agent.
--{os}_install_root stringSet the AppDDefaultInstallRoot.NoThe Supported os types are linux and windows. For example, linux_install_root string.
--machine_hierarchy stringSet the MachineHierarchy.NoN/A
--node_name stringSet the NodeName.NoN/A
--sim_enabled stringSet the SimEnabled.NoThe default value is false.
--start_as_processSet the StartAsProcessPtr.NoN/A
--temp_dir stringSet the temporary directory. The default value is the temporary directory of the operating system. For example, /tmp for linux operating system. This is used to perform the tasks such as downloading the agent, unzipping the artifacts, during the install process. This directory gets cleaned up after the execution of the task.NoN/A
--tier_name stringSet the TierName.No
--user stringSet the User.NoN/A

Uninstall

OptionDescriptionRequiredNote
--agent_version stringSet the AgentVersion.NoN/A
--analytics_event_endpoint stringSet the AnalyticsEventEndpoint.NoN/A
--application_name stringSet the ApplicationName.NoN/A
--autostart_agentSet the AutostartAgent.NoThe default value is true.
--backup_dir stringThe agent backup directory.

This is used for saving the current directory of the agent to preserve and use during rollback.

The default value is the parent directory of the Smart Agent. For example,

If Smart Agent path is /opt/appdynamics/smartagent, the backup_dir path will be /opt/appdynamics/smartagent/backup.

YesN/A
--controller_account_access_key stringSet the ControllerAccessKey.YesN/A
--controller_account_name stringSet the ControllerAccountName.YesN/A
--controller_cert_file stringSet the ControllerCertFile.NoN/A
--controller_global_analytics_account_name stringSet the ControllerGlobalAnalyticsAccountName.NoN/A
--controller_host_name stringSet the ControllerHostName.YesIf using proxy, set appropriate proxy values.
--controller_port stringSet the ControllerPort.YesIf not using proxy and enable_ssl is set to true, set controller_port=443. If using proxy, set appropriate proxy values.
--dotnet_compatibility_mode stringSet the DotnetCompatibilityMode.NoN/A
--download_protocol stringSet the DownloadProtocol.NoThe default value is appd.
--download_uri stringSet the DownloadURI.NoThe default value is https://download-files.appdynamics.com.
--enable_analytics_agent stringSet the EnableAnalyticsAgent.NoN/A
--enable_orchestration stringSet the EnableOrchestration.NoThe default value is false.
--enable_sslSet the ControllerEnableSSL.NoN/A
--group stringSet the Group.NoN/A
-h, --helphelp for machineNoN/A
--hostname stringSet the Hostname.NoN/A
--ini stringconfig fileNoThe default value is config.ini.
--install_agent_from stringSet the InstallAgentFrom.NoN/A
--java_system_properties stringSet the JavaSystemProperties.NoN/A
--keep_backupSet the KeepBackup.NoN/A
--{os}_custom_agent_install_path stringSet the AgentCustomInstallPath.NoRecommended. The Supported os types are linux and windows. If no value is provided, agent will install under <smart-agent-home-dir>/../machine-agent.
--{os}_install_root stringSet the AppDDefaultInstallRoot.NoThe Supported os types are linux and windows. For example, linux_install_root string.
--machine_hierarchy stringSet the MachineHierarchy.NoN/A
--node_name stringSet the NodeName.NoN/A
--sim_enabled stringSet the SimEnabled.NoThe default value is false.
--start_as_processSet the StartAsProcessPtr.NoN/A
--temp_dir stringSet the temporary directory. The default value is the temporary directory of the operating system. For example, /tmp for linux operating system. This is used to perform the tasks such as downloading the agent, unzipping the artifacts, during the install or upgrade process. This directory gets cleaned up after the execution of the task.NoN/A
--tier_name stringSet the TierName.NoN/A
--user stringSet the User.NoN/A

Upgrade

OptionDescriptionRequiredNote
--agent_version stringSet the AgentVersion.NoN/A
--analytics_event_endpoint stringSet the AnalyticsEventEndpoint.NoN/A
--application_name stringSet the ApplicationName.NoN/A
--autostart_agentSet the AutostartAgent.NoThe default value is true.
--backup_dir stringSet the AgentBackupDir.YesN/A
--controller_account_access_key stringSet the ControllerAccessKey.YesN/A
--controller_account_name stringSet the ControllerAccountName.YesN/A
--controller_cert_file stringSet the ControllerCertFile.NoN/A
--controller_global_analytics_account_name stringSet the ControllerGlobalAnalyticsAccountName.NoN/A
--controller_host_name stringSet the ControllerHostName.YesIf using proxy, set appropriate proxy values.
--controller_port stringSet the ControllerPort.YesIf not using proxy and enable_ssl is set to true, set controller_port=443. If using proxy, set appropriate proxy values.
--dotnet_compatibility_mode stringSet the DotnetCompatibilityMode.NoN/A
--download_protocol stringSet the DownloadProtocol.NoThe default value is appd.
--download_uri stringSet the DownloadURI.NoThe default value is https://download-files.appdynamics.com.
--enable_analytics_agent stringSet the EnableAnalyticsAgent.NoN/A
--enable_orchestration stringSet the EnableOrchestration.NoThe default value is false.
--enable_sslSet the ControllerEnableSSL.NoN/A
--group stringSet the Group.NoN/A
-h, --helphelp for machineNoN/A
--hostname stringSet the Hostname.NoN/A
--ini stringconfig fileNodefault "config.ini"
--install_agent_from stringSet the InstallAgentFrom.NoN/A
--java_system_properties stringSet the JavaSystemProperties.NoN/A
--keep_backupSet the KeepBackup.NoN/A
--{os}_custom_agent_install_path stringSet the AgentCustomInstallPath.NoRecommended. The Supported os types are linux and windows. If no value is provided, agent will install under <smart-agent-home-dir>/../machine-agent.
--{os}_install_root stringSet the AppDDefaultInstallRoot.NoThe Supported os types are linux and windows. For example, linux_install_root string.
--machine_hierarchy stringSet the MachineHierarchy.NoN/A
--node_name stringSet the NodeName.NoN/A
--sim_enabled stringSet the SimEnabled.NoThe default value is false.
--start_as_processSet the StartAsProcessPtr.NoN/A
--temp_dir stringSet the temporary directory. The default value is the temporary directory of the operating system. For example, /tmp for linux operating system. This is used to perform the tasks such as downloading the agent, unzipping the artifacts, during the install or upgrade process. This directory gets cleaned up after the execution of the task.NoN/A
--tier_name stringSet the TierName.NoN/A
--user stringSet the User.NoN/A