This repository contains ElastiBuild and Beat Package Compiler. See Wiki for more information.
To report any problems encountered during installation, or to request features, please open an issue on GitHub and attach the MSI installation log if applicable.
For other questions of comments pleas refer to Elastic Forums. Please tag your question with windows-installer
(singlular).
msiexec /i "<full path to msi file>" /l!*vx "<full path to log file to be created>"
Please attach log file to the issue you create and provide as much information about your environment as you can.
For other general questions and comments, please use the Elastic discussion forum.
See ElastiBuild
NOTE: Building from source should only be done for development purposes. Only the officially distributed and signed Elastic Stack Installers should be used in production. Using unofficial Elastic Stack Installers is not supported.
Update version in Directory.Build.props
in the branch for the related minor version (ex: elastic#183).
- Create a branch for the next minor release from the main branch
- Update the main branch:
- Bump version in
Directory.Build.props
- Update
catalog-info.yaml
:- Add a new daily schedule for the new minor branch
- Remove the daily schedule for the previous minor branch ex: elastic#156 and elastic#172
- Bump version in
In case of problems during install / uninstall of agent, please refer to the Capturing Logs section which will enable troubleshooting.
During the install flow, The MSI installer will unpack the contents of the MSI to a temp folder and then will call the elastic-agent install
in order to:
- copy the files to the final destination at
c:\Program Files\Elastic\Agent
- register the agent as a windows service
- enroll the agent into fleet
In order to complete step 3 above, the MSI installer shall receive command line arguments, passed with INSTALLARGS command line switch followed by "
, for example:
elastic-agent.msi INSTALLARGS="--url=<fleet_url_with_port> --enrollment-token=<token>"
Note that the MSI will call the elastic-agent install
command with -f
(force) to avoid user interaction.
Similarly to the install flow (described above), the MSI will call the elastic-agent uninstall
command, and it's possible to pass arguments using INSTALLARGS
. One common use case is uninstalling an agent which has tamper protection enabled.
The Agent MSI doesn't support upgrade. Since the agents are fleet managed, upgrades shall be done using fleet (UI / API).