5. Specify the Location for Lycia Configurations

Lycia is highly configurable, allowing for the creation of custom files. You can select locations for those files, and for these settings to be applied, you have to tell Lycia where to find them.

5A. Set the LYCIA_CONFIG_PATH Environment Variable

Use LYCIA_CONFIG_PATH in your system environment to specify the non-default path (or paths) to folders containing custom configuration files (for example, to the database.cfg file that specifies the configurations for database connection).

• This variable should be set for all Lycia components:
  • Compiler: settings.json for VS Code or user environment
  • Jetty service environment
• This variable takes one or more paths to folders, separated by colons (for Linux) and semicolons (for Windows).
  • Example: LYCIA_CONFIG_PATH=/opt/my_project/configs/

How to set LYCIA_CONFIG_PATH on Linux:

Step 1. Open your system configuration file in a text editor (for example, /etc/profile or ~/.bashrc).

Step 2. Set the value for LYCIA_CONFIG_PATH.

Configuration File Search Order: Lycia searches for the configuration files in the following order:

• In corresponding environment variables if they are set (for example, LISTENERXML variable for the listener.xml file);.
• In folders specified by LYCIA_CONFIG_PATH;
• In the default Lycia configuration folder: /opt/Querix/Lycia/etc/.

5B. (Optional) Create the listener.xml File

You can store the listener.xml file within the LYCIA_CONFIG_PATH folder, or you can specify its location separately using the LISTENERXML environment variable in your system environment.

Example for LISTENERXML on Linux:

Set LISTENERXML=/path/to/the/listener.xml in a system configuration file (for example, /etc/environment).

For more on LYCIA_CONFIG_PATH configuration, refer to the LYCIA_CONFIG_PATH documentation page.

 

See next: 6. Provide the Compiler Configurations