Install Client App Service

Note
Before reinstalling, close MS Outlook, MS Word, MS Excel, MS PowerPoint, and the standard DESK. The installation cannot be completed while these programs are open, and it will pause until the issue is resolved.

Windows User Account Control must not be disabled!

You need approximately 1000 MB of free disk space for the installation of LCAS.

Client App Service (LCAS)

The Client App Service runs in the background for each user logged into Windows without a user interface and contains the business logic for STP Documents.

Download

Download the file LEXolution.DMS Client App Service.zip.

The ZIP file contains the files STP LEXolution.DMS Client App Service Setup.exe and UpdateManifest.xml.

Necessary Data for Installing Client App Service

Have the following information ready during the setup:

• The target directory for installing the runtime components.

  (Default: %ProgamFiles%\STP AG\ LEXolution.DMS Client App Service)

• The name of the server where the RabbitMQ service is running. Use the server if possible.

• The port that the RabbitMQ service uses for communication

  (Default: 5672)

• The name of the RabbitMQ user and their password.

  (Default: RabbitMQ user: stpuser; Password: stp.)

Run LCAS Setup

Windows User Account Control must n o t be disabled!

Start the installation program STP LEXolution.DMS Client App Service Setup.exe with the option "Run as Administrator" and follow the instructions.

How to Install LCAS

Windows User Account Control must n o t be disabled!

To install the Client App Service (LCAS) on a workstation or terminal server, follow these steps:

1. Unzip the downloaded ZIP file LEXolution.DMS_Client_App_Service.zip to a local directory. Start the installation program STP LEXolution.DMS Client App Service Setup.exe with the option "Run as Administrator". Confirm security prompts from User Account Control with the Yes button.

2. Select German or French as the language for the installation program and click the OK button. The "LEXolution Client App Service - InstallShield Wizard" window will appear.

3. Click the Next button. The "Destination Folder" step will appear.

4. Click the Change button to select a different destination folder. Click the Next button to proceed to step 7. The "Change Current Destination Folder" step will appear.

5. Enter the desired destination folder in the Folder Name input field and click the OK button. The "Destination Folder" step will appear.

6. Click the Next button. The "Connection Data to LEXolution.Service Bus" step will appear.

7. Enter the following data.

   • LSB Hostname: Enter the server name where the RabbitMQ service is running in this input field.

   • LSB Port: Enter the port that the RabbitMQ service uses for communication between services and applications in this input field. (Default: 5672)

   • RabbitMQ User: Enter the username configured for access from workstations and terminal servers on the RabbitMQ Management website in this input field. Do not use the username guest, as it can only be configured for localhost, preventing access from workstations and terminal servers. (Default: stpuser)

   • RabbitMQ Password: Enter the password of the LSB user configured for access from workstations and terminal servers on the RabbitMQ Management website in this input field. (Default: stp.)

8. Uncheck the box STP.LEXolution.Client.TrayApp will automatically start with Windows to prevent the Tray App for the Client App Service (LCAS) from starting automatically at Windows login.

9. Click the Next button. The "Ready to Install the Program" step will appear.

10. Click the Install button. The Client App Service will be installed. The "InstallShield Wizard Completed" step will appear.

11. Click the Finish button. The "LEXolution.DMS Client App Service - InstallShield Wizard" window will close.

Terminal Server

1. Start the command prompt with the option "Run as Administrator".

2. Enter the command change user /install in the command prompt and press the [Enter] key.

3. Start the installation program STP LEXolution.DMS Client App Service Setup.exe and follow the instructions.

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

Unattended Installation LCAS

Parameters for the unattended installation of LCAS

Example

set INSTALL="C:\Users\Public\Downloads\DMS\LCAS\STP.LEXolution.Client.AppService Setup.exe"

set p01=INSTALLDIR

set s01=\"C:\Program Files (x86)\STP AG\LEXolution.DMS Client App Service\"

set p02=CLIENT_BUS_HOSTNAME

set s02=\"KASTPPDEDSK01\"

set p03=CLIENT_BUS_PORT

set s03=\"5672\"

set p04=CLIENT_BUS_USER

set s04=\"stpuser\"

set p05=CLIENT_BUS_PASSWORD

set s05=\"stp.\"

set p06=START_TRAYAPP

set s06=0

set Parameter="/passive /L*vx! C:\DMS_LCAS_Install.log %p01%=%s01%%p02%=%s02% %p03%=%s03% %p04%=%s04% %p05%=%s05 %p06%=%s06"

echo %date% %time% The setup is being executed with the following command line parameters: %Parameter%

%INSTALL% /s /clone_wait /L0x0407 /V%Parameter%

Note
The parameter /L0x0407 prevents the language selection popup from appearing. Without this parameter, an unattended installation will stop at the language selection.

Escape quotation marks with the character \.