Lasernet 11 Config Server Log File and Server Settings File

Log File

Lasernet 11 Config Server’s log file is:

C:\ProgramData\Formpipe Software\Lasernet 11\Config\Default\Config.lnlog

The Config.lnlog file contains status information about:

• Database connections

• Deployments

• Token expiry

• Migrations

• Start and stop of the Config Service

• Transactions between client apps and server

Server Settings File

The settings that control Lasernet 11 Config Server are stored in the following file:

C:\ProgramData\Formpipe Software\Lasernet 11\Config\Default\ServerSettings.json

The file contains settings for the following areas of the Config Server’s operation:

• Database

• Authentication

• Bindings

• Environments

• Port

• Runtime data directory

• Automatically synchronize environments

It is recommended that you use Lasernet Service Manager to configure the Config Server. In this scenario, Lasernet Service Manager modifies ServerSettings.json and manages the file’s content.

However, in systems that are automatically deployed, or if it is not possible to use Lasernet Server Manager, you can configure the Config Server by manually modifying its ServerSettings.json file. The following information will help you to do this.

Database

Configuration structure (with placeholders):

{
    "Database": {
        "Database": "<Config Server database name>",
        "DictionaryDatabase": "<Dictionary database name>",
        "Interval": <database connection attempt interval>,
        "Password": "<database connection password>",
        "RequireEncryption": <toggle database connection encryption>,
        "Retries": <number of database connection attempts to make>,
        "Server": "<SQL Server instance that hosts the database>",
        "TrustServerCertificate": false,
        "Username": "<database identity username>"
    }
}

The Database object has the following properties:

Authentication

Lasernet can use one of the following authentication modes:

• Local Lasernet user authentication.

• External user authentication (through OpenID Connect) that is integrated with an identity provider such as Microsoft Entra ID.

To configure Lasernet for Microsoft Entra ID authentication, see Guide to Configuring Microsoft Entra ID Authentication for Lasernet.

Configuration structure (with placeholders):

{
    "Service": {
        "Authentication": {
            "Providers": [{
                "ClientId": "<Application (client) ID>",
                "Default": true,
                "Name": "<Display name for the provider>",
                "OIDCMetadataEndpoint": "<OpenID Connect Metadata document URI>"
            },{
                <additional provider>
            }],
            "UseExternal": true
        }
}

The Authentication object contains the following properties:

Each object in Providers contains the following properties:

You can configure several different providers. To authenticate using a particular provider, the user must specify the name of the configured provider when they attempt to log in.

Bindings

You can configure several host names to bind with a local server certificate, so that a secured connection can be obtained via an IP address, the local host name, or a fully qualified domain name (FQDN).

Configuration structure (with placeholders):

{
    "Service": {
        "Bindings": [{
            "Hostname": "<host name to bind the certificate to>",
            "PFX": {
                "PFX": "<PFX certificate path and file name>",
                "Password": "<password for the PFX file>"
            },
            "Thumbprint": ""
        },{
            <additional provider>
        }]
}

If no bindings are configured, Lasernet will autogenerate self-signed certificates for localhost, the server’s host name, and the server’s fully qualified domain name (FQDN).

Lasernet can use certificates installed in the Windows certificate store (in the Computer certificates area) or certificates stored on disk as PFX files.

You must create a binding for every host name that clients will use to connect to Lasernet Config Server.

The Bindings object is an array of bindings. Each object in the array has the following properties:

If only Hostname is specified, Lasernet will attempt to find a suitable certificate for the specified host name in the Windows Certificate store. If no suitable certificate is found, Lasernet will generate a self-signed certificate for this host name.

Environments

The Environments object specifies which Lasernet environments this Config Server manages.

Important

If you intend to use the Lasernet Service Manager and Lasernet Config web app to manage environments, do not add a Servers object to ServerSettings.json.

Configuration structure (with placeholders):

{
    "Service": {
        "Environments": [{
            "ClientSecret": "<client secret for the environment>",
            "Name": "<environment name>"
        },{
            <additional Lasernet environment>
        }]
    }
}

The Servers object is an array of server instances with the following format:

Port

The port number to run the Config Server on. In most situations, the default port number (443) is suitable. Use a different port number only if necessary to prevent port conflicts with other software running on the same server.

Example port configuration (with placeholders):

{
    "Service": {
        "Port": <port number>
    }
}

The port number might be required when logging in to the Lasernet Config web app or when starting a Lasernet application such as Lasernet Developer.

Runtime Data Directory

The location where the Config Server stores configuration data, its job database (which tracks paused jobs, scheduled jobs, failed jobs, and combined jobs), grab data, and job data.

{
    "Service": {
        "RuntimeDataDirectory": "<folder location>"
    }
}

Automatically Synchronize Environments

{
    "Service": {
        "SyncEnvironments": false
    }
}

Example Server Setting File

In the following example, Lasernet Config Server is configured as follows:

• Authentication

  • End users use external authentication and can log in with their Microsoft Entra ID user login (if they select from the identity provider list provided by the Lasernet application).

• Bindings

  • End-users can access the Lasernet Config server through a secured connection via the listed host names and FQDNs.

• Port

  • Lasernet Config Server is configured to communicate on port number 443.

• Servers

  • This Config Server manages two Lasernet environments: Default and Prod.

• Runtime data directory

  • The Config Server uses its default runtime data directory.

{
    "Database": {
        "Database": "LasernetConfig11",
        "DictionaryDatabase": "LasernetDictionary11",
        "Interval": 5,
        "Password": "qwerty",
        "RequireEncryption": true,
        "Retries": 30,
        "Server": "LN-WIN2022",
        "TrustServerCertificate": false,
        "Username": "sa"
    },
    "Service": {
        "Authentication": {
            "Providers": [{
                "ClientId": "999ee99f-9fc9-9a99-ad99-99999fd099e9",
                "Default": true,
                "Name": "Formpipe Software AB",
                "OIDCMetadataEndpoint": "https://login.microsoftonline.com/9999be9c-9c99-99bb-a6de-c999db099a99/v2.0/.well-known/openid-configuration"
            },{
                "ClientId": "9b9a0ce9-999b-999b-9a99-9999c99999c9",
                "Default": false,
                "Name": "Formpipe Lasernet",
                "OIDCMetadataEndpoint": "https://login.microsoftonline.com/9999b99d-999e-9ec9-9d9a-b999b99999b9/v2.0/.well-known/openid-configuration"
            }],
            "UseExternal": true
        },
        "Bindings": [{
            "Hostname": "localhost",
            "PFX": {
                "PFX": ""
            },
            "Thumbprint": ""
        },{
            "Hostname": "ln-win2022",
            "PFX": {
                "PFX": ""
            },
            "Thumbprint": ""
        },{
            "Hostname": "ln-win2022.westeurope.cloudapp.azure.com",
            "PFX": {
                "PFX": ""
            },
            "Thumbprint": ""
        }],
        "Environments": [{
            "ClientSecret": "AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAA4csh0qF1sEi+zYWlVe/OrgQAAAACAAAAAAAQZgAAAAEAACAAAADQyIi2LU5RgTS4RRq/Q4lMSJ/YQA6Lb5iQJwndJ54GlwAAAAAOgAAAAAIAACAAAAA9i9hYUgeeGa3AR1JJtBMMXJrpyA9txOd52r+5nxONijAAAACNPhFZBJhHo3yOODVEBXcSfq/ZF5sWe+5wIcz9Hvpg3hdOqVZutaK52HSXqfBwk5dAAAAAhKyQOTia2gn/c9Pa/w1EPbdF9JRFO5qAczxOoCgCGRl+aWYKmfMWLvsmzRv6OY8uC7L6AipWVn7jmlVqX2RU4A==",
            "Name": "Default"
        },{
            "ClientSecret": "AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAA4csh0qF1sEi+zYWlVe/OrgQAAAACAAAAAAAQZgAAAAEAACAAAABIuKm+u1B+uj1tZ2byBsQbxznA4CiyiqV0VhxTqev37gAAAAAOgAAAAAIAACAAAAA+fbW4Ij1+2Pydjfr006PwIreidmpOvZz21m0p7MmUIDAAAAC1LJiSNF6MRxYUn3scQHYd/J9duSSWZ1EjZyVcylminweVU8ITafSoRR+mFUVkFmRAAAAAAf9DAyClgXynFvt7VbolLam4oJSOrXafajYtmcHGU6Js1UYDwNQ4/51/5WeS6dZrWXWMwAtQebkdub54nVZ51Q==",
            "Name": "Prod"
        }],
        "Port": 443,
        "RuntimeDataDirectory": "",
        "SyncEnvironments": false
    }
}