Lycia configuration
By default, Lycia is fully configured and is ready to work out of the box.
At the same time, it is highly configurable and can be easily customized to adopt your existing development and/or production infrastructure.
Lycia configuration is performed by setting and changing the necessary environment variables and configuration files:
To configure Lycia (or its separate components), you need to:
- study the default configuration files and learn how environment variables will influence the necessary processes;
- change the necessary configuration files to include or exclude environment variables and their values;
- check whether the necessary result was achieved.
- environment variables influencing runtime appearance and behavior
- database environment variables
- environment variables that specify the location of configuration files
- environment variables that specify the location of resources and libraries
- environment variables used for debugging
- informative environment variables
Configuration scenarios
There is no one match-all Lycia configuration: What you configure, depends on your development and production purposes.
Here are some general situations for which you might need to configure your Lycia:
connecting to databases
To connect to a single database, you need to
create these files: inet.env
set these variables: LYCIA_DB_DRIVER, CLIENT_LOCALE, DB_LOCALE + database-specific environment variables
For example, to connect to an Informix database, you must set these environment variables in inet.env:
LOGNAME =
INFORMIXPASS =
LYCIA_DB_DRIVER = informix
INFORMIXDIR = C:\Program Files\IBM Informix Client SDK
INFORMIXSERVER = querix_tcp
CLIENT_LOCALE = en_us.UTF8
DB_LOCALE = en_us.UTF8
To connect to multiple databases, you need to
create these files: database.cfg
You can read about database connection in this online documentation:
- about Informix connection
- about Oracle connection
- about SQL Server connection
custom compilation environment
You need to
create these files: env.properties
set these variables: any environment variables required by your program, e.g., CLASSPATH for importing your custom java classes to your 4gl program, etc.
custom runtime environment
You need to
create these files: inet.env
set these variables: any environment variables required by your program, e.g., DBCENTURY, LINES and COLUMNS, QX_MENU_WINDOW, QX_COMPAT, and others
working with public client-side resources
You need to
create these files: public.xml for runtime and jetty.xml for Lycia Form Designer
working with custom application server instances
You need to
create these files: listener.xml
debugging
You need to
create these files: inet.env
set these variables: QXDEBUG, LYCIA_POST_MORTEM_LENGTH, LYCIA_SEVERITY, and others
Localization settings
When configuring Lycia, you have to pay attention to localization settings: Without properly set locale, you might get issues when using different character sets and creating 4gl applications for certain languages:
Setting the application locale
Setting the database client locale
Besides configuring the environment in general (by configuring Lycia or its separate components), you can also specify the necessary environment variables for separate projects and programs.