diff --git a/docs/en/ingest-management/commands.asciidoc b/docs/en/ingest-management/commands.asciidoc index cdb64e5e3..eae33a855 100644 --- a/docs/en/ingest-management/commands.asciidoc +++ b/docs/en/ingest-management/commands.asciidoc @@ -11,10 +11,17 @@ doing common tasks. The commands listed here apply to both <> and <> {agent}. -NOTE: You might need to log in as a root user (or Administrator on Windows) to -run these commands. After the {agent} service is installed and running, make -sure you run these commands without prepending them with `./` to avoid +[IMPORTANT] +.Restrictions +==== +Note the following restrictions for running {agent} commands: + +* You might need to log in as a root user (or Administrator on Windows) to +run the commands described here. After the {agent} service is installed and running, +make sure you run these commands without prepending them with `./` to avoid invoking the wrong binary. +* Running {agent} commands using the Windows PowerShell ISE is not supported. +==== * <> * <> diff --git a/docs/en/ingest-management/elastic-agent/install-elastic-agent.asciidoc b/docs/en/ingest-management/elastic-agent/install-elastic-agent.asciidoc index 5883bc697..b75c424e7 100644 --- a/docs/en/ingest-management/elastic-agent/install-elastic-agent.asciidoc +++ b/docs/en/ingest-management/elastic-agent/install-elastic-agent.asciidoc @@ -1,6 +1,20 @@ [[elastic-agent-installation]] = Install {agent}s +[IMPORTANT] +.Restrictions +==== +Note the following restrictions when installing {agent} on your system: + +* You can install only a single {agent} per host. Due to the fact that the {agent} may read data sources that are only accessible by a superuser, {agent} will therefore also need to be executed with superuser permissions. +* You might need to log in as a root user (or Administrator on Windows) to +run the commands described here. After the {agent} service is installed and running, +make sure you run these commands without prepending them with `./` to avoid +invoking the wrong binary. +* Running {agent} commands using the Windows PowerShell ISE is not supported. +==== + + NOTE: You can install only a single {agent} per host. Due to the fact that the {agent} may read data sources that are only accessible by a superuser, {agent} will therefore also need to be executed with superuser permissions.