STP.Updater Client

The STP.Updater Client receives patches and updates for selected STP programs from the STP.Updater Server and installs them on the local workstation.

Client Service

The STP.Updater Client allows for the updating of STP client applications without needing to be logged in as a local administrator.

The update is carried out by the Windows service STP.Updater ClientUpdateService, which has the necessary administrative rights assigned.

Client Application

The client application receives patches and updates for selected STP programs from the STP.Updater Server and passes them to the STP.Updater ClientUpdateService. The service then performs the update.

Settings

To manually change the settings for the STP.Updater Client, right-click the STP.Updater Client icon in the taskbar and select "Settings..." from the context menu.

Note
On some versions of Windows, you may need to confirm the launch of the configuration program in User Account Control. Click the shield icon in the taskbar.

If necessary, enter the username and password of a local administrator and click the Yes button in User Account Control.

In the "STP.Updater Client - Settings" window, you can configure the check frequency and the connection to the STP.Updater Server.

Check Frequency

  • "Daily"

    Enable this option and enter a time in the input field.

    The update check occurs once daily at the specified time.

  • "Hourly"

    Enable this option to check for updates once per hour.

  • "Every 5 Minutes"

    Enable this option to check for updates every 5 minutes.

  • "Manual"

    Enable this option to check for updates when you click the "Check for Updates" option from the STP Client Updater context menu.

Connection to the Updater Service

Hostname/IP Address

  • Enter the computer name or IP address of the STP.Updater Server.

Port

  • Enter the port used by the Windows service STP.Updater Server for communication with the STP.Updater Client.

    Note
    The startup type of the STP.Updater Client set during setup cannot be changed through these settings. Run the STP.Updater Client setup again to change the startup type.

Start STP.Updater Client

Depending on the configuration chosen during setup, the STP.Updater Client starts automatically when Windows starts.

You can also start the STP.Updater Client via

Start > Programs > STP AG > Administration > STP.Updater Client

or

Start > All Programs > STP AG > Administration > STP.Updater Client

to start it.

The STP.Updater Client icon will then appear in the taskbar.

The server is reachable.

Note
If the STP.Updater Server is not reachable or the Windows service STP.Updater ClientUpdateService is not started, the STP.Updater Client icon in the taskbar will be crossed out.

You will also receive a notification if the STP.Updater Server is not reachable or if the Windows service STP.Updater ClientUpdateService is not started on the workstation.

Updating Client Service and Application

The STP.Updater Server must be up to date.

A suitable UpdateManifest.xml file and the setup for the current version must be stored in the product repository directory.

When the application starts, it automatically checks for available updates. According to the set option, the updater will automatically search for updates at specified intervals. If updates are found, you will receive a notification. You can choose to perform the update or cancel it. You will be notified again about the available update during the next check.

To manually update the STP.Updater Client, right-click the STP.Updater Client icon in the taskbar and select "Check for Updates" from the context menu.

Update STP Client Programs

How to Update STP Client Programs

The program must support the STP.Updater Client. The setup or patch files must be stored in the product repository directory. This is done through the server setup of the respective client application or by manually placing them in the product repository.

When the STP.Updater Client starts, it automatically checks for available updates. According to the option set in the updater, the STP.Updater Client will automatically notify you of available updates at specified intervals.

If updates are found, you will receive a notification. You can choose to perform the update or cancel it. You will be notified again about the available update during the next check.

To manually update an STP client program, right-click the STP.Updater Client icon in the taskbar and select "Check for Updates" from the context menu or start the update search with a double-click on the STP.Updater Client icon in the taskbar.

Check for Updates

The search for updates occurs automatically at the configured intervals. If you selected the Manual option during setup or in the STP.Updater Client settings, no automatic search will occur.

You can also manually start the search for updates at any time. Double-click the STP.Updater Client icon to start the search for available updates.

For all STP applications configured for the STP.Updater Client, new patches and updates will be searched for. If a patch or update is found, you will be notified. You can choose to perform the update or cancel it. You will be notified again about the available update during the next check.

If you agree to the update, it will be executed.

If the application is still open, you will receive a corresponding message. Close the application and confirm the message with the Yes button, and the update will be executed.

Updates for the STP.Updater Client are always executed first. After restarting the STP.Updater Client, it will search for available updates again.

Note
The scheduled search for updates will not be executed if the user logs off the workstation.

Note
On a terminal server, applications should not be updated on a schedule because the terminal server needs to be put into a special operating mode for this. However, since the STP.Updater Client is a prerequisite for installing other STP client applications, it must be present on the computer before installing the STP client application.

The Windows service STP Updater ClientUpdateService is disabled by checking the Installation on a Terminal Server box. Note: It does not verify if it is actually being installed on a terminal server.

Additionally, regardless of the selected setting of the Installation on a Terminal Server box, the start of the STP.Updater Client on a terminal server is prevented.

Help in Case of Problems
The STP.Updater Server is not reachable.

Start the Windows service STP.Updater Server on the server.

Check the network connection. Is the server reachable?

Check the firewall settings on the server and on the workstation computer.

The STP.Updater Client Service is not running.

Start the Windows service STP.Updater ClientUpdateService on the workstation computer.

Log Files

The STP.Updater Client writes log files to the following folders:

  • C:\Users\<Username>\AppData\Local\STP AG\STP.Updater Client\Logs
  • C:\Users\<Username>\AppData\Local\STP AG\STP.Updater.ClientUpdateUI\Logs

The Windows service STP.Updater ClientUpdateService writes log files to the folder:

  • C:\Windows\System32\config\systemprofile\AppData\Local\STP AG\STP.Updater.ClientUpdateServer\Logs

These files may be empty as only errors are logged. The AppData directory is a hidden directory.

Note
The files LogConfig.xml and LogFile.txt are necessary for the function of the STP.Updaters and should not be deleted. All other log files can be deleted if you do not need them for troubleshooting.

Related to