Configuration Options for .Net Agent

Install

Option Description Required Note
--additional_config Set the AdditionalConfig. No N/A
--agent_version string Set the AgentVersion. No N/A
--application_name string Set the ApplicationName. No Recommended to set to the actual application name.
--backup_dir string The 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.

 No N/A
--controller_account_access_key string Set the ControllerAccessKey. Yes N/A
--controller_account_name string Set the ControllerAccountName. Yes N/A
--controller_cert_file string Set the ControllerCertFile. No N/A
--controller_host_name string Set the ControllerHostName. Yes If using proxy, set appropriate proxy values.
--controller_port string Set the ControllerPort. Yes If not using proxy and enable_ssl is set to true, set controller_port=443. If using proxy, set appropriate proxy values.
--custom_ad_setup_file string Set the CustomADSetupFile. No N/A
--custom_config_path string Set the CustomConfigPath. No N/A
--download_protocol string Set the DownloadProtocol. No The default value is appd.
--download_uri string Set the DownloadURI. No The default value is https://download-files.appdynamics.com.
--enable_ssl Set the ControllerEnableSSL. No N/A
--group string Set the Group. No N/A
-h, --help help for dotnet_msi No N/A
--hostname string Set the Hostname. No N/A
--ini string config file No The default value is config.ini.
--install_agent_from string Set the InstallAgentFrom. No N/A
--keep_backup Set the KeepBackup. No N/A
--monitor_all_IIS_apps string Set the MonitorAllIISApps. No N/A
--reuse_config Set the ReuseConfig. No N/A
--temp_dir string Set 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. No N/A
--user string Set the User. No N/A
--windows_custom_agent_install_path string Set the AgentCustomInstallPath. No Recommended. The value should not be equal to <smart-agent-home-dir>/../dotnet-agent. If this value is not provided, the default is C:\Program Files\AppDynamics\AppDynamics .NET Agent.
--windows_install_root string Set the AppDDefaultInstallRoot. No N/A
--log-file string File to write logs to No The default value is C:\Users\<username>\AppData\Local\Temp\go-build1907265984\b002\exe\log.log.
--output-format string Log output format: json or console No The default value is json.
--remote Run the command on remote systems instead of locally No N/A
--verbose Enable verbose/debug logging No N/A

Uninstall

Option Description Required Note
--additional_config Set the AdditionalConfig. No N/A
--agent_version string Set the AgentVersion. No N/A
--application_name string Set the ApplicationName. No N/A
--backup_dir string The 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.

 No N/A
--controller_account_access_key string Set the ControllerAccessKey. Yes N/A
--controller_account_name string Set the ControllerAccountName. Yes N/A
--controller_cert_file string Set the ControllerCertFile. No N/A
--controller_host_name string Set the ControllerHostName. Yes If using proxy, set appropriate proxy values.
--controller_port string Set the ControllerPort. Yes If not using proxy and enable_ssl is set to true, set controller_port=443. If using proxy, set appropriate proxy values.
--custom_ad_setup_file string Set the CustomADSetupFile. No N/A
--custom_config_path string Set the CustomConfigPath. No N/A
--download_protocol string Set the DownloadProtocol. No The default value is appd.
--download_uri string Set the DownloadURI. No The default value is https://download-files.appdynamics.com.
--enable_ssl Set the ControllerEnableSSL. No N/A
--group string Set the Group. No N/A
-h, --help help for dotnet_msi No N/A
--hostname string Set the Hostname. No N/A
--ini string config file No The default value is config.ini.
--install_agent_from string Set the InstallAgentFrom. No N/A
--keep_backup Set the KeepBackup. No N/A
--monitor_all_IIS_apps string Set the MonitorAllIISApps. No N/A
--reuse_config Set the ReuseConfig. No N/A
--temp_dir string Set the TempDir. No N/A
--user string Set the User. No N/A
--windows_custom_agent_install_path string Set the AgentCustomInstallPath. No Recommended. The value should not be equal to <smart-agent-home-dir>/../dotnet-agent. If this value is not provided, the default is C:\Program Files\AppDynamics\AppDynamics .NET Agent.
--windows_install_root string Set the AppDDefaultInstallRoot. No N/A
--verbose Enable verbose/debug logging No N/A
--remote Run the command on remote systems instead of locally No N/A
--output-format string Log output format: json or console No The default value is json.
log-file string File to write logs to No The default value is C:\Users\<username>\AppData\Local\Temp\go-build1907265984\b002\exe\log.log.

Upgrade

Option Description Required Note
--additional_config Set the AdditionalConfig. No N/A
--agent_version string Set the AgentVersion. No N/A
--application_name string Set the ApplicationName. No Recommended to set to the actual application name.
--backup_dir string Set the AgentBackupDir. No N/A
--controller_account_access_key string Set the ControllerAccessKey. Yes N/A
--controller_account_name string Set the ControllerAccountName. Yes N/A
--controller_cert_file string Set the ControllerCertFile. No N/A
--controller_host_name string Set the ControllerHostName. Yes If using proxy, set appropriate proxy values.
--controller_port string Set the ControllerPort. Yes If not using proxy and enable_ssl is set to true, set controller_port=443. If using proxy, set appropriate proxy values.
--custom_ad_setup_file string Set the CustomADSetupFile. No N/A
--custom_config_path string Set the CustomConfigPath. No N/A
--download_protocol string Set the DownloadProtocol. No The default value is .
--download_uri string Set the DownloadURI. No The default value is https://download-files.appdynamics.com.
--enable_ssl Set the ControllerEnableSSL. No N/A
--group string Set the Group. No N/A
-h, --help help for dotnet_msi No N/A
--hostname string Set the Hostname. No N/A
--ini string config file No The default value is config.ini.
--install_agent_from string Set the InstallAgentFrom. No N/A
--keep_backup Set the KeepBackup. No N/A
--monitor_all_IIS_apps string Set the MonitorAllIISApps. No N/A
--reuse_config Set the ReuseConfig. No N/A
--temp_dir string Set 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. No N/A
--user string Set the User. No N/A
--windows_custom_agent_install_path string Set the AgentCustomInstallPath. No Recommended. The value should not be equal to <smart-agent-home-dir>/../dotnet-agent. If this value is not provided, the default is C:\Program Files\AppDynamics\AppDynamics .NET Agent.
--windows_install_root string Set the AppDDefaultInstallRoot. No N/A
--log-file string File to write logs to No The default value is C:\Users\<username>\AppData\Local\Temp\go-build1907225984\b002\exe\log.log.
--output-format string Log output format: json or console No The default value is json.
--remote Run the command on remote systems instead of locally No N/A
--verbose Enable verbose/debug logging No N/A