Update / Upgrade
Components of a LEXolution Update
| Database Server | Application Server | Workstation |
|---|---|---|
| SQL Server | LEXolution Server | LEXolution Client |
| LEXolution Word AddIn |
Update Steps
| Step | Component | Machine |
|---|---|---|
| 01 | Back up the KMS database | Database server |
| 02 | LEXolution Server Setup | LEXolution Server |
| 03 | LEXolution Client Setup | All LEXolution Clients/Terminal Servers |
| 04 | LEXolution Word AddIn Setup | All LEXolution Clients/Terminal Servers |
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 carried out in two
separate steps:
1.) Installing the program files for the KMS
Server
2.) Updating the database and starting the service.
A direct update from KMS 5.2 to the current version is not possible.
The LEXolution Server must first be updated to version 5.3 before
installing the current version.
However, both steps can be performed one right after the other.
Clients can be updated directly from version 5.2 to the current version.
Please note the following:
- Previously, when updating the LEXolution Server via the setup, values from the config file were not carried over if the server setup was performed by different administrators.
- As of 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:
- Update to the current version of the LEXolution Server.
- Back up the LEXolution Server configuration (STP.KMS.Server.exe.config).
- Uninstall the previous version of the LEXolution Server.
- [Optional] If the LEXolution Server was previously installed by different users: Clean up old installations (uninstall old versions of the LEXolution Server or LEXolution.KMS Server using the respective user accounts).
- Restart the machine.
- Install the current version of the LEXolution Server. Do not enter any configuration values during setup, and do not start the service via the button on the last page of the setup — instead, simply complete the setup.
- Replace the LEXolution Server configuration in the installation directory with the backup from step 2.
- Start the LEXolution Server service.
.NET Framework version.
LEXolution Server Update Steps
To update a previous version of the LEXolution Server, follow these steps:
| Step | Action | Result |
|---|---|---|
| 01 | As a local administrator, run the Setup.exe file located in the LEXolution Server directory. | The InstallShield Wizard launches. If any installation prerequisites are missing, the required components will be listed. |
| 02 | Click the Install button to install any missing components before the LEXolution Server installation begins. | The InstallShield Wizard for the LEXolution Server launches. |
| 03 | Review the values and click the Next button. |
The Server Configuration window is displayed. |
| 04 | The name of the server where the LEXolution Server is installed, and
the port used by the STP LEXolution Server service, are displayed. Review the values and click the Next button. |
The Database Configuration window is displayed. |
| 05 | The database connection details are displayed. This information is required for the LEXolution Server installation. Review the values and click the Next button. |
The LEXolution Database Backup window is displayed. |
| 06 | Confirm that you have completed a database backup. | The Document Path Configuration window is displayed. |
| 07 | The network location of the document directory is displayed. The network location must be entered as a UNC path. Review the values and click the Next button. |
The Reporting Database Configuration window is displayed. |
| 08 | The connection details for the LEXolution reporting database are
displayed. This information is required for the LEXolution Server installation. The same window also shows the number of parallel threads for data generation and the time dimension range (in years). This information is required for the LEXolution Server installation. Review the values and click the Next button.
|
The Reporting Database Update window is displayed. |
| 09 | Your settings for whether and when the LEXolution reporting database
should be updated automatically are displayed. Review the values and click the Next button. |
The LEXolution Service Bus Configuration window is displayed. |
| 10 | If you want to use the central user management together with DMS,
enter the relevant details here. Otherwise, you can skip this dialog and click the Next button. |
The Ready to Install the Program window opens. |
| 11 | Click Cancel to exit the installer without installing the LEXolution
Server. Click the Back button to change the configuration. Click the Install button to install the LEXolution Server on the server. |
The Files in Use window may be displayed. |
| 12 | Select Automatically close and restart applications. Click the Next button. |
The Installation Information for LEXolution Server window may be displayed. |
| 13 | Click the OK button. | The LEXolution Server is installed. The InstallShield Wizard Completed window is displayed. |
| 14 | Click the Next button. |
The InstallShield Wizard Completed window with the
Start KMS Server button is displayed. |
| 15 | Click the Start KMS Server button. |
After the database has been updated and the LEXolution Server service
has started, the confirmation dialog appears.
|
| 16 | Click OK and then click
Finish.The KMS Server update is now complete. |
🛈 Note
After updating LEXolution from version 9.3.72 onwards, an index of
search codes for fuzzy search is built when the server starts.
This
process may take some time!
If the indexing has not yet completed, a
notification will be shown when the LEXolution Client starts:
Die Vorbereitung der Schnellsuche wurde noch nicht abgeschlossen. Bitte wenden Sie sich an Ihren Administrator.
Once indexing is complete, users can restart the LEXolution
Client.
In the meantime, close the client and try again after a few minutes.
The log file ServerLog_8000.txt is stored at
%programdata%\STP AG\LEXolution.KMS\Setting Up Email Notifications for Reporting Database Creation
The LEXolution Server notifies recipients via the configured email address whether the reporting database was created successfully, or reports any errors and blocks access to the reporting database.
🛈 Note
Changes to the settings described below will take effect at the next notification without requiring a LEXolution Server restart.
To configure email notifications for reporting database creation, 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.
Under IsReportDbEmailDeliveryEnabled, specify whether you want to enable
notifications.
<add key="IsReportDbEmailDeliveryEnabled" value="true"> </add>
Under ReportDbEmailReceipients, specify who should receive the emails. Multiple email recipients can be entered, separated by commas.
<add key="ReportDbEmailReceipients" value="user1@firma.de,user2@firma.de"></add>
Under ReportDbEmailSenders, specify who should appear as the sender.
<add key="ReportDbEmailSenders" value="benutzer@firma"></add>
Under ReportDbEmailServerHostnames, specify the email server to be used.
<add key="ReportDbEmailServerHostnames" value="0"></add>
Optionally, under ReportDbEmailServerPort, specify the port on which
the email service is available.
If no port is entered, the default port 25 will be used.
<add key="ReportDbEmailServerPort" value=""></add>
Under ReportDbEmailServerUseSsl, specify whether communication with
the email server should be encrypted.
If the email server supports encrypted communication, it can also be
negotiated even when this setting is set to false.
<add key="ReportDbEmailServerUseSsl" value="true"></add>
Under ReportDbEmailServerUsername, specify the username to use when
logging in to the email server.
Please coordinate the configuration with your IT department.
<add key="ReportDbEmailServerUsername" value="firma.de\benutzername"></add>
Under ReportDbEmailServerPassword, specify the password to use when logging 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 take effect.
The LEXolution Server is installed and configured.
LEXolution Client
The LEXolution Client is set up on workstations and terminal
servers.
The LEXolution Client retrieves all objects and their metadata from the
LEXolution Server.
🛈 Note
If Windows Updates on the system have not been installed, problems may occur when 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.
The next time a user opens the LEXolution Client, the STP.Updater Client will check for updates and upgrade to the new version of LEXolution.
Classic Single Installation/Update of the LEXolution Client
| Step | Action | Result |
|---|---|---|
| 01 | Open the Command Prompt using the
Run as Administrator option. |
|
| 02 | In the Command Prompt, enter the command
change user /install and press Enter. |
|
| 03 | Run the Setup.exe file located in the LEXolution Client directory. | The InstallShield Wizard launches. If any installation prerequisites are missing, the required components will be listed. |
| 04 | Click the Install button to install any missing components before the LEXolution Client installation begins. | The InstallShield Wizard for the STP.Updater Client launches. |
| 05 | The STP.Updater Client is installed or updated. Please enter the server configuration for the STP.Updater and the desired check frequency. |
The InstallShield Wizard for the LEXolution Client launches. |
| 06 | Click the Next button. |
The Destination Folder window opens. |
| 07 | Click the Change button to specify a different destination folder. Changing the destination folder is not recommended. | The Change Current Destination Folder window is displayed. |
| 08 | Select a destination folder and click OK. | The Destination Folder window opens. |
| 09 | In the Destination Folder window, click the
Next button. |
The Server Configuration window is displayed. |
| 10 | The name of the server where the LEXolution Server is installed, and
the port used by the STP LEXolution Server service, are displayed. Review the values and click the Next button. |
The Ready to Install the Program window opens. |
| 11 | Click Cancel to exit the installer without installing the LEXolution
Client. Click the Back button to change the configuration. Click the Install button to update the LEXolution Client on the workstation. |
The LEXolution Client is updated. The InstallShield Wizard Completed window is displayed. You can launch the LEXolution Client immediately after installation. Optionally, the LEXolution.DMS Client App Service (LCAS) can be installed. However, this is only required and relevant when using LEXolution with LEXolution.DMS version 7 or later. For installation steps, please refer to the LEXolution.DMS Client App Service installation guide. |
| 12 | In the Command Prompt, enter the command
change user /execute and press Enter. |
The log file ClientLog.txt is stored at
%localappdata%\STP AG\LEXolution.KMS\.
LEXolution Word AddIn
The LEXolution Word AddIn allows Microsoft Word to be used as the word
processor.
It provides bookmarks and enables documents to be saved
directly from Microsoft Word into LEXolution.
🛈 Note
If Windows Updates on the system have not been installed, problems may occur when installing the new .NET Framework version.
- Word 2003 compatibility mode and the Word 97-2003 document format
(*.doc) are not supported.
How to update the LEXolution Word AddIn on a
workstation.
Follow these steps:
| Step | Action | Result |
|---|---|---|
| 01 | Copy the update files Setup.exe and UpdateManifest.xml from the
LEXolution WordAddIn directory to the repository directory of your
STP.Updater Server at
\\<Servername>\...\Update \LEXolution.KMS Word AddIn.To open the directory, click the Show STP.Updater Repository icon on the desktop of the
STP.Updater Server. |
|
| 02 | The next time the STP.Updater Client runs a check, the LEXolution Word AddIn will be updated to the new version. |
How to update the LEXolution Word AddIn on a terminal
server
Follow these steps:
| Step | Action | Result |
|---|---|---|
| 01 | Open the Command Prompt using the Run as Administrator option. | |
| 02 | In the Command Prompt, enter the command
change user /install and press Enter. |
|
| 03 | Run the Setup.exe file from the
LEXolution WordAddIn\ directory. |
The InstallShield Wizard launches. If any installation prerequisites are missing, the required components will be listed. |
| 04 | Click the Install button to install any missing
components before the installation begins. |
The InstallShield Wizard for the STP.Updater Client launches. |
| 05 | The STP.Updater Client is installed or updated. Please enter the server configuration for the STP.Updater and the desired check frequency. |
The InstallShield Wizard for the LEXolution Word AddIn launches. |
| 06 | Click the Next button. |
The Destination Folder window opens. |
| 07 | Click the Change button to specify a different
destination folder.Changing the destination folder is not recommended. |
The Change Current Destination Folder window is
displayed. |
| 08 | Select a destination folder and click OK. |
The Destination Folder window opens. |
| 09 | In the Destination Folder window, click the
Next button. |
The Server Configuration window is displayed. |
| 10 | The name of the server where the LEXolution Server is installed, and
the port used by the LEXolution Server, are displayed. Review the values and click the Next button. |
The Ready to Install the Program window opens. |
| 11 | Click Cancel to exit the installer without installing the LEXolution
Word AddIn. Click the Back button to change the
configuration.Click the Install button to update the
LEXolution Word AddIn on the workstation. |
The LEXolution Word AddIn is updated. The
InstallShield Wizard Completed window is displayed. |
| 12 | In the Command Prompt, enter the command
change user /execute and press Enter. |
🛈 Note
After updating the LEXolution Word AddIn, the LEXolution menu item will be available in Word. If Microsoft Office is uninstalled, the LEXolution Word AddIn must be uninstalled before uninstalling Microsoft Office.3.2. Terminal Server
Terminal Server Installation
Open the Command Prompt using the Run as Administrator
option.
| Step | Action |
|---|---|
| 01 | In the Command Prompt, enter the command
change user /install and press Enter. |
| 02 | Run the LEXolution-Client.exe file and follow the installer instructions. |
| 03 | Run the LEXolution WordAddIn.exe file and follow the installer instructions. |
| 04 | In the Command Prompt, enter the command
change user /execute and press Enter. |
🛈 Note
If Windows Updates on the system have not been installed, problems may occur when installing the new .NET Framework version.Related to