Set up Tekla PowerFab Remote Server for Tekla PowerFab Go

Tekla PowerFab
Upraveno: 17 Zář 2024
2024i
Tekla PowerFab Tekla PowerFab GO

Tekla PowerFab Remote Server

For Tekla PowerFab Go installation, you need to install the Tekla PowerFab Remote Server and set up and manage its service settings in the Tekla PowerFab Remote Monitor.

The Tekla PowerFab Remote Server is a Windows service that is installed on the Tekla PowerFab server. This service listens for and responds to traffic from Tekla PowerFab Go and executes automated events.

The Tekla PowerFab Remote Server allows you to perform Tekla PowerFab actions remotely. In practice, the Tekla PowerFab Remote Server enables running automated events and using the Tekla PowerFab Go mobile application.

The Tekla PowerFab Remote Server is typically only installed on the Tekla PowerFab server computer. To use Tekla PowerFab Go, a TCP port (not TCP/UDP) needs to be forwarded to the computer on which you install the Tekla PowerFab Remote Server.

You can manage Tekla PowerFab Remote Server settings in the Tekla PowerFab Remote Monitor dialog.

Tekla PowerFab Remote Monitor

The Tekla PowerFab Remote Monitor is a graphical user interface for setting up and managing Tekla PowerFab Remote Server service.

Tekla PowerFab Remote Monitor reports the following details in real-time:

Item Description Output example
Remote Server Status

The current status of the service.

If the service is running, shows the TCP port that the service is listening for connections.

The service is not running.

The service is running. Running - Port 9154.

Uptime The time in hours, minutes, and seconds that the service has been active. 145:35:46
Connection SSL Cipher

Indicates whether Tekla PowerFab Remote Server is connected to the MySQL database via an encrypted connection.

If Tekla PowerFab does not use encryption for its ODBC connection, this will be blank.

Total Remote Connections The total number of connections that have been made during the time that the service has been active. 154
Current Remote Connections The count of connections that are currently active. 17
Total Commands The total number of XML/JSON commands that have transacted during the time that the service has been active. 987
Current Sockets The number of TCP sockets that are currently active. 4
Total Sockets The total number of TCP sockets that have been created during the time that the service has been active. 876

Remote Monitor Service Log File

The service log contains information on the Remote Server service, such as connection to the Tekla PowerFab MySQL database and Trimble Identity sign-in.

The service log can be viewed by clicking the Service Log File button or by clicking the RemoteServerError.txt file in the program installation folder.

Remote Monitor Socket Log File

The socket log file contains information on the traffic transactions over the TCP socket (user connection). This can be logged at varying levels of detail. For further information on the levels and how to change them, see the Socket section of the Tekla PowerFab Remote Server Settings.

The latest socket log can be viewed by clicking the Socket Log File button. The latest and historical socket logs can also be found in the Log subfolder of the program installation directory. These files have the naming structure of remote-server-log-<Remote Service name>-<YYYYMMDD>.log.

Install Tekla PowerFab Remote Server

We recommend that you install the Tekla PowerFab Remote Server service during the initial the Tekla PowerFab installation when you select the Server configuration. You can also install Tekla PowerFab Remote Server separately.

  1. In File Explorer, go to C:\Users\Public\Documents\Tekla\Tekla PowerFab\Backup.
  2. Double-click the TeklaPowerFabRemoteServerSetup.exe file to install the Tekla PowerFab Remote Server.
  3. Click Install.

    The Tekla PowerFab Remote Monitor dialog box opens. A Tekla PowerFab Remote Monitor icon has been created on the desktop.

  4. Click OK to close the installer.

    You are prompted to sign in with Trimble Identity to start the service.

The Tekla PowerFab Remote Monitor dialog box opens automatically after the installation is finished.

Next, define the Tekla PowerFab Remote Server settings and start the remote server.

Set up and start Tekla PowerFab Remote Server

You can set up and manage the Tekla PowerFab Remote Server service settings in the Tekla PowerFab Remote Monitor dialog.

  1. If you do not have the Tekla PowerFab Remote Monitor dialog open, do either of the following:
    1. Double-click the Tekla PowerFab Remote Monitor icon on the server desktop.
    2. Go to the default installation directory C:\Program Files (x86)\Tekla\Tekla PowerFab and double-click Tekla.PowerFab.Remote.Monitor.exe.

      Individual installation locations may vary.

  2. In the Tekla PowerFab Remote Monitor dialog, click Settings.

    The Remote Server Settings dialog opens. You can see the IP address and port for the database connection.

    For details on the settings, see Tekla PowerFab Remote Server settings.

  3. To sign in, click Sign in in the upper right-hand section of the dialog.
    Sign in with a Trimble Identity that is an administrator for all the Trimble Connect projects of your company.
  4. In the Port field in the Socket section, type any non-standard TCP port (1024–65535) not already in use.

    The default port is 9154. See also Setting up port forwarding.

  5. Click Save Settings.
  6. In the Tekla PowerFab Remote Monitor dialog, click Start Service.

If the settings have been defined successfully, the Tekla PowerFab Remote Server starts running.

You can always check in the Tekla PowerFab Remote Monitor dialog if the Tekla PowerFab Remote Server is running.

The server installation is complete.

For troubleshooting, see Troubleshoot Tekla PowerFab Remote Server Service (Go and Automated Events)

Add a Remote Server service

If the Tekla PowerFab Remote Server service was not installed, needs to be reinstalled, or another service is desired, you can add a new one.

  1. In the Tekla PowerFab Remote Monitor, click the plus (+) button.

    The New Remote Server Service dialog opens.

    Service Name: Type any unique string of characters. We recommend to use spaces and alpha-numeric characters. When you start the name with the MySQL prefix, it is shown in the MySQL Service Manager.

    Display Name: Type any string of characters. It is a user-friendly name that appears in the service selection drop-down in Tekla PowerFab Remote Monitor and in the Windows Services control panel application.

    Service Dependency: This must match the Tekla PowerFab database MySQL service name exactly. MySQL Service Manager displays the MySQL service names for all database instances running on the machine.

  2. Click Add Remote Server Service.

Remove a Remote Server service

Tip: If the service will be re-added after removing it, we recommend to document all the current settings before removing the service.
  1. Open Tekla PowerFab Remote Monitor.
  2. Select the service that you want to remove.

  3. To remove the service, click the minus (-) button.

    Occasionally, you may need to reboot to clear the service.

Bylo to užitečné?
Předchozí
Další