contrib: add example startup configuration for macOS

[rcmelendez]

Hi all! Per @furiel comments in the Gitter channel, I'm sharing a working launchd job for syslog-ng 3.25 I tested on macOS. I'm just trying to give Mac users a little help with their syslog-ng experience :)

[kira-syslogng]

This user does not have permission to start the build. Can one of the admins verify this patch and start the build?
(admin: you have the next options (make sure you checked the code):
"ok to test" to accept this pull request (and further changes) for testing
"test this please" for a one time test run
"add to whitelist" add author of a Pull Request to whitelist (globally, be careful, it means this user can trigger kira for any PR)
do nothing -> CI won't start)

[kira-syslogng]

This user does not have permission to start the build. Can one of the admins verify this patch and start the build?
(admin: you have the next options (make sure you checked the code):
"ok to test" to accept this pull request (and further changes) for testing
"test this please" for a one time test run
"add to whitelist" add author of a Pull Request to whitelist (globally, be careful, it means this user can trigger kira for any PR)
do nothing -> CI won't start)

[kira-syslogng]

This user does not have permission to start the build. Can one of the admins verify this patch and start the build?
(admin: you have the next options (make sure you checked the code):
"ok to test" to accept this pull request (and further changes) for testing
"test this please" for a one time test run
"add to whitelist" add author of a Pull Request to whitelist (globally, be careful, it means this user can trigger kira for any PR)
do nothing -> CI won't start)

[rcmelendez]

Signed-off-by: Roberto Meléndez rcmelendez@users.noreply.github.com

[bazsi]

Ok to test

[kira-syslogng]

Build SUCCESS

[furiel]

@rcmelendez thank you for your PR.

We follow a few formal requirements about contributions. Unfortunately, our contribution guide is not up-to-date. I will update it soon. Until then, let me share what is needed to be changed.

Commit format

We use the following format for commit message:

module: short description

long description (optional)

Signed off line.

Signed off line is important, because sometimes the patches are moved around: rebased or cherrypicked, for example during backporting. So that we and github could track the original author, we use the signed off line. For example you can use something like this:

contrib: add example startup configuration for macOS

Signed-off-by: your name <youremail@address.com>

If you do not want to share your email due to privacy reasons, you can use
yourgithubusername@users.noreply.github.com, which is automatically generated and tracked by github.

This is needed for the commit checker ci job to pass.

News file

We are generating the newsfile after each release automatically. So that to work, you need to add a news entry into the news directory. You can already find some examples there.

In your case you could create

news/packaging-3172.md

with a content:

`macOS`: add example startup configuration.

If you put the news entry into a second patch, the commit format check needs to be passed on that too.

[kira-syslogng]

Build SUCCESS

[kira-syslogng]

Build SUCCESS

[bazsi]

On Thu, Mar 12, 2020, 16:42 rcmelendez ***@***.***> wrote: ***@***.**** commented on this pull request. ------------------------------ In contrib/com.oneidentity.syslog-ng.plist <#3172 (comment)>: > + Tested environment: + - macOS Catalina 10.15.3 + - syslog-ng 3.25 + + Location to be stored: /Library/LaunchDaemons + Permissions: 644 root:wheel + If you need to manually start/stop the job: + - Start command: sudo launchctl load /Library/LaunchDaemons/com.oneidentity.syslog-ng.plist + - Stop command: sudo launchctl unload /Library/LaunchDaemons/com.oneidentity.syslog-ng.plist + + Author: Roberto Meléndez ***@***.*** on LinkedIn & Medium> + Created: March 11, 2020 +--> +<dict> + <key>Label</key> + <string>com.oneidentity.syslog-ng</string> Like com.syslog-ng.plist? For example, the syslogd implementation of Apple is called: com.apple.syslogd.plist

Yup. syslog-ng is hosted on its own domain, whereas syslogd is just one piece of apple macos.

[furiel]

Finally I could manage to get a working macOS environment and could test the config example. It worked for me (after editing the binary location to my custom install dir).

Me seems launchd does not support specifying stop or reload commands. I was hoping we could specify systemctl reload or stop. As I read from the manual, launchd just sends the term signal, and after the timeout, the kill signal. The only configurable thing is the timeout.

With that said, I am fine with the current feaute set.

[kira-syslogng]

Build SUCCESS

[kira-syslogng]

Build SUCCESS

[kira-syslogng]

Build SUCCESS

[kira-syslogng]

Build SUCCESS

[MrAnno]

Thanks for your contribution!

"One last thing" I've found is a PID name conflict, otherwise 👍 :)

[kira-syslogng]

Build SUCCESS