Note that all parameters listed below are optional. --license To enable Infrastructure monitoring mode, set the parameter to: To disable Infrastructure monitoring mode, set the parameter to: To change, enable, or disable Infrastructure monitoring mode after installation, use --set-infra-only in OneAgent command-line interface or set it using the Host settings page. Use the --get-system-logs-access-enabled parameter to check whether access to system logs is enabled: Set the --set-system-logs-access-enabled parameter to true or false to disable or enable access to system logs: Note that the --set-system-logs-access-enabled and --get-system-logs-access-enabled parameters refer to a self-diagnostics setting and are not related to Log Monitoring. Add --restart-service to the command to restart OneAgent automatically. It's free to sign up and bid on jobs. --set-app-log-content-access=true. The default for new nodes is on. One last thing: to monitor your processes, you need to restart them. The remote Dynatrace addresses to add to the allow list are given on the installation page for OneAgent. Click the Start installation button and select Windows. The port range must cover at least 4 ports. Default value: /var/opt/dynatrace-managed/server/ To set a token, pass it as a parameter value: See Access tokens to learn how to obtain a token. Use this parameter to install with default settings in non-interactive mode. For example: The installer creates the symbolic link /opt/dynatrace/oneagent > /data/dynatrace/agent and the OneAgent installation files are placed in the specified directory (in this example, /data/dynatrace/agent). --sudo-cmd "" Allows installation of self-monitoring OneAgent to a different directory. For example: Full path to the Dynatrace installation space directory. Use the --get-proxy parameter to display the currently defined proxy OneAgent connects through: OneAgent consists of different processes that communicate via a TCP port with a watchdog. This is the recommended setting to use for all OneAgent Windows installations starting with OneAgent version 1.191. If you install OneAgent using the Dynatrace Deploy page, this is already set to the correct value. The directory contains the following playbooks: In addition, each directory contains an inventory file with a basic host configuration for playbooks. Use the --get-server parameter to display the endpoints that OneAgent is to send the data to. If an endpoint detail changes, the cluster notifies OneAgent of the change and OneAgent automatically updates the endpoint you set using the --set-server to the new working value. To learn about network zone naming rules and other reference information, see Network zones. To enable Infrastructure Monitoring mode: Changing the Infrastructure Monitoring mode requires restart of OneAgent, as well as restart of all monitored services. For more information, see OneAgent configuration via command-line interface. For example: .\Dynatrace-OneAgent-Windows.exe USER=LocalService. If your machine uses a network HTTPS proxy with self-signed certificate, you have to extend trusted certificates store. For details, see System logs downloaded by OneAgent. 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. Once configured, custom metadata is displayed as a set of properties at the bottom of the Properties and tags section of the host overview page. The default value is on. Use the --set-host-group parameter with an empty value to clear the host group assignment: Use the --get-host-group parameter to display the current host group assignment: Within dynamic or large environments, manual host tagging can be impractical. If you install OneAgent using the Dynatrace Deploy page, this is already set to the correct value. Install the Dynatrace Ansible collection Set the --set-fips-enabled parameter to true or false to enable or disable the FIPS 140 validated cryptographic algorithms on OneAgent. Use the --set-network-zone parameter to instruct OneAgent to communicate via the specified network zone. --network-proxy-cert-file Download the installer. For OS-specific instructions, see Linux, Windows, or AIX. It's particularly important to keep you host ID static in dynamic virtual environments where hosts are recreated on a daily basis. If a tag passed in the command doesn't exist, a non-zero exit code is returned, but all the existing tags passed in the command are removed. With this approach, you receive infrastructure-only health data, with no application or user performance data. The path of the OneAgent installer stored on the control node. To install the dynatrace.oneagent Ansible collection, navigate to the directory where you have saved the Ansible collection tarball and run the following command: shell copy download ansible-galaxy collection install dynatrace-oneagent-ansible-1.20200101-060000.tar.gz --rack-dc . The installer can also be extracted and used directlyas an MSI package. 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. --cluster-ip Click the Start installation button and select Windows. The maximum supported port range is from 1024 to 65535. The value must not be an already existing symbolic link. At startup, OneAgent watchdog attempts to open the first available port between port 50000 and 50100. Authentication token for connection to seed node. This option will uninstall any installation of WinPcap or outdated Npcap previously installed by OneAgent. This user is a member of the Performance Monitoring Users group, and can only log in as a service. For more information on command-line syntax, see Silent installation. Dynatrace OneAgent installation parameters defined as a list of items. as a seperator. If your machine has more than one network interface you need to decide which network interface will be used for Dynatrace Cluster traffic and put its IP4 address here. Use the --set-server parameter to set a OneAgent communication endpoint. For OneAgent version 1.221 and earlier, this feature is supported only for Citrix Virtual Apps and Desktops. Search for jobs related to Configuration application appcmd exe failed exit code or hire on the world's largest freelancing marketplace with 22m+ jobs. Then, you have to create a distribution point, assign a package (the OneAgent MSI package with parameters), specify a command to install the MSI package as silent installation, and publish your policy. Use this parameter if you want to start Dynatrace Managed upgrade from the command line. Is it possible to parameter the installation of the OneAgent? The host name value must not contain the <, >, &, CR (carriage return), and LF (line feed) characters and the maximum length is 256 characters. It is allowed to define tags with the same key but different values. This token is valid for three hours. For more information, see update OneAgent topics for Linux, Windows, and AIX. --set-system-logs-access-enabled=true enables access to logs. To add or change host properties, run the following command: You can add or change more than one property in the same command. Git. --network-proxy --initial-last-name For sample usage, see the local_installer.yml file in Examples. 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. Default value: /var/opt/dynatrace-managed/elasticsearch The default value is dynatrace:dynatrace. Dynatrace OneAgent OneAgent is responsible for collecting all monitoring data within your monitored environment. The address of the proxy server. You can't reinstall OneAgent using the same installer version as was used to install the currently installed OneAgent. Changing the metric ingestion port requires restart of OneAgent. For rack aware deployments, provide the data center that contains the rack where you want to add the node. To set up silent command-line installation when using an MSI package, add /quiet /qn as in these examples: Note the --% stop-parsing symbol used in the PowerShell command. deprecated no_create disabled user creation when installing OneAgent prior to OneAgent version 1.209. You can set the --set-auto-injection-enabled= parameter to true or false to disable or enable OneAgent auto-injection. 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. At any time, you can check which processes aren't monitored and need to be restarted. 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. To set a proxy, pass it as a parameter value: To change or clear the proxy address after installation, use --set-proxy in the OneAgent command-line interface. For example: The change might not be reflected in the Dynatrace web UI for up to 6 minutes. --self-check The UI of the OneAgent installer for Windows supports only the --set-param= parameters. As a result, all OneAgent modules, including all extensions, are fully functional. Hi Team, I could see "Agent is not available" message on some of easyTravel services which are running. If an endpoint detail changes, the cluster notifies OneAgent of the change and OneAgent automatically updates the endpoint you set using the --set-server to the new working value. You can also use the restart parameter on its own, without other parameters. To remove tags, run the following command: You can remove more than one tag with the same command. Replaces the default definition. Copy and run the command. Starting with the version 1.209, when you use the dtuser parameter, the OneAgent installer applies the LocalSystem parameter without any warning. With the diagnostic data collected for OneAgent, you can: The command requires the OneAgent service to be running. Should contain the variable $CMD (typed as \$CMD). By default the following is used: /usr/bin/sudo \$CMD. During the installation process, the installer: Installs executable code and libraries that are used by OneAgent. Use the --set-extensions-ingest-port= parameter to set a custom local ingestion port. deprecated dtuser was the default user account used to run OneAgent extensions prior to OneAgent version 1.195. --registration-token You only need root rights to start OneAgent installation. The Ansible script requires access to the appropriate OneAgent installer files. This page describes how to download and install Dynatrace OneAgent on Windows. The namespace can contain only alphanumeric characters, hyphens, underscores, and periods; the maximum length is 256 characters. --hosts You can use the --set-extensions-statsd-port= parameter to change the default DynatraceStatsD UDP listening port. Use ansible-galaxy install dynatrace.oneagent to install the latest stable release of the role on your system. You will need to specify the variables to supply the Ansible role with the information required to authenticate the API call in your environment: We recommend that you store both the PAAS-token and the environment-id securely, using encryption mechanisms such as Ansible Vault. An asterisk (*) indicates the endpoint to which OneAgent currently sends the data. Use the USER parameter to define the user running the process responsible for Dynatrace OneAgent extensions functionality. 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. Use the --get-tenant-token parameter to display the currently defined token: Use the --set-proxy parameter to set a proxy server: Use the --set-proxy parameter set to an empty value to clear proxy configuration: Restart OneAgent service to apply changes. Starting with OneAgent version 1.239, the dtuser setting is converted to LocalSystem for existing installations when running an update. This option can alternatively be enabled/disabled through the Web UI. Always use in combination with --set-tenant. Note that you can restart your processes at any time, even during your organizations next planned maintenance period. --install-new-dc-silent Command line parameters can also help you install or update SSL certificates on Dynatrace Managed. To switch an installed OneAgent to non-privileged mode, you need to manually append the NON_ROOT_MODE=1 parameter to the installation command. If set to. The property values must not contain the = (except key-value delimiter) and whitespace characters. optional Customize your installation Option to require certificates. Changing the metric ingestion port requires restart of OneAgent. Use the --version parameter to display the OneAgent version. If you don't specify the GROUP parameter, the installer assumes it's the same as the USER, for both existing and non-existing users. Dynatrace provides an Ansible collection that you can use to orchestrate OneAgent deployment in your environment. This option will NOT uninstall or overlay any existing installation of Npcapor WinPcap. The user name and group name of the system user who is authorized to run Dynatrace processes. Spaces are used to separate tag values. 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. We recommend that you use a dedicated drive or partition for this directory. You can use this parameter to automate Dynatrace Managed installation in a new data center. To set a token, pass it as a parameter value: See Access tokens to learn how to obtain a token. Effectively, no local user account is created. Use the --get-watchdog-portrange parameter to check the current port range defined for the watchdog. Activates Infrastructure monitoring mode, in place of full-stack monitoring mode. --initial-environment I look especially for another installation path than /opt and another directory for the dump savings. If a user and a group with the same name both exist and this user has that group set as its primary one, the user is used to start the OneAgent network and plugin modules. 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 use the parameter to change the location for an already installed OneAgent: Default value: %PROGRAMDATA%\dynatrace\oneagent\datastorage. Definition of ciphers accepted by SSL connections. Use the --set-auto-update-enabled= to enable or disable OneAgent auto-update. The maximum length is 256 characters, including the key-value delimiter. Command that should be used for executing system commands with superuser privileges. This option will NOT uninstall or overlay any existing installation of Npcapor WinPcap. Previously, the OneAgent has been installed in C:\Program Files (x86) but recently, it has been found in C:\Program Files taking all of it's files with it (including the dynatrace_ingest tool). The LOG_PATH parameter allows you to customize your OneAgent log directory. Token used for registration in Mission Control (optional for regular installation). But it would be good if this was documented somewhere. If you want to enable FIPS mode for application-only deployment, go to /paas/package/agent and delete dt_fips_disabled.flag. --install-agent This option can alternatively be enabled/disabled through the Web UI. The configuration ensures that the OneAgent service remains in a running state. Add --restart-service to the command to restart OneAgent automatically (version 1.189+) or stop and start OneAgent process manually. When you use the set parameters, you need to restart OneAgent service to apply changes. 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. To change the host tags after installation, use --set-host-tag in OneAgent command-line interface. Prerequisite: Using this parameter when SELinux is enabled requires the semanage utility to be available on your system. --svr-datastore-dir It asks you either to confirm the default settings or provide your own values. Endpoints are separated by a semicolon (;). --seed-ip For OneAgent version 1.221 and earlier, this feature is supported only for Citrix Virtual Apps and Desktops. You can use this parameter to automate Dynatrace Managed installation. Note: this command will only work with PowerShell 3.0 and TLS 1.2 (or .later). When you install OneAgent in non-privileged mode, you only need to grant elevated privileges to OneAgent during the installation. Gets only the read, write, and execute permission to the files needed. Restart all processes that you want to monitor. For example: --no-start (Upgrade only) Using this parameter on Linux when SELinux is enabled requires the semanage binary to be available on your system. Your custom installation directory must meet the following requirements: Default value: %PROGRAMDATA%\dynatrace\oneagent\log. To make the configuration as secure as possible, Dynatrace creates a unique Linux system user of Dynatrace Managed services. The directory must be dedicated to OneAgent purposes only. Timeout, in seconds, for rebooting the managed node. When deploying Dynatrace on Windows Server Domain Controller, make sure the USER parameter is set to LocalSystem, or alternatively LocalService, to avoid propagation of dtuser across the domain, which can cause interference with existing dtuser accounts on hosts that have Dynatrace installed. I does not seem to work. If you have SELinux enabled, the following parameters require the semanage utility to be available on your system. sudo /bin/sh Dynatrace-OneAgent-Linux-1.0.0.sh NON_ROOT_MODE=1 DISABLE_ROOT_FALLBACK=1. Optionally, you can set a custom directory and timeframe with the directory and days parameters. ./oneagentctl --get-fips-enabled, On Windows If you don't specify a local installer, the script attempts to use the direct download method. If you specify this location, metrics data will be kept here instead of in the main data location. Starting with Dynatrace Managed 1.216, do not use /opt/dynatrace as an installation path for Dynatrace Managed binaries. The Ansible script will then copy the installer files to the managed nodes during execution. This provides the script with local copies of the installers. To change the host tags after installation, use --set-host-tag in OneAgent command-line interface. LocalService: This parameter makes OneAgent use the NT AUTHORITY\LOCAL SERVICE system account to run OneAgent extensions. Installs the Dynatrace OneAgent package with the selected parameters and manages its config files. Note that this symbolic link needs to be removed manually, once OneAgent has been uninstalled. --set-app-log-content-access=true. Though until all processes have been restarted, youll only see a limited set of metrics, for example CPU or memory consumption. If you don't configure specific paths for any of the other data stores, all Dynatrace data will be kept here.