Where's the documentation?

[GoogleCodeExporter]

1. if I add a node config to the elsa_web.conf file, the web server doesn't 
load. There's no documentation regarding proper syntax and no particular error 
in the log indicating the issue.

2. Why is syslogd still listening on UDP 514 if the installation installs 
syslog-ng? Does this cause a conflict? Where are all the log destinations so I 
can check.

3. There's no explanation of how the node is supposed to connect to the web 
host or versa. I'm guessing it hits the database. 

4. I'm not an idiot and have worked with lots of open source software, but this 
lack of documentation is ridiculous and make the package unusable. 

Original issue reported on code.google.com by chubi...@gmail.com on 13 Apr 2012 at 11:59

[GoogleCodeExporter]

1. Have you checked both the Apache error log as well as the ELSA web.log for 
the error?  You can validate the config by running the web server in the 
foreground using the "plackup" utility like this:
cd /usr/local/elsa/web/lib
ELSA_CONF=/etc/elsa_web.conf plackup Web.psgi
This should make any errors obvious.

2. Yes, syslogd will cause a conflict if it is listening on 514.  This is not 
default on Ubuntu, SuSe, RHEL, or FreeBSD.  What OS/distro are you installing 
on?

3. The nodes simply present database handles to the web frontend.  There is no 
other web-node communication.

4. Documentation is the least fun part of writing free software.  I provide 
this software (and support) for free because I enjoy making it.  I'm sorry if 
the docs aren't fully developed yet.  I appreciate the feedback as to where it 
is lacking so I know what parts need attention first.

Original comment by mchol...@gmail.com on 14 Apr 2012 at 2:02

• Added labels: Priority-Low, Type-Other
• Removed labels: Priority-Medium, Type-Defect

[GoogleCodeExporter]

[deleted comment]

[GoogleCodeExporter]

Closing since I haven't heard back.  Will re-open if requested.

Original comment by mchol...@gmail.com on 27 Apr 2012 at 1:56

• Changed state: Done