Open the LogWin tool

This software includes a standalone LogWin tool that you can use to connect to a running project and then view that project's log messages.

The LogWin tool is functionally similar to the Output window in the project development environment, but it differs in several important ways:

• The LogWin tool can connect to projects running on both the local computer and remote computers, while the Output window only shows the project that is currently open in the project development environment;

• You can open multiple instances of the LogWin tool in order to connect to different projects at the same time; and

• The LogWin tool runs separate from the project development environment, and it can be left open when the project development environment is closed.

Before you try to use the LogWin tool to connect to a project, confirm the project is running and the TCP/IP Server Runtime task is started. The TCP/IP Server (also known as the Data Server) is what makes the project database accessible to debugging tools like LogWin. Also, if project runtime is hosted on a remote computer, note the host name or IP address of that computer. For more information, see Runtime Tasks.

Any time you try to access a project, if that project's security system is enabled then you may be asked to log on. This includes when you use the LogWin tool to connect to a project. As such, your user account needs to belong to a group that has the Enable Remote Debugging Tools option selected, in the security system settings. For more information, see Security System.

Open the tool from the Local Management tools

To open the LogWin tool from the Local Management tools:

1. On the Home tab of the ribbon, in the Local Management group, click Tasks. The Runtime Tasks dialog box is displayed.

2. In the list of execution tasks, select the LogWin task and then click Start. The LogWin tool is displayed in a separate window, and it automatically connects to the project running on the local computer (also known as LOCAL).

3. Click OK to close the Runtime Tasks dialog box.

Open the tool from the Remote Management tools

To open the LogWin tool from the Remote Management tools:

4. On the Home tab of the ribbon, in the Remote Management group, click LogWin. The Remote Computer dialog box is displayed.

   

5. In the Mode box, select one of the following:

   Mode	Description
   Encrypted TCP/IP	Connect to the project's TCP/IP Server using encrypted communication.
   TCP/IP	Connect to the project's TCP/IP Server using standard communication.

   If you want to use Encrypted TCP/IP mode, the Encrypted Port option needs to be selected in the project settings. If you want to use TCP/IP mode, the standard Port option needs to be selected in the project settings. For more information about both options, see Communication tab.

6. In the Host box, type the host name or IP address of the computer that is hosting the project runtime. You do not need to include the port number as long as it has not been changed from the default port for the selected mode (for example, port 51234 for Encrypted TCP/IP). If the port number has been changed, however, include the correct port number with the specified host.

   Even though you are opening the tool from the Remote Management tools, you can use it to connect to the project running on the local computer. To do this, leave the Host box empty.

7. Click OK. The LogWin tool is displayed in a separate window, and it automatically connects to the specified host.

Remember that you can open multiple instances of the tool as long as you specify a different host and/or port for each instance.

Run the tool from the command prompt

The LogWin tool is actually a small utility program that is included with AVEVA Edge, and you can run it from the Windows command prompt with appropriate parameters. The default location of the LogWin tool is:

C:\Program Files (x86)\AVEVA\AVEVA Edge 2026\Bin\LogWinExt.exe

To run the program from the command prompt, make sure you are in the correct directory and then enter the following:

LogWinExt /dsip:<host name or IP address> /dsport:<port number> /dssecure /username:<optional> /password:<optional>

The /dsip parameter indicates the host name or IP address of the computer or device that hosts the project runtime. For a project running on the local computer, you can specify the host as localhost or 127.0.0.1.

The /dsport parameter indicates the port number for the project runtime server (also known as the data server). You do not need to include this parameter as long as the port number has not been changed from the default (that is, port 51234 for encrypted communication, port 1234 for standard communication).

The /dssecure parameter indicates that you want to use encrypted communication, and when you do, you will be asked to trust the server's certificate. (In other words, you will be prompted to save the certificate in your local certificate store.) If you want to use standard communication, do not include this parameter.

The /username and /password parameters allow you to log on to the project as a user other than Guest, assuming that the project security system is enabled and you need to log on to the project in order to use the remote debugging tools.

You can open multiple instances of the LogWin tool as long as you specify a different host and/or port for each instance.

Use the tool to view log messages

If the LogWin tool successfully connects to the specified host, it is displayed in its own window separate from the project development environment.

As stated at the beginning of this topic, the LogWin tool is functionally similar to the Output window in the project development environment. It provides the same basic interface, and in most cases it can be used in the same way. However, the LogWin tool offers even more options than the Output window, such as saving the output on disk. For more information about those options, see the other topics in this section.

When you are done, click File > Exit to disconnect from the specified host and close the tool.