How do I install the agent silently? – DWService

This feature is not allowed by default. Please contact us at support@dwservice.net to authorize your account.

We show you the options of silent installation for the following situations:

- Windows
- Linux
- MacOS
- Proxy

Windows

You may install the agent silently by command lines. This way you can start the installer in two modes:

Using the installation code (you must first create the agent in your account):

dwagent.exe -silent key=xxx-xxx-xxx logpath=xxxxxx

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

key=xxx-xxx-xxx ⇒ This parameter allows you to specify which Agent you are installing. Instead of xxx–xxx–xxx, enter the Installation Code that was generated for you when you created the Agent. For example: key=123-456-789

Optional parameter:

logpath=xxxxxx ⇒ Use this parameter to specify the full path to the log file and the file name. This log file records the events of the installation process. In case of a possible error, also the error messages. For example: logpath=C:\install.log

An example: dwagent.exe -silent key=123-456-789 logpath=C:\install.log

Using credentials (You do not need to create the agent in the account):

dwagent.exe -silent user=xxxxxx password=xxxxxx name=xxxxxx logpath=xxxxxx

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

user=xxxxxx ⇒ This parameter controls which account the Agent is created in. Instead of xxxxxx, enter the username (email address) of the account. For example: user=your@email.com

password=xxxxxx ⇒ This parameter contains the Agent installation password. Instead of xxxxxx, enter the Agent installation password.
⚠️ Important: The Agent installation password cannot be the same as your account password.

Optional parameters:

name=xxxxxx ⇒ Use this parameter to specify the name of the Agent. Instead of xxxxxx, enter a name, which will be the name of the Agent. If you do not specify this parameter, the Agent will be installed with the name of the device. For example: name=WindowsPC

logpath=xxxxxx ⇒ Use this parameter to specify the full path to the log file and the file name. This log file records the events of the installation process. In case of a possible error, also the error messages. For example: logpath=C:\install.log

NOTE: The password parameter is not your account password. You can set this password in your DWService account.

Linux

You may install the agent silently by command lines. This way you can start the installer in two modes:

Using the installation code (you must first create the agent in your account):

dwagent.sh -silent key=xxx-xxx-xxx logpath=xxxxxx

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

key=xxx-xxx-xxx ⇒ This parameter allows you to specify which Agent you are installing. Instead of xxx–xxx–xxx, enter the Installation Code that was generated for you when you created the Agent. For example: key=123-456-789

Optional parameter:

An example: dwagent.sh -silent key=123-456-789 logpath=/tmp/install.log

Using credentials (You do not need to create the agent in the account):

dwagent.sh -silent user=xxxxxx password=xxxxxx name=xxxxxx logpath=xxxxxx

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

user=xxxxxx ⇒ This parameter controls which account the Agent is created in. Instead of xxxxxx, enter the username (email address) of the account. For example: user=your@email.com

Optional parameters:

NOTE: The password parameter is not your account password. You can set this password in your DWService account.

MacOS

For macOS, the silent installation process is different.

Here are the steps:

1. Create a script file. For example: dwagent.sh
2. Copy the script below and paste it into the file.
3. Modify your data in the script file (last line of the script – highlighted with colors).
4. Save the file.
5. Run the script file with the following command: sudo sh dwagent.sh

There are several types of scripts depending on the situation.

Using the installation code (you must first create the agent in your account), use the following script:

#!/bin/sh mkdir /var/tmp cd /var/tmp curl --location https://www.dwservice.net/download/dwagent_x86.dmg -o dwagent_x86.dmg hdiutil attach /var/tmp/dwagent_x86.dmg cp -r /Volumes/DWAgent/DWAgent.app /Applications/ hdiutil detach /Volumes/DWAgent rm /var/tmp/dwagent_x86.dmg cd /Applications/DWAgent.app /Applications/DWAgent.app/Contents/MacOS/extract chmod -R 755 /Applications/DWAgent.app /Applications/DWAgent.app/Contents/MacOS/install /Applications/DWAgent.app/ Y -silent key=xxx-xxx-xxx logpath=xxxxxx

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

Optional parameter:

If you are installing the Agent using Credentials and you specify the Agent name:

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

user=xxxxxx ⇒ This parameter controls which account the Agent is created in. Instead of xxxxxx, enter the username (email address) of the account. For example: user=your@email.com

Optional parameters:

If you are installing the Agent with Credentials and you do NOT specify the Agent name (in this case, the device name will be the Agent name):

#!/bin/sh name="name=""$(hostname -s)" mkdir /var/tmp cd /var/tmp curl --location https://www.dwservice.net/download/dwagent_x86.dmg -o dwagent_x86.dmg hdiutil attach /var/tmp/dwagent_x86.dmg cp -r /Volumes/DWAgent/DWAgent.app /Applications/ hdiutil detach /Volumes/DWAgent rm /var/tmp/dwagent_x86.dmg cd /Applications/DWAgent.app /Applications/DWAgent.app/Contents/MacOS/extract chmod -R 755 /Applications/DWAgent.app /Applications/DWAgent.app/Contents/MacOS/install /Applications/DWAgent.app/ Y -silent user=xxxxxx password=xxxxxx "${name}" logpath=xxxxxx

Required parameters:

-silent ⇒ This parameter indicates that you are installing the Agent silently.

user=xxxxxx ⇒ This parameter controls which account the Agent is created in. Instead of xxxxxx, enter the username (email address) of the account. For example: user=your@email.com

password=xxxxxx ⇒ This parameter contains the Agent installation password. Instead of xxxxxx, enter the Agent installation password.
⚠️ Important: The Agent installation password cannot be the same as your account password.

"${name}" ⇒ This variable contains the name of the device. Do not change this parameter, just leave it as it is.

Optional parameter:

NOTE: The password parameter is not your account password. You can set this password in your DWService account.

Proxy

Using a proxy is optional. It should be used when the Agent accesses the Internet through a proxy.

Proxy can be configured with the following parameters:

proxyType=xxxxxx proxyHost=xxxxxx proxyPort=xxxxxx proxyUser=xxxxxx proxyPassword=xxxxxx

Required parameters:

proxyType=xxxxxx ⇒ You can specify the type of the proxy with this parameter. This can be one of these:

- - HTTP
  - SOCKS5
  - SOCKS4
  - SOCKS4a

proxyHost=xxxxxx ⇒ With this parameter you can specify the address / path of the proxy.

proxyPort=xxxxxx ⇒ With this parameter you can specify the port used by the proxy.

proxyUser=xxxxxx ⇒ With this parameter you can specify the username used for the proxy.

proxyPassword=xxxxxx ⇒ With this parameter you can specify the password of the user used for the proxy.