LUCS-Configurator is required to configure all topology and component related services of your LUCS application. 

LUCS Configurator is a standalone client-side application that will be completely replaced by WebConfigurator in foreseeable future.  You may still install and use LC on a LUCS Server machine, but nearly all actions can also be performed with the WebConfigurator interface using your browser.

→ All steps in the Configuration section of this manual are explained with the WebConfigurator UI in mind.  If you still require to use the LUCS Configurator, head to our legacy Knowledgebase https://kb.luware.com/ (requires Partner Login Credentials).

Installation

LUCS Configurator supports a multiple instance selection in order to administer all the instances with a single LUCS Configurator installation. You can configure instances during setup. Alternatively you can change the configuration file of LUCS Configurator before startup.

(lightbulb) When multiple instance selection is not configured, LUCS Configurator will be started normally.


  1. Run the LUCS.LC.Setup.msi
  2. On the Luware-LUCS-Configurator Configuration Settings screen of the setup make sure you fill the:
    1. Instance Name;
    2. Port Number;
    3. Role.
    4. Instance Name

  3. (info) For security reason LUCS provides possibility to use certificate-based encryption and verification during the components communication. To configure certificate based authentication, select ‘Configure Certificate Security’ check box and press ‘Next’ button to open a page with server certificate settings.

    LC Configuration Settings Screen

  4. When the ‘Configure Instances’ check box was selected, you need to configure them in the next step.

    1. Enable the instance configuration by using the checkboxes in front of the fields.

    2. Specify Lab Name, Instance Name and Port number.
      (lightbulb) A maximum of seven instances can be added via the installation setup. More Instances need to be configured via Config file (see chapter below)

      LC Configuration - Multi Instance Setup

  5. When the ‘Configure Certificate Security’ checkbox was selected, you'll need to configure the server and client certificate settings as the next step. The client settings specify which settings LUCS Configurator will use while connecting toPS. 
    → Also see Prepare Certificate Thumbprint

    LC Server Certificate Settings Screen

    Settings

    Description

    Value

    ModeTransfer security modes offered by WCF to ensure a secured communication between a client and a server.None : This mode ensures that no security is applied while communication between server and client.

    Transport: As the name suggests, it is concerned with security of communication between a client and a service over a network protocol. It guarantees the confidentiality and integrity of messages at transport level since transport security secures the entire communication channel.


    Validation ModeThe mode that specifies how incoming certificate is validated and how trust is determined .None: In this mode no validation is perfomed.

    ChainTrust: : In this mode WCF simply validates the certificate against the issuer of a certificate known as a root authority (the expiration time is checked too).

    PeerTrust: In this mode WCF simply checks if the incoming certificate is installed in the Trusted People folder in the certificate store (the expiration time is checked too).

    PeerOrChainTrust: Mixed mode.

    Is DedicatedThe flag that defins which certificate is used for encryption.False: Encryption is done with default certificate. It means that certificate with the hostname of the machinefrom the Personal Store is used on server side.

    True: Encryption is done with a dedicated certificate. It means there is  possibility to configure identifier (thumbprint) of the certificate.

    ThumbprintThe thumbprint is a hash value computed over the complete certificate, which includes all its fields, including the signature.



    →  See Prepare Certificate Thumbprin

  6. Finish the installation. 

  7. Open Windows Services 

    1. Note: The system reports all errors related to  connection or certificate issues to a log file ‘C:\Program Files\Luware AG\LUCS-LC\log\connectionIssues.log’.

      • Open Services and start the installed service.
      • Before running MM service, check that a valid certificate is registered on the machine where MM service is installed.
      • Check that service is successfully started without any errors in Event Viewer or in the log file

      In case of problems with certificate exceptions are thrown and logged in the LC 'regular' log file



  8. When the LUCS service is running properly, launch the Luware-LUCS-Configurator application

    1. When "Instances" have been configured (see Step 4), the following dialogue appears prior to startup. Select your instance to configure.

  9. The LUCS Configurator opens with your selected instance and should look as follows: 
    (lightbulb)Example screenshot. The "Connected to" Instance name and various service versions / status vary depending on what components and instances have already been installed / configured in your case.

    LUCS Configurator - Main Component Overview
  10. You may now start to configure LUCS as you need.

Add Instances via Config File

Via the ‘LUCS Instances’ configuration file, it is possible to edit your instances. You can add/remove as many instances as needed.

(info) The config file default path is: C:\Program Files\Luware AG\LUCS-Configurator.