Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
LedgerSMB git svn mirror
JavaScript CSS Perl TeX Other PHP Other
branch: master

Updates to Database.pm docs

git-svn-id: https://ledger-smb.svn.sourceforge.net/svnroot/ledger-smb/trunk@6967 4979c152-3d1c-0410-bac9-87ea11338e46
latest commit eab6709a2b
einhverfr authored
Failed to load latest commit information.
LedgerSMB Updates to Database.pm docs
UI use database entered by user on setup;more tracing
bin When a sales invoice copied to new, the crdate must be the current da…
contrib/replication * Corrected NULL being saved in method for asset class (Chris T)
css Adding a redyellow theme
dists Merging from branches/1.3
doc Documenting data and report tightening in release notes
images better css for menu for 1.4
locale Updated Hungarian translation.
sql 1.3 changes for changelog
t All tests, including db tests, passing
templates Changing templates to use db letterhead
tools Loading templates now works as part of the db setup process. Now to a…
utils More contact, payment, voucher fixes/enhancements
.gitignore One can now set taxes for customers/vendors
BUGS Documentationf or beta 4
Build.PL Actually committing the switch away from Moduel::Build
COMPATIBILITY Merging from branches/1.3
CONTRIBUTORS Committing Ward Vandewege's SL->LSMB migration patches
COPYRIGHT Initial Import
Changelog Changelog entry for 1.3
INSTALL Update INSTALL for 1.4 and Debian Wheezy (current stable).
LICENSE Removing executable bit from documentation
LedgerSMB.pm Since we got rid of the db commits, duplicate dbh's tend to lock. Cor…
Makefile.PL Adding Carp::Always to required list provisionally
README.Starlet Adding Starlet readme
README.plack Adding Plack documentation
README.sql-ledger Update doc " Support for migrating from SQL-Ledger via Setup.pl"
README.tests Refactor setup; eliminate PG_CONTRIB_DIR.
README.translations Documenting parameterized translations
Reconciliation.pl
UPGRADE Documenting non-standard schema installations, and ensuring that upgr…
account.pl Print and post buttons removed
admin.pl Consolidated goods and services search
am.pl
ap.pl
ar.pl
asset.pl
bp.pl
budget_reports.pl
budgets.pl
business_unit.pl
common.pl Forward-port r5928, fixing #873, from the branch to trunk.
configuration.pl
configure_apache.sh Add missing "cp ledgersmb-httpd.conf $apacheconf"
contact.pl
contact_reports.pl
custom.pl Doing a simple Perltidy commit so that I can evaluate differences bet…
customer.pl Consolidated goods and services search
document_series.pl
drafts.pl Consolidated goods and services search
employee.pl
favicon.ico Removing executable bit from documentation
file.pl correcting issues with file attachments
gl.pl
goods.pl Consolidated goods and services search
ic.pl
import_csv.pl Cleaning up lsmb-request.pl
index.html removing SL reference, adding favicon to top level index.html
install.sh eventual apache alias
install_interactive.pl Refactor setup; eliminate PG_CONTRIB_DIR.
installer.pl fix to where installer.pl installs .pl files.
inv_reports.pl
inventory.pl
invoice.pl
ir.pl
is.pl
job.pl
journal.pl
ledgersmb-httpd-2.0-2.2.conf.template avoid Directory index forbidden by Options directive
ledgersmb-httpd-2.4.conf.template Adding a redyellow theme
ledgersmb.conf.default Refactor setup; eliminate PG_CONTRIB_DIR.
location.pl
login.pl
lreports_co.pl
lsmb-request.pl Correcting dispatching to legacy code on contact screen, fixes 952
lsmb.pl Doing a simple Perltidy commit so that I can evaluate differences bet…
menu.pl
oe.pl
old-handler.pl eliminating exit error at the bottom of old code
order.pl
payment.pl
pe.pl
pnl.pl
pos.conf.pl.template Ensuring pos.conf.pl no longer overwrites on upgrade
recon.pl
report_aging.pl
reports.pl
rest-handler.pl Using subtypes now for automagic conversion
rest.pl Doing a simple Perltidy commit so that I can evaluate differences bet…
setup.pl
taxform.pl
template.pl
timecard.pl
transtemplate.pl Adding missing template transaction files
trial_balance.pl
upgrade.pl Dummy commit, only whitespace, to facilitate updating git repo
user.pl
vendor.pl
vouchers.pl
winprint.bat Added @echo off in order to silence the script itself.

README.plack

README for Plack FCGI interface for LedgerSMB
Chris Travers
2012-11-13
----------------

WARNING:  Plack support for LedgerSMB is still designated as "expermental" which
means that it may have bugs not found in the core distribution.  Serious bugs in
this area were fixed as recently as 1.3.25.  Use at your own risk.  In addition,
persistant code environments are more sensitive generally than the CGI
environments and when the script dies one does not always get a helpful error.
In particular, blank, white screens are typical of the software exiting before
the standard output is returned to the web server.  There have been cases (which
have been corrected) which caused these kinds of errors under plack only.

----------------

This addon provides an app.psgi for LedgerSMB which allows you to properly run
servelets as fcgi scripts instead of as CGI scripts.  This makes LedgerSMB
significantly more responsive but performance is more difficult to manage under
load.

The current module preloads a fair number of modules and then runs a
fork/wait/execute loop where the less safe code is run.  This performs well on
platforms which provide copy on write functionality, but may not perform as well
on Windows.  The startup overhead for the dependencies is thus limited in this
case to a one-time load on starting the servelet.  Tests suggest that this
eliminates 2/3 or more of the startup overhead.

This module has been tested on fcgi backends but has not been tested on other 
backends.  I know of no reason it shouldn't work on starlet and other backends,
so if it works for you, please let us know.

The preloads are all set in the app.psgi.  You can adjust them there.  Note that
preloaded modules are not reloaded when altered so you will have to restart the
fcgi daemon if you change the preloads.  One solution is that for a performance
cost you can comment out a preload, and restart the daemon when working on a
preloaded module.

Currently this will preload configuration settings so changes to the
ledgersmb.conf will require a restart.

By default this currently starts up to 10 processes.  This number can be
tweaked.

To run the servelet, you will need to run the following from a startup script
somewhere:

plackup -s FCGI -D --listen /var/run/httpd/fastcgi/lsmb.sock

We have also packaged a few utilities here that are helpful, and these are
included in the tools/system directory.  These include lsmbstart and lsmbstop,
both bash scripts designed to start and stop the fcgi processes.  We also
include ledgersmb.service which is a systemd config file for systemd systems
(including Fedora) to use in starting/stopping the service.  A Sys V init script
is not currently included but that is likely to be in future versions
(contributions welcome).
Something went wrong with that request. Please try again.