Installation

The installation of the STP.Updater is done through separate setups for the STP.Updater Server and the STP.Updater Client.

Install STP.Updater Server

Install the STP.Updater Server on one of the server operating systems:

• Windows 2003
• Windows 2003 R2
• Windows 2008
• Windows 2008 R2.

On a 64-bit operating system, the program will be installed in 32-bit mode.

Please have the following information ready:

• Which drive should the program be installed on?
• The TCP port number that the STP.Updater service should use.
• The path for the product repository.
• Should the product repository be installed on the Updater Server or another server? Please create the desired directory and a share on the remote server.

Here's how you can determine the ports and associated files already in use:

Start the command prompt as an administrator, enter the command netstat -a -b -v, and press the [Enter] key.

Please note the installation requirements in the following section.

Requirements for installing the STP.Updater Server

On Windows Server 2003 and Windows Server 2003 R2, you must be logged in as a local administrator on the workstation.

On Windows Server 2008 and Windows Server 2008 R2, you need the username and password of a local administrator if you are not logged in as a local administrator on the computer.

The .NET Framework 4.8 must already be installed on the server. If needed, the Windows Installer 4.5 will be installed before the STP.Updater Server installation. Installing Windows Installer 4.5 also requires a system restart.

The drive with the program directory and the drive with the product repository must be formatted with the NTFS file system.

Please have the following information ready:

• The name of the server where the Updater Server should be installed
• The TCP port number that the Windows service Updater Server uses on the STP.Updater Server. If you haven't specified otherwise during setup, port 8017 will be used.
• The directory or UNC path to be used as the product repository. If you haven't specified otherwise during setup, the directory %ProgamData%\STP AG\Updater\Repository\ will be used.
• The directory to be used as the program directory. If you haven't specified otherwise during setup, the directory %ProgramFiles%\STP AG\LEXolution.iDESK Server will be used.

The following tables show the values for the variables %ProgramFiles% and %ProgramData%.

%ProgramFiles%

* In Explorer, the Program Files folder is displayed as Programs.

** In Explorer, the Program Files (x86) folder is displayed as Programs (x86).

%ProgramData%

You need 100 MB of free disk space on the system partition and about 600 MB in the desired program directory for the installation.

If the Microsoft .NET Framework 4.8 is also installed, you should have an additional 1.2 GB of free disk space on the system partition. You should allocate another 2 GB of disk space for the product repository.

Ensure that your firewall does not block the ports used by the STP.Updater on the server and workstations. If you haven't changed the suggested settings, these are port 8017 on the server and port 8007 on the workstation.

Run STP.Updater Server Setup

• Start the executable file STP.UpdaterServer.Setup.exe.

• Click the Next button.

• Click the Change button to select a different target folder. In the "Change Current Target Folder" window, you can choose the desired target folder and create a new folder if needed.

• Click the Cancel button to return to the "Target Folder" window.

• Click the OK button to confirm the selected folder as the target folder.

• In the "Target Folder" window, click the Next button to accept the suggested target folder.

• Change the default TCP port number if necessary.

  Change the suggested path if needed. If the product repository should be created on another server, enter a UNC path (\\<ServerName>\<ShareName>\<DirectoryPath>) here.

• Click the Change button to select a different target folder. In the "Change Current Target Folder" window, you can choose the desired target folder and create a new folder if needed.

  Click the OK button to confirm the selected folder as the target folder.

  Click the Cancel button to return to the "Target Folder" window.

In Windows 7, Windows Vista, and Windows Server 2008, the path is not displayed as a UNC path in Explorer. To display the path as a UNC path, follow these steps:

1. Click in the gray field with the directory names.

• The path will be displayed as a UNC path.

2. Right-click in the highlighted area. A context menu will open.

3. Select "Copy" from the context menu. The path to the directory is now in the Windows clipboard and can be pasted elsewhere.

• Click the Next button to accept the suggested target folder.

• Click the Cancel button to cancel the installation.

  Click the Back button to change the server configuration.

  Click the Install button to install the STP.Updater Server.

• In the Windows 2008 User Account Control, click the Yes button to continue the installation.

• Click the Finish button to complete the installation.

The .NET Framework 4.8 cannot be installed on Windows Server 2008 and Windows Server 2008 R2.

To enable the .NET Framework 4.8, right-click "Computer" on the desktop and select "Manage" from the context menu.

Click the Features button and in the "Features" section, click the Add Features button.

Expand the .NET Framework 4.8 Features node and check the appropriate box.

Add any necessary role services and click Next button in the following windows until the Install button is activated. Click the Install button.

Install STP.Updater Client

Install the STP.Updater Client on one of the following operating systems:

• Windows XP Sp4
• Windows Vista
• Windows 7
• Windows 2003
• Windows 2003 R2
• Windows 2008
• Windows 2008 R2.

On a 64-bit operating system, the program is installed in 32-bit mode.

The STP.Updater Client cannot be started on a terminal server.

Requirements for Installing the STP.Updater Client

On Windows Server 2003/2003 R2 and Windows XP, you must be logged in as a local administrator on the workstation.

On Windows Server 2008/2008 R2, Windows 7, and Windows Vista, you need the username and password of a local administrator if you are not logged in as a local administrator on the computer.

The Microsoft .NET Framework 4.8 should already be installed on the terminal server or workstation. If needed, it will be installed by the setup. A restart of the computer is then necessary.

Before installing the STP.Updater Client, the Windows Installer 4.5 will be installed if needed. Installing the Windows Installer 4.5 also requires a restart of the computer.

The drive with the program directory must be formatted with the NTFS file system.

Please have the following information ready:

• The name of the server where the Updater Server will be installed

• The TCP port number that the Windows service Updater Server uses on the STP.Updater Server. If you did not specify otherwise during setup, port 8017 will be used.

• The directory to be used as the program directory. If you did not specify otherwise during setup, the directory will be

  %ProgramFiles%\STP AG\Administration\Updater Client

• Whether the computer is a workstation or a terminal server.

The following table shows the values for the %ProgramFiles% variable.

* In Explorer, the Program Files folder is displayed as Programme.

** In Explorer, the Program Files (x86) folder is displayed as Programme (x86).

• For installation, you need 100 MB of free disk space on the system partition and about 600 MB in the desired program directory.

• If the Microsoft .NET Framework 4.8 is also installed, an additional 1.2 GB of free disk space should be available on the system partition.

• Ensure that your firewall does not block the ports used by the STP.Updater on the server and workstations. If you haven't changed the suggested settings, these are port 8017 on the server and port 8007 on the workstation.

• As installation prerequisites, the setup checks if the components Windows Installer 4.5 and Microsoft .NET Framework 4.8 are present. If needed, both components will be installed by the setup. Installing both components requires a restart of the computer each time.

Run STP.Updater Client Setup

• Start the executable file STP.UpdaterClient.Setup.exe.

• Click the Next button.

• Check the box Installation on a Terminal Server to disable the STP.Updater Client after installation on a terminal server.

  If needed, uncheck the box Installation on a Terminal Server to install the STP.Updater Client on a workstation and activate the Windows service STP Updater ClientUpdateService.

• Then click the Next button.

On a terminal server, no scheduled application updates should occur, as the terminal server must be put into a special operating mode for this. However, since the STP.Updater Client is a prerequisite for 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 box Installation on a Terminal Server.

Note
It is not checked whether the installation is actually on a terminal server.

Additionally, the start of the STP.Updater Client on a terminal server is prevented.

• Click the Change button to select a different target folder. In the "Change Current Target Folder" window, you can select the desired target folder and create a new folder if needed.

  Click the OK button to accept the selected folder as the target folder.

  Click the Cancel button to return to the "Target Folder" window.

• In the "Target Folder" window, click the Next button to accept the suggested target folder.

• Enter the name of the server where the STP.Updater Server is installed and the port used by the STP.Updater Server, then click the Next button.

• Select one of the offered options and click the Next button.

Cycle for Checking Updates

Daily

• Once a day at 12:00 PM, it checks for available updates. Specify a different time to perform the check at another time.

Hourly

• Once per hour, it checks for available updates. This setting is pre-selected.

Every 5 Minutes

• Every 5 minutes, it checks for available updates.

Manual

• No scheduled check for available updates occurs. Start the update via the context menu of the STP.Updater Client.

Select one of the offered options and click the Next button.

Startup Type

Automatically start Updater Client

• The STP.Updater Client starts automatically when Windows starts.

Create shortcut for manual start

• A shortcut is created on the Windows desktop, allowing you to manually start the STP.Updater Client.

• Click the Cancel button to cancel the installation.

  Click the Back button to change the client's configuration.

  Click the Install button to install the STP.Updater Client.

• In the Windows 7 or Vista User Account Control, click the Yes button to continue the installation.

• Click the Finish button to complete the installation.

If a winsolvenz.p4 or STP-Documents client was already installed on the workstation before installing the STP.Updater Client, the Windows services STP Clientupdate Service and STP.Updater ClientUpdateService are installed and started after installation.

This is intentional and not a problem. Both services can be started simultaneously as long as they use different ports.

Silent Setup

You can start an unattended installation of the STP.Updater Clients. To do this, copy the files

• cmd
• UpdaterClient.Setup.exe

from the installation directory of the DVD to a directory on the local computer or a shared directory. On all computers where the software is to be installed, .NET Framework 4.8 should already be installed. On Windows XP, Windows Server 2003, and Windows Server 2003 R2 operating systems, you must be logged in as a local administrator on the workstations.

Open the file SilentSetup.cmd with a text editor like Notepad.

Example for Windows 7 and Windows Vista without the TargetDir parameter

@ECHO OFF

cd "%~dp0"

ECHO The STP.Updater Client is being installed

SET PORT=8017

SET HOSTNAME=\"Please enter the name of the STP.Updater Server here\"

REM SET TARGETDIR=\"C:\Program Files (x86)\STP AG\Administration\Updater Client\"

REM With default target directory

REM "STP.UpdaterClient.Setup.exe" /S "/v/qn /lv*x install.log UPDATERSERVERPORT=%PORT% UPDATERSERVERNAME=%HOSTNAME% REBOOT=SUPPRESS"

REM With specified target directory

"\\MyFileServer\MyShare\STP.UpdaterClient.Setup.exe" /S "/v/qn /lv*x install.log UPDATERSERVERPORT=%PORT% UPDATERSERVERNAME=%HOSTNAME% INSTALLDIR=%TARGETDIR% REBOOT=SUPPRESS"

PAUSE

The batch file and setup are located in the shared directory \\MyFileServer\MyShare\.

UNC paths are not supported for the CD command. Comment out the line cd "%~dp0".

Open the file SilentSetup.cmd with a double-click to perform an unattended installation into the directory D:\Programs\STP AG\Administration\Updater Client\.

Add or change the values for PORT, HOSTNAME, and if needed, also for TARGETDIR.

If the file is in a shared directory on a remote computer, you need to specify a UNC path in the format (\\<ServerName>\<ShareName>) before the lines with "STP.UpdaterClient.Setup.exe".

UNC paths are not supported for the CD command. Comment out the line cd "%~dp0".

• For the file STP.UpdaterClient.Setup.exe, you can optionally specify an installation directory using the INSTALLDIR parameter.

  Comment out the unwanted lines with REM or remove REM from the desired line.

• Save the file SilentSetup.cmd.

• Run the executable file SilentSetup.cmd from the workstation. On Windows 7, Vista, and Windows Server 2008/2008 R2, run the file with the option "Run as Administrator".

If a value (e.g., the path for TARGETDIR) contains spaces, you must enclose the variable in the string \"<Value>\".

For an unattended installation, the option to automatically start the Updater Client is preset. It cannot be changed later. Therefore, do not perform an unattended installation on a terminal server.

On Windows Server 2003, Windows Server 2003 R2, and Windows XP, a restart of the computer is necessary because the Windows Installer 4.5 is also installed. The setup parameter REBOOT=SUPPRESS prevents the computer from restarting.

During an unattended installation, it may happen that the components listed as installation prerequisites are installed first, and then the computer is restarted. Log back into the workstation, and the setup of the STP.Updater client will continue in the background. After the installation is complete, the Windows service is started, and the STP.Updater Client icon is displayed in the taskbar.

Terminal Server Installation

Open the command prompt (on Windows Server 2008 and Windows Server 2008 R2 with the option "Run as Administrator").

1. Enter the command
- change user /install - in the command prompt and press [Enter].

2. Start the executable file UpdaterClientSetup.exe from the installation directory of the DVD and follow the installation program instructions.

3. During the installation of the STP.Updater Client, check the box Installation on a Terminal Server.

4. Enter the command
- change user /execute - in the command prompt and press [Enter].

The STP.Updater Client cannot be started on a terminal server. You will receive an appropriate message when starting the application.

On a terminal server, no scheduled updates of applications should occur, as the terminal server must be put into a special operating mode for this. However, since the STP.Updater Client is checked as a prerequisite for further 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 box Installation on a Terminal Server.

Note
It is not checked here whether the installation is actually being performed on a terminal server.

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