Lexolution Installation Guide: Update

• 1. Update / Upgrade
     • 1.1. Components of a Lexolution Update
• 2. Lexolution Server
     • 2.1. Lexolution Server Update Steps
     • 2.2. Setting Up Email Notifications When Creating the Reporting Database
• 3. Lexolution Client
     • 3.1. Lexolution Word Add-In
     • 3.2. Terminal Server

1. Update / Upgrade

1.1. Components of a Lexolution Update

Update Steps

2. Lexolution Server

The Lexolution Server stores all data and makes it available to the Lexolution Client on a workstation or terminal server.

🛈 Note

Before updating the Lexolution Server, back up the Lexolution database.
When updating the Lexolution Server, the Lexolution database will also be updated.

The installation is done in two separate steps:
1.) Install the program files for the KMS Server
2.) Update the database and start the service.

An upgrade from KMS 5.2 to the current version is not possible directly. The Lexolution Server must first be updated to 5.3 before installing the current version.
However, this can be done one after the other without delay.
Clients can be updated directly from 5.2 to the current version.

Please note the following:

• Previously, when updating the Lexolution Server via setup, the values from the config file were not carried over if the server setup was performed by different admins.
• Starting with Lexolution 8.0.119, the server setup is delivered with ALLUSERS=1 for a system-wide installation.
• For existing customers, it is recommended to switch once from a user-specific to a system-wide installation:
  

1. Update to the latest version of the Lexolution Server.
2. Back up the Lexolution Server configuration (STP.KMS.Server.exe.config).
3. Uninstall any previous version of the Lexolution Server.
4. [optional] If the Lexolution Server was previously installed by different users: Clean up old installations (log in as each user and uninstall the old Lexolution Server or LEXolution.KMS Server installations).
5. Restart the machine.
6. Install the latest version of the Lexolution Server. Do not enter configuration values during setup and do not start the service using the button on the last page of the setup. Instead, finish the setup.
7. Replace the Lexolution Server configuration in the installation directory with the backup from step 2.
8. Start the Lexolution Server service.

2.1. Lexolution Server Update Steps

To update a previous version of the Lexolution Server, follow these steps:

🛈 Note

After updating Lexolution from version 9.3.72, an indexing of search codes for fuzzy search will be performed when the server starts.
This calculation is a lengthy process!
If the indexing is not complete, a notification will appear when starting the Lexolution Client:

The quick search preparation has not yet been completed. Please contact your administrator.
Once the indexing is complete, the user can start the Lexolution Client again.
So, close the client and try starting it again after a few minutes.

The log file ServerLog_8000.txt is saved under

%programdata%\STP AG\LEXolution.KMS\

2.2. Setting Up Email Notifications When Creating the Reporting Database

The Lexolution Server notifies recipients via the configured email address whether the reporting database was created successfully, or informs them of any errors and blocks access to the reporting database.

🛈 Note

Changes to the settings below will be applied with the next notification, without needing to restart the Lexolution Server.

To configure email notifications when creating the reporting database, follow these steps:

Step 1
Open the Lexolution Server configuration file with administrator rights.
If you installed the Lexolution Server in the default installation directory, the configuration file STP.Kms.Server.exe.config is located in C:\Program Files (x86)\STP AG\LEXolution.KMS-Server.
Set IsReportDbEmailDeliveryEnabled to specify whether you want to enable notifications.

<add key="IsReportDbEmailDeliveryEnabled" value="true"> </add>

Set ReportDbEmailReceipients to specify who should receive the emails. You can enter multiple email recipients, separated by commas.

<add key="ReportDbEmailReceipients" value="user1@company.com,user2@company.com"></add>

Set ReportDbEmailSenders to specify who should be listed as the sender.

<add key="ReportDbEmailSenders" value="user@company"></add>

Set ReportDbEmailServerHostnames to specify the email server to use.

<add key="ReportDbEmailServerHostnames" value="0"></add>

Optionally, set ReportDbEmailServerPort to specify the port the email service is available on.
If no port is entered, the default port 25 will be used.

<add key="ReportDbEmailServerPort" value=""></add>

Set ReportDbEmailServerUseSsl to specify whether communication with the email server should be encrypted.
If the email server supports encrypted communication, it can also be negotiated even if the setting is false.

<add key="ReportDbEmailServerUseSsl" value="true"></add>

Set ReportDbEmailServerUsername to specify the username used to log in to the email server.
Please coordinate with your IT department regarding configuration.

<add key="ReportDbEmailServerUsername" value="company.com\username"></add>

Set ReportDbEmailServerPassword to specify the password used to log in to the email server.

<add key="ReportDbEmailServerPassword" value="password"> </add>

Step 2
Save your changes and close the configuration file.
The updated settings will now be applied.
The Lexolution Server is now installed and configured.

3. Lexolution Client

The Lexolution Client is installed on workstations and terminal servers.
All objects and their meta information are received by the Lexolution Client from the Lexolution Server.

🛈 Note

If Windows updates on the system have not been applied, there may be issues installing the new .NET Framework version.

Updating the Lexolution Client via the STP Updater (Terminal Server)

The new version update must first be installed on the STP Update Server.
As an administrator, save the update files Setup.exe and UpdateManifest.xml from the LEXolution.KMS Client\ directory to the repository directory of your STP Updater Server at \\<ServerName>\...\Update\LEXolution.KMS Client\.
Click the Show STP Updater Repository icon on the desktop of the STP Updater Server to open the relevant directory.

When a user opens the Lexolution Client, the STP Updater Client will check and update Lexolution to the new version.

Classic Single Installation/Update of the Lexolution Client

The log file ClientLog.txt is saved under %localappdata%\STP AG\LEXolution.KMS\.

3.1. Lexolution Word Add-In

With the Lexolution Word Add-In, Microsoft Word can be used as a word processor.
Bookmarks are provided, and documents can be saved directly from Microsoft Word into Lexolution.

🛈 Note

If Windows updates on the system are not up to date, there may be issues installing the new .NET Framework version.

• Compatibility mode for Word 2003 or the Word 97-2003 (*.doc) document format is not supported.

  ---

How to update the Lexolution Word Add-In on a workstation.
Follow these steps:

How to update the Lexolution Word Add-In on a terminal server
Follow these steps:

🛈 Note

3.2. Terminal Server

Terminal Server Installation
Open the Command Prompt with the Run as administrator option.

🛈 Note