Frequently Asked Questions - MacOS X

Useful Starman commands.
Using the perl based Starman webserver is the easiest way to run LedgerSMB locally (and quite possibly for production use as well).

At the terminal, and from your LedgerSMB directory:

Start Starman

starman  tools/starman.psgi

Default port is 5000.

starman -l :8080 tools/starman.psgi

Start with 8080 specified as the port.

Note: some documentation specifies the switch


It has been sugggested that this may give performance advantages in a production environment but isn't recommended while developing.
The manpage has more to say on this.

man starman

Based on that we currently would not recommend using --preload-app even on a production server

While Starman is running

Reload Starman

pkill -HUP -f "starman master"

Restart Starman

pkill -TERM -f "starman master"

Release the port if Starman is terminated

NOTE: try Restart Starman before doing this.

pkill -KILL -f "starman master"
FAQ Category: 

Perl is a high-level, general-purpose, interpreted, dynamic programming language. Perl was originally developed by Larry Wall in 1987 [ ]

Perl 5 is a highly capable, feature-rich programming language with over 24 years of development.

Learn Perl

The Bernard Chan Perl Tutorial

In general: neither. The advice is to have the full source tree in /opt/ledgersmb/<version>.

Installing the LedgerSMB modules in the standard Perl search path works, but interferes with running different versions side-by-side.

To undo installation in /usr/local:

  • remove /usr/local/share/perl/5.XX.X/LedgerSMB/
  • delete /usr/local/share/perl/5.XX.X/; and
  • find and remove the .pl files that come in LedgerSMB's project root directory and bin/ and LedgerSMB/Scripts/ directories.
FAQ Category: