[syslog-ng] [EXTERNAL] Re: Upgrade to 3.31 from 3.19

Faine, Mark R. (MSFC-IS40)[NICS] mark.faine at nasa.gov
Tue Mar 23 17:03:13 UTC 2021

Thanks, this worked once I got systemd working properly in the container.

Fortunately there were no issues and all I had to do was change the version number.


From: Faine, Mark R. (MSFC-IS40)[NICS]
Sent: Tuesday, March 23, 2021 09:44
To: Syslog-ng users' and developers' mailing list <syslog-ng at lists.balabit.hu>
Subject: RE: [EXTERNAL] Re: [syslog-ng] Upgrade to 3.31 from 3.19

Thanks, I did this in a docker container and the only warning I got was for the @version value.  It said it was using compatibility mode.  If I simply change the version line to 3.31 it won't even start, so that's not an option.  I can go up to 3.28 before it stops starting.

I would rather not try Peter's solution but I will if I have to.  I was hoping I could do as you said and simply correct the errors, but I get no other error messages.


From: syslog-ng <syslog-ng-bounces at lists.balabit.hu<mailto:syslog-ng-bounces at lists.balabit.hu>> On Behalf Of Balazs Scheidler
Sent: Monday, March 22, 2021 23:42
To: Syslog-ng users' and developers' mailing list <syslog-ng at lists.balabit.hu<mailto:syslog-ng at lists.balabit.hu>>
Subject: [EXTERNAL] Re: [syslog-ng] Upgrade to 3.31 from 3.19

If all you want is to upgrade syslog-ng, then run the new version with an unchanged config file (on a separate test system even), and observe "configuration" change warnings during startup.

The one you'll definitely get is about the '@version' line at the top of your config. This probably says '@version: 3.19'.

Don't fix the version declaration until you fix the rest of the warnings: syslog-ng operates in compatibility mode with the old version, and gives you instructions about what was changed since the old version. These warnings are emitted during startup, so look for log messages generated by syslog-ng right after starting up.

For instance, if a default changes between your old version and current versiony syslog-ng would tell you something like

WARNING: the default for whatever option was changed in syslog-ng 3.25, please adapt your configuration

What this means is that you might need to be explicit about the setting in your config and not rely on the default. So add the option and its desired value to the config explicitly. Or if you thing the new default is ok, just ignore the message and fix the rest too.

These days the number of config changes is pretty rare, so you might not have any warnings, except for @version.

Once you handled all the warnings just update @version and you are done.


On Tue, Mar 23, 2021, 00:02 Peter Kokai (pkokai) <Peter.Kokai at oneidentity.com<mailto:Peter.Kokai at oneidentity.com>> wrote:

I am not aware such database or tools that can do it out of box. In general your old configuration should at least syntax check in newer version, and probably even start up without much trouble. If something is replaced in the config usually the old option is kept and in the background uses the new mechanism.
There is a tool https://github.com/syslog-ng/syslog-ng/blob/master/contrib/config_option_database/syslog-ng-cfg-db.py<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fsyslog-ng%2Fsyslog-ng%2Fblob%2Fmaster%2Fcontrib%2Fconfig_option_database%2Fsyslog-ng-cfg-db.py&data=04%7C01%7Cmark.faine%40nasa.gov%7C6208b010aba74a2aab2e08d8edb6309a%7C7005d45845be48ae8140d43da96dd17b%7C0%7C0%7C637520714070930571%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000&sdata=Tir3CwKde%2BeLH7P2aNed7buq7EA7O8jJHfhZMAAMoJI%3D&reserved=0>
That prints all possible configuration options for destination, parser and source currently. But you still need to run this for both version and compare.

The issue with that, the tool was not present in 3.19.1 and just copy&paste won't work (tried), some adjustment might be needed.

I think if you have time to work on, the tool can be tricked into doing your use case.
As far as I am know the tool itself actually uses bison to generate the possible tree (xml, and dot format).
Once converted to a graph, all you need is a way to diff graphs.

Checking via the diff looks like even more work.
git diff syslog-ng-3.19.1...syslog-ng-3.31.1 --stat  -- '*-grammar.y*'
49 files changed, 1656 insertions(+), 828 deletions(-)


From: syslog-ng <syslog-ng-bounces at lists.balabit.hu<mailto:syslog-ng-bounces at lists.balabit.hu>> on behalf of Faine, Mark R. (MSFC-IS40)[NICS] <mark.faine at nasa.gov<mailto:mark.faine at nasa.gov>>
Sent: 22 March 2021 23:03
To: Syslog-ng users' and developers' mailing list
Subject: [syslog-ng] Upgrade to 3.31 from 3.19

CAUTION: This email originated from outside of the organization. Do not follow guidance, click links, or open attachments unless you recognize the sender and know the content is safe.

I need to know the significant format differences between the configuration files for the two versions.  Is there some place I can go to get that or some command I can run to convert the file?


Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng<https://gcc02.safelinks.protection.outlook.com/?url=https%3A%2F%2Flists.balabit.hu%2Fmailman%2Flistinfo%2Fsyslog-ng&data=04%7C01%7Cmark.faine%40nasa.gov%7C6208b010aba74a2aab2e08d8edb6309a%7C7005d45845be48ae8140d43da96dd17b%7C0%7C0%7C637520714070940528%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000&sdata=MmoSjmI1NnmENRd%2Fa%2F%2F3Pm2p1zbP7ya%2B57GyTX62qBo%3D&reserved=0>
Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng<https://gcc02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.balabit.com%2Fsupport%2Fdocumentation%2F%3Fproduct%3Dsyslog-ng&data=04%7C01%7Cmark.faine%40nasa.gov%7C6208b010aba74a2aab2e08d8edb6309a%7C7005d45845be48ae8140d43da96dd17b%7C0%7C0%7C637520714070940528%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000&sdata=%2B%2BDYljzeNpX%2Bcedwtyz03CKt5faA1D%2FC8yXnxeD5gXo%3D&reserved=0>
FAQ: http://www.balabit.com/wiki/syslog-ng-faq<https://gcc02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.balabit.com%2Fwiki%2Fsyslog-ng-faq&data=04%7C01%7Cmark.faine%40nasa.gov%7C6208b010aba74a2aab2e08d8edb6309a%7C7005d45845be48ae8140d43da96dd17b%7C0%7C0%7C637520714070950484%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000&sdata=pZ%2Bx6Fx3EOejNLkN%2BuqiGFoSs0HjWgBBzMDErypu5Ew%3D&reserved=0>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.balabit.hu/pipermail/syslog-ng/attachments/20210323/c64e7a5a/attachment-0001.html>

More information about the syslog-ng mailing list