DWService - Docs

ℹ️ Log files may vary depending on the situation and may be located in different places:

• Log file in the case of an installed Agent
• Log file in the case of a running Agent
• Log file during installation
• Log file for silent installation

💡Log files are plain text files that can be opened with any text editor (mostly even remotely).

---

Log file in the case of an installed Agent

1️⃣ The Agent has a log file that records events related to the Agent. If the Agent has been installed using the default path, depending on the operating system, the log file is as follows:

• Windows ⇒ C:\Program Files\DWAgent\dwagent.log
• Linux ⇒ /usr/share/dwagent/dwagent.log
• MacOS ⇒ /Library/DWAgent/dwagent.log

In case of an error, the log file may contain valuable information about the problem. For example: connection error, file loading error, etc.

2️⃣ The Agent also has a log file related to the DWAgent service. If the Agent has been installed using the default path, depending on the operating system, the log file is as follows:

• Windows ⇒ C:\Program Files\DWAgent\native\service.log
• Linux ⇒ /usr/share/dwagent/native/service.log
• MacOS ⇒ /Library/DWAgent/native/service.log

---

Log file in the case of a running Agent

ℹ️ When the Agent is running, a folder named dwagentonfly is created in the operating system’s temporary folder.

1️⃣ The Agent has a log file that records events related to the Agent. Depending on the operating system, the log file is as follows:

• Windows ⇒ %TEMP%\dwagentonfly\dwagent.log
• Linux ⇒ /tmp/dwagentonfly/dwagent.log
• MacOS ⇒ /$TMPDIR/dwagentonfly/dwagent.log

In case of an error, the log file may contain valuable information about the problem. For example: connection error, file loading error, etc.

2️⃣ The Agent also has a log file related to the DWAgent service. The log file is as follows:

• Windows ⇒ %TEMP%\dwagentonfly\native\service.log
• Linux ⇒ /tmp/dwagentonfly/native/service.log
• MacOS ⇒ /$TMPDIR/dwagentonfly/native/service.log

---

Log file during installation

ℹ️ When installing an Agent, a folder is created in the temporary folder of the operating system, which contains the log file. Depending on the operating system, the log file is as follows:

• Windows ⇒ %TEMP%\dwagentxxxxxxxxxxxxxx\install.log
• Linux ⇒ /tmp/dwagent_installxxxxxxxxxxxxxx/install.log
• MacOS ⇒ /$TMPDIR/dwagentinstallxxxxxxxxxxxxxx/install.log

Note: In the folder name, the xxxxxxxxxxxxxx is the date and time (yyyymmddhhmmss) when the installer was launched. For example: dwagent20250801123456

If you open the log file with a text editor, you can find out whether the installation process was successful. If there was a problem, you can find out where and why the installation process failed.

---

Log file for silent installation

ℹ️ During silent installation, you have the possibility to create a log file that records the steps of the installation process. In case of installation problems, this file can help you find out where the process got stuck. 

To do this, the command must also include the following switch during silent installation: logpath=xxxxxx, for example: logpath=C:\install.log

If you execute the command in this way during silent installation, the log file will be created with the path and name you specified.

📖 You can read more about silent installation in this documentation: How do I install the agent silently?

---

📧 If you encounter a problem and the log files do not provide you with useful information, please send us the log file as an attachment to support@dwservice.net, and we will do our best to help you find the cause of the problem and thus the solution.

When you connect to a remote device, a notification is displayed on the remote device by default.

Depending on the activity, 1-4 icons will appear on the right edge of the screen.

The icons can be one of the following:

The meaning of the icons:

1 ⇒ This icon appears when someone is connected to the Agent.

2 ⇒ This icon appears when someone is using the Screen application, i.e. viewing the contents of the screen.

3 ⇒ This icon appears when someone is using the Shell application.

4 ⇒ This icon appears when someone is copying data (uploading or downloading).

These icons are visible by default. The behavior can be changed by configuring the Agent.

Configuration

The configuration of Desktop Notifications is as follows:

Open Monitor.

1.  Click on the Configure button.

The Wizard will start.

 

2. Select Configure monitor.

3. Click Next.

4. Select Desktop notification.

5. Click Next.

The following three options appear:

Explanation of the options:

6. Visible – The notification is displayed continuously during the connection.

7. Automatically hide – The notification is displayed when connected and then automatically hidden.

8. None – The notification does not appear at all during the connection.

9. Click Next.

10. Click Close.

⚠️ For this change to take effect, the user must logout and login again. Or restart the device.

Watch the configuration process in our tutorial video on YouTube:

The Connection info button is available on the toolbar in the Screen application.

If you click on the button, a small window will appear in the top left corner displaying information about the connection.

We will now explain the meaning of each piece of information, which will allow you to better understand the data it contains.

FENC ⇒ Frame Encoder. ⇒ The way the frames are processed. Possible values are:
PALCMP_V1 ⇒ old, obsolete version
TJPEG_V1 ⇒ Turbo jpeg Version 1
TJPEG_V2 ⇒ Turbo jpeg Version 2 (default)

QA ⇒ Quality of the FENC (Frame Encoder) ⇒ Possible values are: 0-9
The higher the number, the better the quality.
If Minimum quality is selected from the drop-down list on the toolbar, this value is always 0.
If Low quality is selected from the drop-down list on the toolbar, this value is always 3.
If Medium quality is selected from the drop-down list on the toolbar, this value is always 6.
If Maximum quality is selected from the drop-down list on the toolbar, this value is always 9.
If Auto Quality is selected from the drop-down list on the toolbar, this value will constantly change between 0 and 9, in order to get the best quality for the current bandwidth.
A high number means better quality, but requires more bandwidth.

FPS ⇒ Frames Per Second (User side) ⇒ The number of frames displayed per second. The higher the number, the better the quality.
⚠️ Note: The DWService sends frames only when necessary. This means that if there is no change on the screen, no frames will be sent. This means that the value can be 0 even if the quality of the connection is good and the bandwidth is sufficient. In other words, a small value does not necessarily indicate an error.
When troubleshooting, it is recommended to start a video on the remote device and monitor this value. If this value is low, it means that the browser is slow to display the frames.

FPSCAP ⇒ Frames Per Second (Agent side) ⇒ Frame Per Second Capturing ⇒ This means how many frames the agent is capturing in one second. The higher the number, the better the quality.
⚠️ Note: The DWService sends frames only when necessary. This means that if there is no change on the screen, no frames will be sent. This means that the value can be 0 even if the quality of the connection is good and the bandwidth is sufficient. In other words, a small value does not necessarily indicate an error.
When troubleshooting, it is recommended to start a video on the remote device and monitor this value. If this value is low, it means that the remote device image capture process is slow, typically due to old hardware.

BPS ⇒ Bits Per Second ⇒ The amount of data transferred.
When troubleshooting, it is recommended to start a video on the remote device and monitor this value. The higher the value, the better.

TDIFF ⇒ This value shows lag time from Agent. This value is displayed in milliseconds.

FDIFF ⇒ This value shows lag frame from Agent.

PING ⇒ This value shows how long it takes a data packet to make a round trip. One of the indicators of the quality of your internet connection. This value is displayed in milliseconds. The lower the value, the better.

In case you choose this installation method, you should follow our next guide, step-by-step.

1. Visit our website: https://www.dwservice.net

2. Login to your account. You can read more about the login process here: Login

3. You will see your dashboard:

4. On your Dashboard, select Agents.

After selecting Agents, this will be displayed:

5. From the menu on the left, select the All option.
6. Click the + (Plus) sign.

The following window will appear:

7. The selection of Group is optional. If you do not wish to add the agent to a group, simply leave this field blank. If you want to add the Agent to a group, select the desired group from the drop-down menu. If there is no Group in the drop-down menu that suits you, you can create a new Group by selecting Groups in the Dashboard. For more details, click here.
8. Give a name to the Agent you want to create.
9. Optionally, you can provide a Description of the Agent, which will help you to identify the Agent later.
10. To create the Agent, click the Confirm button.

After the window closes, you will see this:

As you can see in the image above, the completed Agent is displayed, which contains a generated Installation Code. Each time you create an Agent, the system will generate such a code (consisting of numbers) for you. You must use this code during the Agent installation process.

After successfully creating the Agent, let’s see how to install the Agent.
In case you use a Linux with Desktop Environment, Start the Terminal application:

11. Open the folder where you want to install the Agent. For example, the Downloads folder.
⚠️ Note: Folders are case sensitive.

Now, let’s download the Agent:

12. You can use the wget command to download the Agent:
wget -N https://www.dwservice.net/download/dwagent.sh

💡 Using -N, if the folder already contains a dwagent.sh file, it will be overwritten.

13. If you are using Linux that does not include a Desktop Environment, type sudo bash dwagent.sh and hit Enter.
If you are using Linux that includes a Desktop Environment, type sudo bash dwagent.sh -console and hit Enter.

14. Enter the password for the Linux user.
⚠️ Note: The system does not display the way you type the characters. But just type the password. Then press Enter.

A wizard will be launched to guide you through the installation process.
💡 In the wizard, you can step back one step by typing #BACK at the prompt and then pressing Enter. To exit the wizard, type #EXIT at the prompt and press Enter.

15. From the options, select the option Install, which is option 1. Then press Enter.

16. Here you can change the path where the Agent will be installed.
The default path is: /usr/share/dwagent
If you want to install the Agent in the default folder, just hit Enter.

17. To confirm the installation path, from the options, select Yes, which is option 1. Then press Enter.

18. From the two installation options, select the option Enter the installation code, which is option 1. Then hit Enter.

19. Enter the installation code that our system generated for you when you created the Agent. Then hit Enter.

As you can see in the picture above, the installation has been successfully completed. The Agent is ready to use.

Switch back to the account.

20. In the menu on the left, select All.
21. The Agent is available. You can connect to the agent by clicking on it.

This brings us successfully to the end of the installation process.
Use it with maximum satisfaction.

 

In case you choose this installation method, you should follow our next guide, step-by-step.

1. Visit our website: https://www.dwservice.net

2. Login to your account. You can read more about the login process here: Login

3. You will see your dashboard:

4. On your Dashboard, select My Account.

After selecting My Account, this will be displayed:

5. From the menu on the left, select Account.
6. Enter the Agent installation password, which you will be asked to enter when you install the Agent.
⚠️ Important: For security reasons, this password cannot be the same as your account password. Choose a different password.
7. To save the password, click the Update credentials button.
The following window will appear:

8. Click on the Ok button.

Now let’s see how to install the Agent.
In case you use a Linux with Desktop Environment, Start the Terminal application:

9. Open the folder where you want to install the Agent. For example, the Downloads folder.
⚠️ Note: Folders are case sensitive.

Now, let’s download the Agent:

10. You can use the wget command to download the Agent: wget -N https://www.dwservice.net/download/dwagent.sh
❗ Using -N, if the folder already contains a dwagent.sh file, it will be overwritten.

11. If you are using Linux that does not include a Desktop Environment, type sudo bash dwagent.sh and hit Enter.
If you are using Linux that does include a Desktop Environment, type sudo bash dwagent.sh -console and hit Enter.

12. Enter the password for the Linux user.
⚠️ Note: The system does not display the way you type the characters. But just type the password. Then press Enter.

A wizard will be launched to guide you through the installation process.
❗ In the wizard, you can step back one step by typing #BACK at the prompt and then pressing Enter. To exit the wizard, type #EXIT at the prompt and press Enter.

 

13. From the options, select the option Install, which is option 1. Then press Enter.

14. Here you can change the path where the Agent will be installed.
The default path is: /usr/share/dwagent
If you want to install the Agent in the default folder, just hit Enter.

15. To confirm the installation path, from the options, select Yes, which is option 1. Then press Enter.

16. From the two installation options, select the option Creating a new agent, which is option 2. Then hit Enter.

17. Enter your username (email address) associated with your DWService account. Then press Enter.

18. Type the Agent installation password. Then press Enter.
⚠️ Note: This is not your account password, but a password created specifically for this purpose in your account (Dashboard –> My Account –> Credentials –>Agent installation password).

19. Enter a name for the Agent. Then press Enter.

As you can see in the picture above, the installation has been successfully completed. The Agent is ready to use.

Switch back to the account.

20. In the menu on the left, select All.
21. The Agent is available. You can connect to the agent by clicking on it.

➕ Additional configuration option (optional):
As you can see, the agent created is not in a group, nor does it have a description. If you don’t need these, we are now at the end of the process. The Agent is ready for use.

If you would like to put the Agent in the group and/or add a description to it, please do the next few steps:
22. Click on the three dots in the top right corner of the Agent. This will open the menu for the Agent.

23. From the menu that appears, select Edit.
You see the Edit window of the Agent:

24. The selection of Group is optional. If you do not wish to add the agent to a group, simply leave this field blank. If you want to add the Agent to a group, select the desired group from the drop-down menu. If there is no Group in the drop-down menu that suits you, you can create a new Group by selecting Groups in the Dashboard. For more details, click here.
25. Optionally, you can provide a Description of the Agent, which will help you to identify the Agent later.
26. To save the changes, click on the Confirm button.
After the window closes, you will see this:

The Agent is available and ready to use.
To connect to the Agent, click on the Agent.

This brings us successfully to the end of the installation process.
Use it with maximum satisfaction.

When you install the Agent, the installer will offer you a default path to install the Agent.

This installation path can be one of the following, depending on the operating system:

• Windows ⇒ C:\Program Files\DWAgent\
• Linux ⇒ /usr/share/dwagent
• MacOS ⇒ /Library/DWAgent

The installation path can be changed during the installation process, allowing the Agent to be installed in any location.

A backlink is a link that points back to your website or your company’s website.

If someone subscribes to our service, they can appear on our subscribers’ page. The list of subscribers is available here (under the plans): DWService – Subscriptions

Our subscriptions are the following:

• Entry ⇒ 8 Mbps
• Lite ⇒ 10 Mbps
• Basic ⇒ 14 Mbps
• Advanced ⇒ 20 Mbps
• Professional ⇒ 30 Mbps
• Premium ⇒ 50 Mbps

If you choose Entry, Lite or Basic, your name will appear at the bottom of the list.

If you choose Advanced, Professional or Premium, your logo will be listed with a link to your website.

You can check how this works by scrolling down the page listing the subscriptions. DWService – Subscriptions

When you activate TOTP for our Two-Factor Authentication (2FA) service, our system will generate a code for you. This is called the Unlock Code.

The unlock code is a 16-digit code that looks like this: 1234-5678-9012-3456

An example:

⚠️ This code should be kept in a very good place, which will be surely available for you also in the future.

Why is it so important?
The answer is very simple. If anything happens to your authentication device (loss, theft, breakage, hardware failure, software failure), you can still sign into our system with this code and generate a new code for your new device.

Here are some suggestions:

• Do not store the code only on the device that is doing the authentication.
• Store the code in a location that will be accessible to you in the future.
• Make a copy of the code.
• If you are using a cloud service, you can save it to that storage location.
• If you use a password manager application, you can save it there.

⚠️ This code is very important for the preservation of your account, so take care to ensure you can use it in the future.

When you connect to the Agent, the Applications will appear. Select Shell. The remote command line opens.

Depending on your settings, you can use the application in multiple ways.

There are parameters that can be set to control how the function works:
"shell.enable_authentication": true
"shell.enable_authentication": false
"shell.users_allowed": [{"name": "*", "enable": true}]


These parameters must be entered/modified in the config.json file.
The config.json file can be also edited remotely using the Text Editor app.

If the Agent has been installed using the default path, the config.json file is:

• Windows  ⇒  C:\Program Files\DWAgent\config.json
• MacOS  ⇒ /Library/DWAgent/config.json
• Linux  ⇒ /usr/share/DWAgent/config.json

"shell.enable_authentication": true  ⇒ When the shell app is started, a username and password must be specified.
"shell.enable_authentication": false  ⇒  No username or password is required when starting the shell app.

If “shell.enable_authentication”: true, then one of the following parameters are also valid:

"shell.users_allowed": [{"name": "*", "enable": true}]  ⇒ All users are enabled.
"shell.users_allowed": [{"name": "root", "enable": true}, {"name": "*", "enable": false}]  ⇒ Only the root user is enabled.
"shell.users_allowed": [{"name": "root", "enable": false}, {"name": "*", "enable": true}]  ⇒ All users are enabled except the root user.

An example for the config.json file (Does not request a username and password.):

{
 "shell.enable_authentication": false,
 "enabled": true,
 "key": "<AGENT KEY>",
 "listen_port": 7950,
 "password": "<AGENT PASSWORD>",
 "url_primary": "https://www.dwservice.net/"
}

An example for the config.json file (Requests a username and password, and all users are enabled for Shell.):

{
 "shell.enable_authentication": true,
 "shell.users_allowed": [{"name": "*", "enable": true}],
 "enabled": true,
 "key": "<AGENT KEY>",
 "listen_port": 7950,
 "password": "<AGENT PASSWORD>",
 "url_primary": "https://www.dwservice.net/"
}

An example for the config.json file (Requests a username and password, and all users except the root user are enabled for Shell.):

{
 "shell.enable_authentication": true,
 "shell.users_allowed": [{"name": "root", "enable": false}, {"name": "*", "enable": true}],
 "enabled": true,
 "key": "<AGENT KEY>",
 "listen_port": 7950,
 "password": "<AGENT PASSWORD>",
 "url_primary": "https://www.dwservice.net/"
}

An example for the config.json file (Requests a username and password, and only the root user is enabled for Shell.):

{
 "shell.enable_authentication": true,
 "shell.users_allowed": [{"name": "root", "enable": true}, {"name": "*", "enable": false}],
 "enabled": true,
 "key": "<AGENT KEY>",
 "listen_port": 7950,
 "password": "<AGENT PASSWORD>",
 "url_primary": "https://www.dwservice.net/"
}

⚠️ Important: Please pay attention to the use of the “,” character at the end of the line, as it separates each parameter. Without them, the Agent will not work properly.

After modifying and saving the config.json file, the Agent must be restarted (no need to reboot the operating system).

💡 Note: This modification can be done remotely as well.

In case you choose this installation method, you should follow our next guide, step-by-step.

1. Visit our website: https://www.dwservice.net

2. Login to your account. You can read more about the login process here: Login

3. You will see your dashboard:

4. On your Dashboard, select My Account.

After selecting My Account, this will be displayed:

5. From the menu on the left, select Account.

6. Enter the Agent installation password, which you will be asked to enter when you install the Agent.

⚠️ Important: For security reasons, this password cannot be the same as your account password. Choose a different password.

7. To save the password, click the Update Credentials button.

The following window will appear:

8. Click on the Ok button.

Now let’s see how to install the Agent.
Download the Agent installer for your device from our download page (https://www.dwservice.net/download.html).
After downloading the Agent file, start the Terminal. You should open the folder where you saved the Agent file. In our case, this is the ‘Downloads’ folder.
⚠️  Note: When changing folders, note that folder names are case sensitive.

9. Type the following command: sudo bash dwagent.sh
At the end of the command, press Enter.
After pressing Enter, you will be prompted for the password:

10. Enter the password for the Linux username.
⚠️ Note: For security reasons, the screen does not show you typing your password. But the password will be entered. After typing your password, press Enter again.

A wizard will be launched to guide you through the installation.

11. From the options, select Install.
12. Click on the Next button.
The next page of the wizard is displayed:

13. Here you can see the location (Path) where the Agent will be installed. If you want to install the Agent somewhere else, you can change the path here. The default path is: /usr/share/dwagent
14. Click on the Next button.
The next page of the wizard is displayed:

15. Select Yes to confirm that the specified installation path is correct.
16. Click on the Next button.
The next page of the wizard is displayed:

17. From the two installation modes, select the ‘Creating a new agent‘ option.
18. Click the Next button.
The next page of the wizard is displayed:

19. Enter your DWService account username (your email address)
20. Enter the Agent installation password. You have previously set this up in your account in the Credentials section. Important: this is not your account password.
21. Enter a name for the Agent you want to create.
22. Click on the Next button.
The next page of the wizard is displayed:

As you can see, the Agent has been successfully installed.
23. Click the Close button to close the wizard.
After installation, the Monitor icon appears in the taskbar.

24. Click on the Monitor icon to show the DWAgent – Monitor window.

In the image above you can see that the Agent is active and Online. From now on it is possible to connect to this Agent.

Now let’s go back to the account where you can see the Agent you created:

25. In the menu on the left, select All.
26. The Agent is available. You can connect to the agent by clicking on it.

As you can see, the agent created is not in a group, nor does it have a description. If you don’t need these, we are now at the end of the process. The Agent is ready for use.

If you would like to put the Agent in the group and/or add a description to it, please do the next few steps:
27. Click on the three dots in the top right corner of the Agent. This will open the menu for the Agent.

28. From the menu that appears, select Edit.
You see the Edit window of the Agent:

29. The selection of Group is optional. If you do not wish to add the agent to a group, simply leave this field blank. If you want to add the Agent to a group, select the desired group from the drop-down menu. If there is no Group in the drop-down menu that suits you, you can create a new Group by selecting Groups in the Dashboard. For more details, click here.
30. Optionally, you can provide a Description of the Agent, which will help you to identify the Agent later.
31. To save the changes, click on the Confirm button.
After the window closes, you will see this:

The Agent is available and ready to use.

This brings us successfully to the end of the installation process.
Use it with maximum satisfaction.