17 Global configuration

17.3 LedgerSMB

17.3.1 ledgersmb.conf

to be discussed:

Individual configuration keys; full discussion of possible values in reference appendix?

General section

auth
logging
tempdir

Directory to store temporary artifacts. E.g. PDF files are stored here before being sent to the browser. The default on unix variants is /tmp/ledgersmb.

cache_templates

Determines if HTML templates used for the LedgerSMB UI will be stored in precompiled form for improved performance. The value 0 (zero) means no caching; the value 1 means caching in the directory $(tempdir)/lsmb_templates; systems running multiple LedgerSMB instances with customized UIs should use separate values for tempdir for that reason

language
log_level
DBI_TRACE
pathsep
latex

Identifies if the system has LaTeXavailable: 0 means no LaTeX, 1 means LaTeXsupported

check_max_invoices
max_post_size

States the maximum size in bytes of the body in case of a POST request; this setting reduces the impact of DoS requests, if the system is under attack. The setting also limits the maximum size of attachments (see Section 30.3 on page 30.3) that can be uploaded

decimal_places
cookie_name
no_db_str

’environment’ section

PATH

’paths’ section

spool
userspath
templates
images
memberfile
localepath

’programs’ section

gzip

’mail’ section

sendmail
smtphost
smtptimeout
backup_email_from

’printers’ section

This section contains a list of printers and the commands to be executed in order for the output to be sent to the given printer with the document to be printed fed to the program through standard input. The example below shows how to send standard input data to a printer called “laser” when selecting the item “Laser” in the LedgerSMB printer selection drop down.

Laser = lpr -Plaser

’database’ section

host

Name of the host to connect to. See the documentation of the -h command line option at http://www.postgresql.org/docs/9.2/static/app-psql.html for more information (documentation unchanged since before 8.3, so applies to older versions as well)

port

Port number to be used to connect to. See the documentation of the -p option at the same URL as the previous item

default_db

Database to connect to when the “Company” entry field in the login screen is left blank

db_namespace

The name space the company resides in; expert setting – should not be used (default is “public”)

contrib_dir

Path of the directory in which the PostgreSQL contrib modules (extensions) are located; this setting is used by setup.pl when creating new companies or rebuilding (upgrading) existing ones

sslmode

Selects whether to use SSL over TCP connections or not; can be “require”, “allow”, “prefer” or “disable”

log4perl_config_modules_loglevel

@@@ This is a list of <module.name >= <level >

This is an advanced setting not typically touched.

17.3.2 pos.conf.pl

@@@ no idea what should go in here. to be investigated.

17.3.3 templates

LedgerSMB uses templates mainly for two things:

  • Output documents such as pick lists and invoices

  • The HTML User Interface

This setting relates to the former, which are meant to be copied and customized by users. The system supports having multiple sets in a global setup, where companies can be configured to use different sets.

17.3.4 ledgersmb.css