dynatrace oneagent installation parameters

If you install OneAgent using the Dynatrace Deploy page, this is already set to the correct value. --rack-name When you run the installer in interactive mode with command line parameters, the parameter values are presented as prompts (instead of defaults). I does not seem to work. To set the environment ID, pass it as a parameter value: To change the tenant after installation, use --set-tenant in the OneAgent command-line interface. Available on all supported platforms for OneAgent version 1.223+. This page describes how to download and install Dynatrace OneAgent on Windows. To install the dynatrace.oneagent Ansible collection, navigate to the directory where you have saved the Ansible collection tarball and run the following command: The collection consists of a single Ansible role, which deploys OneAgent using a dedicated configuration. Full path to the Dynatrace binaries directory. Using --set-host-name requires restart of OneAgent. You can use this parameter to automate Dynatrace Managed installation in a new data center. For example: To pass the configuration parameters through using the EXE installer, simply add the parameter and precede the value with the equals sign (=). The value must not be a child directory of, Existing files are not migrated to the new location, Can contain only alphanumeric characters, hyphens, underscores, and periods. To pass the parameters, append them to the installer command and separate them with spaces. You can change the installation path and other settings using the following parameters: --binaries-dir To set the communication endpoint, pass it as a parameter value: OneAgent and Dynatrace Cluster automatically maintain a working connection. Add the port number following a colon. When using the silent installation mode, the OneAgent installer should be pre-configured with appropriate parameter values, since interactive dialogs and prompts will not be displayed during installation. If you don't have a PaaS token, you can generate one right in the UI. The length of the string is limited to 256 characters. Use the get-auto-update-enabled parameter to check whether OneAgent auto-update is enabled: Set the --set-auto-update-enabled parameter to true or false to disable or enable OneAgent auto-update: Caution: after you use this command to disable auto-updates, you won't be able to control OneAgent automatic updates using the Dynatrace web UI at Settings > Preferences > OneAgent updates. If you install OneAgent using the Dynatrace Deploy page, this is already set to the correct value. For details, see Encrypting content with Ansible Vault. I look especially for another installation path than /opt and another directory for the dump savings. You can reset the network zone setting by passing an empty network zone name: Use the --get-network-zone parameter to display the current network zone configuration: You can pass the --set-* parameters at installation time. For example: The command saves the archive as the support_archive_agent_YYYY-MM-DD_hhmmss.zip file. The tool location depends on whether you customized the OneAgent installation using the parameter: The oneagentctl command accepts the get parameter to check the state or value of a setting, and the set parameter to change a setting. To change the host tags after installation, use --set-host-tag in OneAgent command-line interface. Configure your host proxy to allow localhost traffic going to the metric ingestion port, 14499 by default. Safely uninstalls Dynatrace Managed. To get the MSI package: When using the --unpack-msi parameter, no other installation parameters are allowed. If you have not specified any custom options, simply run the executable file and follow the instructions as displayed. To change the endpoint after installation, use --set-server in the OneAgent command-line interface. Add the --quiet parameter to run the MSI package extraction in quiet mode. To customize the log path, use the LOG_PATH parameter. Note that non-privileged mode requires Linux kernel capabilities that are available in these versions: Used in conjunction with the NON_ROOT_MODE parameter to block the superuser permission level for OneAgent run in the non-privileged mode. For example: The port is used by OneAgent REST API, Scripting integration (dynatrace_ingest), and Telegraf. For these specific parameters, the equivalent PARAM= syntax is no longer supported: INSTALL_PATH, LOG_PATH, DATA_STORAGE, PCAP_DRIVER and USER are a special kind of parameter adhering to MSI public property syntax. This type of installation is usually run in silent mode, as part of Group Policy deployment. The namespace can contain only alphanumeric characters, hyphens, underscores, and periods; the maximum length is 256 characters: For fresh OneAgent 1.195+ installations, the default, For fresh OneAgent deployments prior to version 1.195, OneAgent will use the, Updating the OneAgent preserves the previously configured user account. If you specify this location, metrics data will be kept here instead of in the main data location. Use this parameter to specify the administrator's email. Restart all processes that you want to monitor. Important: This command adds a custom host name to display in the UI, but the detected host name is not changed. The maximum length is 256 characters, including the key-value delimiter. Search for jobs related to Configuration application appcmd exe failed exit code or hire on the world's largest freelancing marketplace with 22m+ jobs. To define the source for host ID generation, use --set-host-id-source and set it to one of the predefined values: For example, to set the host ID source to ip-addresses and assign it to a namespace called test, run the OneAgent installer with the following parameter: To install OneAgent on a Citrix host, set the host ID source to mac-address: OneAgent can download system logs for the purpose of diagnosing issues that may be caused by conditions in your environment. One reason is security, while the other is automatic cleanup performed periodically by OneAgent, which could remove files created by other applications. You can also add the --set-param= parameters in the Configure OneAgent settings installation screen. The OneAgent Ansible role supports the following variables: Instead of being printed to STDOUT, the logs produced by Ansible can be collected into a single file located on the managed node. Depending on your firewall policy, you may need to explicitly allow certain outgoing connections. Creates entries in the Windows Registry that start OneAgent as a SYSTEM service. If you specify the group using the GROUP parameter, and a user doesn't exist, the installer creates the user and assigns it to the specified group. The tenant token that is used for authentication when OneAgent connects to the communication endpoint to send data. Is it possible to parameter the installation of the OneAgent? The maximum supported port range is from 1024 to 65535. The network zone name must not start with a dot. For more information, see Using collections in Ansible documentation. Disabling system log access limits our ability to diagnose and solve issues proactively. . The port range must cover at least 4 ports. For dynamic deployments that include frequently changing host instances and names (for example, AWS or MS Azure), you can use dedicated oneagentctl parameters to apply custom tags, names, and metadata to your hosts. Use this parameter if you want to start Dynatrace Managed upgrade from the command line. The values you enter during installation always take precedence. With this approach, you receive infrastructure-only health data, with no application or user performance data. To change the host metadata after installation, use --set-host-property OneAgent command-line interface. Organize your environment using host groups, OneAgent configuration via command-line interface, permission requirements for OneAgent installation and operation on Linux. HAProxy version 2.3.10 - Configuration Manual Since Intellectual property is an intangible legal asset. You can specify the node ID with the IP address. Using this parameter with SELinux enabled requires the semanage utility to be available on your system. If you change the installer names, make sure the script can distinguish them. With --agent-dir set to /data/dynatrace/, the installer creates the symbolic link /opt/dynatrace/oneagent -> /data/dynatrace and all OneAgent files are placed into the specified directory (in this example, /data/dynatrace). Default value: 1 (OneAgent version 1.193+. Use the --get-server parameter to display the endpoints that OneAgent is to send the data to. This later approach is mostly used in Group Policy deployment. The value must be an absolute path and must not point to the root volume directory. Select Ansible collection to download the collection tarball. For example: Your custom log path must meet the following requirements: If you use the parameter to change the location for an already installed OneAgent: Default value: /var/lib/dynatrace/oneagent/datastorage. You can run the Dynatrace Managed installer in any of the following modes: --install While this reduced set of privileges is enough for most of the extensions to operate, there are some that won't be able to produce data effectively (namely, extensions that collect Performance Monitor counters, such as MS SQL or .NET extensions). --ssl-ciphers "" --agent-system-user Use this parameter to check if the machine and operating system fulfills the requirements of the new version. These processes on Linux are called Network OneAgent and Plugin OneAgent. The port number starting the range must be lower. --svr-datastore-dir To reinstall OneAgent, uninstall it first or simply install a newer version. Use this parameter to provide the license key you obtained from the Dynatrace team. For OS-specific instructions, see Linux, Windows, or AIX. Organize your environment using host groups, Easily collect the diagnostic data for a specific host, Directly provide Dynatrace Support the details they need to diagnose the issue. To pass through the configuration parameters, simply add the parameter and precede the value with the equals sign (=). Add --restart-service to the command to restart OneAgent automatically. Additional list of platform-specific installation parameters, appended to `oneagent_install_args' when run on the respective platform. You can use other command line parameters to bypass some of the default settings.