Main configuration file of LMS is lms.ini, which must be placed in directory /etc/lms or in root directory of LMS. It contains configuration options of LMS-UI and all script with exception of LMS-MGC.
![]() | Remember to remove semicolons from begining of line with seted parameter. |
type
Database type. Actually in 100% supported is 'mysql', but for the time being isn't seen problems with 'postgres' and 'sqlite'. Default: mysql
Example: type = mysql
host
Host where database is installed. Most often, localhost, but can here set anything (IP, domain, path to socket in format 'localhost:/path/to/socket'). Default: localhost
Example: host = localhost
user
Name of database user account. In many cases (if you've go by documentation) that will be 'lms'. When you'll want to use privileged account, probably you'll enter 'root' (MySQL on most of *nixes), 'mysql' (on PLD) or 'postgres' (PostgreSQL). Default: mysql
Example: user = lms
password
Database password. Default: empty.
Example: password = password
database
Name of database (for SQLite path to database file). Default: lms.
Example: database = lms
server_encoding
Database encoding. Use if your database encoding is not unicode. Postgres is taking up conversion by himself, but in case of mysql for conversion is used php/iconv in LMS db-drivers. Default: unicode.
Example: server_encoding = latin2
sys_dir
System directory. It is a place where is entire content of LMS's UI, that means index.php, graphics, templates and the rest. By default index.php seek in filesystem using getcwd(), but better is to say him where hi is:
Example: sys_dir = /var/www/htdocs/lms/
modules_dir
Directory with "modules" of LMS. That is content of /modules directory. By default it is subdirectory modules in sys_dir.
Example: modules_dir = /usr/share/lms/modules/
lib_dir
Directory with "libraries" of LMS. That is content of /lib directory. By default it is subdirectory lib in sys_dir.
Example: lib_dir = /usr/share/lms/lib/
backup_dir
Directory for database backup files - place where LMS write database snapshots. By default it is subdirectory backups in sys_dir.
Example: backup_dir = /var/backup/lms/
![]() | If directory with backups will be accessible from WWW level, then anybody will can to access them without authorization. |
smarty_dir
Directory with Smarty library - By default, subdirectory Smarty in lib_dir.
Example: smarty_dir = /usr/lib/php/Smarty
smarty_compile_dir
Smarty's compilation directory. Place where Smarty compile templates. By default it is subdirectory templates_c in sys_dir.
Example: smarty_compile_dir = /var/smarty/compile/lms
smarty_templates_dir
Directory with Smarty's templates. By default it is subdirectory templates in sys_dir.
Example: smarty_templates_dir = /usr/share/lms/templates
allow_from (optional)
Lis of networks and IP addresses, which have access to LMS. If empty, every IP address has access to LMS. When you write here list of addresses or address classes, LMS dismiss every unwanted user with HTTP 403 error.
Example: allow_from = 192.168.0.0/16, 213.25.209.224/27, 213.241.77.29
lang
User interface language symbol. When is not set, language will be based on html browser settings. Default: en.
Example: lang = pl
timeout
Timeout of www session. After that time (in seconds) user will be log out if not take some action. Default: 600.
Example: timeout = 900
![]() | There is not possible to set no timeout. If you set this value on zero, you'll can't use LMS! |
customerlist_pagelimit
Limit of displayed positions on one page on customers list. Default: no limit.
Example: customerlist_pagelimit = 10
nodelist_pagelimit
Limit of displayed records on page on nodes list. Default: no limit.
Example: nodelist_pagelimit = 10
balancelist_pagelimit
Limit of displayed records on page on user's balance. Default: 100.
Example: balancelist_pagelimit = 50
invoicelist_pagelimit
Limit of displayed records on page on invoices list. Default: 100
Example: invoicelist_pagelimit = 50
ticketlist_pagelimit
Limit of displayed records on page on tickets (requests) list. Default: 100
Example: ticketlist_pagelimit = 50
networkhosts_pagelimit
Limit of displayed nodes on one page in Network Information. Default: 256
Example: networkhosts_pagelimit = 1024
accountlist_pagelimit
Limit of displayed records on page on accounts list. Default: 100
Example: accountlist_pagelimit = 50
domainlist_pagelimit
Limit of displayed records on page on domains list. Default: 100
Example: domainlist_pagelimit = 50
aliaslist_pagelimit
Limit of displayed records on page on aliases list. Default: 100
Example: aliaslist_pagelimit = 50
configlist_pagelimit
Limit of displayed records on page on UI config options list. Default: 100
Example: configlist_pagelimit = 50
reload_type
Reload type. Allowed values:
exec - calling of some command (most often with sudo, some script or something else, configurable below)
sql - doing SQL writes (also can be set concrete query)
Default: sql.
Example: reload_type = exec
reload_execcmd
Command to run during reload, if reload_type is set to 'exec'. By default /bin/true. That string is send to command system(), so I propose consideration what you do and how :) Altogether, semicolons should be parsed by bash, but LMS splits that string and execute commands singly.
Example: reload_execcmd = "sudo /usr/bin/reload_lms.sh"
reload_sqlquery
SQL query executed while reload, if reload_type = sql. By default, query inserts into table 'timestamps' value '_force'. In query can be used '%TIME%' as replacement to current unix timestamp. WARNING! Semicolon is handled by a queries separator, that means you can enter couple of SQL queries separate them by semicolon sign.
Example: reload_sqlquery = "INSERT INTO reload VALUES ('1','%TIME%')"
force_ssl
SSL Enforcing. Setting this option to 1 will make that LMS will enforce SSL connection doing redirect to 'https://'.$_SERVER[HTTP_HOST].$_SERVER[REQUEST_URI] at every access without SSL. Default: 0 (off).
Example: force_ssl = 1
allow_mac_sharing
Permission for addition of nodes with duplicated MAC address (not checking that some computer have that MAC yet). Default: 0 (off)
Example: allow_mac_sharing = 1
smarty_debug
Enable Smarty's debug console. Usefull for tracking values passed from PHP to Smarty. Default: 0 (off).
Example: smarty_debug = 1
lang_debug
Enable LMS language console. Usefull for tracking missing translation strings. Default: 0 (off).
Example: lang_debug = 1
debug_email
E-mail address for debugging - at this address will goes messages sended from madule 'Mailing', instead of proper users.
Example: debug_email = root@localhost
default_zip, default_city, default_address
Default zip code, city, street, used while inserting of new user. Useful when we have many users on the same street.
Example: default_zip = 39-300
use_current_payday
Qualify to use current day of month for payment day instead of most often used day. Default: 0 (off).
Example: use_current_payday = 1
lastonline_limit
Specify time (in seconds), after which node will be treated as inactive. It should match with frequency of running script inspecting nodes activity (i.e. lms-fping). Default: 600.
Example: lastonline_limit = 300
timetable_days_forward
Specify number of days (including current day) on timetable. Default: 7.
Example: timetable_days_forward = 2
arpd_servers
List of arpd servers for reading of MAC addresses from remote networks. That list should include items IP[:port] separated with spaces. Default: empty.
Example: arpd_servers = 192.168.1.1 192.168.2.1
helpdesk_backend_mode
When enabled, all messages in helpdesk system (except sended to requestor) will be send to mail server at address of right queue. On server should be running script lms-rtparser, which will write messages to database. Default: disabled.
Example: helpdesk_backend_mode = On
contract_template
Specify customer contract template. Can include comma separated list of contract templates. Default: contract.html.
Example: contract_template = "../my_templates/contract.html"
Example: contract_template = "contract.html:Default Contract, file.html:Contract Plus"
to_words_short_format
Specify format of verbal amounts representation (on invoices). For value "1" verbal expand of 123,15 will be "one two thr 15/100". Default: 0.
Example: to_words_short_format = 1