You are here:

8. Configure Lycia Web Server (Jetty) and App Server

8A. How to Start/Stop Lycia Web Server

Purpose: listener.xml defines and configures application server instances. Custom instances disable the default ones.

Location (default): /opt/Querix/Lycia/etc/listener.xml.

Steps to create listener.xml:

Step 1. Stop Lycia Web Server.

Step 2. Create a new file named listener.xml in the $LYCIADIR/etc folder.

Step 3. Copy the template structure into the file.

Step 4. Change the template to define your custom application server instance.

Step 5. Start Lycia Web Server.

Key Tags:

<service>...</service>: Encloses each AppServer instance definition.
<name>...</name>: Sets the instance name (Latin letters, numbers, dashes, underscores).
<applicationdir>...</applicationdir>: Specifies the working directory for programs.

Default: /opt/Querix/Lycia/progs

Default: /opt/Querix/Lycia/logs

Default: /opt/Querix/Lycia/etc/inet.env

Default for 'default' instance: none; for 'secure' instance: full.

For Linux: modauthcrypt.so, modauthshadow.so, or modauthpam.so.

<content_security_policy>...</content_security_policy>: Overwrites default CSP directives for LyciaWeb.

Reference: For more on listener.xml, refer to the listener.xml page of our docs.

Purpose: This file specifies the location for public client-side resources viewable by anyone with the link.

Location: /opt/Querix/Lycia/jetty/webapps/

Steps to create public.xml:

Step 1. Stop Lycia Web Server.

Step 2. Copy the template structure (see example below) into a new file named public.xml.

Step 3. Specify the contextPath (URL prefix) and resourceBase (physical folder or URL).

Step 4. Start Lycia Web Server.

Note: You must restart the web server after any changes to the public.xml as well.

Template Structure:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_0.dtd">

<Set name="contextPath">/public</Set>

<Set name="baseResourceAsString">/opt/Querix/Lycia/progs/public</Set>

</New>

</Set>

</Configure>

Note: The baseResourceAsString folder must already exist on your machine. You can use {CONTEXT}/public/logo.png or /public/logo.png in 4GL code.

Reference: For more on public.xml, refer to the public.xml page and Client-Side Resources pages of our documentation.