Booting up the old Blog

Once in a while, I get inspired, or in this case, someone beat me to doing something, and so I have forked their project for my own, and soon to be, your benefit.

When I started down the road with the AI Admin app, it was, like most people find, a small step forward, but one that helped me get a clearer picture of what works, doesn't work, and what makes you want to smash your laptop in pieces.

But that left me wondering, what else I could do to help my fellow admins and wayward developers who must do admin stuff?

5 days ago, although I only saw the post 3 days ago, Heiko posted about this site: https://bryanhsiao.github.io/domino-news/en/.

This is great for developers and people who speak Taiwanese.

I have been playing with a blog posting app, I have 2 others that are active and still tweaking, unrelated to my Domino work, for Admins, and realized Bryan had put this up on GitHub for people to adapt.

Well, I adapted it.

And it took 2 days of testing to get it to a point where it is ready and puts the posts into my blog feed.

I will be editing them slightly, but it gets 95% of what I want done on its own.

You can go look at the site and the GitHub links he has.

Right now, it is random topics while I work on prompting it for specific topics.

Do we need more tech info? Maybe, maybe not.

But sometimes you do want information in one place rather than hopping all over the HCL docs.

In any event, I hope to get 2-3 a week out if they meet the guidelines, so far only 1 out of 8 has met them.

That post will go out overnight, well, for my time zone.

ClamAV and Domino

 I am not an expert on Anti-virus things and Domino, that would be Daniel Nashed.

But if HCL Domino has something new, I test it out and set it up on my server.

In this case, I had heard that ClamAV would now work with Domino as of 14.5.1.

Having used Clam for many years at the OS level, I wanted to play with this in Domino.

My server is Windows, not Linux, ClamAV Linux instructions are pretty common, Windows, not as much.

Boy was this the hardest "easy' thing to do ever.

To start, HCL provides no documentation.

There are only 3 references to ClamAV in the official docs:

https://help.hcl-software.com/domino/14.5.1/admin/wn_config_features_1451.html#wn_config_features_1451__section_fq1_wgc_23c

https://help.hcl-software.com/domino/14.5.1/admin/conf_configuringscanninginscscancfg.html?hl=clamav

https://help.hcl-software.com/domino/14.5.1/admin/conf_scanningattachmentsforviruses.html?hl=clamav

None of which tell you much about how to set up ClamAV or how to configure it for Domino integration.

I opened a ticket and eventually was directed to this post:

https://support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0129703

Which is in Japanese. Use Google Translate or Chrome built in translstion.

I see now, at my urging, HCL has released the same document in English.

https://support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0131220

Their perspective is that we should go to ClamAv to set it up and then magically know how to integrate it.

I asked why it wasn't in the actual documentation and got a runaround answer, given HCL announced the availability, not ClamAV.

The new technical document covers some of the set up required.

I am going to add what is missing, more for my benefit, and anyone else who will try this on their servers.

Step 1 is Download the ClamAV from the link in the document, https://www.clamav.net/downloads and install it. BUT this does not tell you how to set it up in Services.

For that, you perform this:

Open the Windows Command Prompt as an Administrator and navigate to your ClamAV folder.

Run the following command to install the ClamAV daemon service:
clamd.exe --install

Remember to set it to automatic.

Step 2 is to copy the config file as described and perform the edits.

Step 3, however, did not work for me no matter how I tried to get the certificate. Even with HCL Support help, they eventually had to send me the certificate required.

Step 4: You have to get the updated virus definitions. NOTE: This is a once off effort. And Manual.

If you want it to be automatic, and you do, you need to do these steps.

Open the Windows Command Prompt as an Administrator and navigate to your ClamAV folder.

Run the following command to install the ClamAV daemon service:
freshclam.exe --install

Once you Load mailscan at the Domino server console you will get the cscancfg.nsf and need to follow the document entries as provided.

NOTE: The ClamAV server name(DNS) must be 127.0.0.1. Do not put your server IP there, it will not work at all.

Make sure you open port 3310 with your local server firewall, and in my case, the outside ISP.

I changed the Subject Prefix Scanned field default text to something I would know came from my server, not a spammer.

Lastly, make sure you add Mailscan to your tasks line in your notes.ini also something not mentioned in the document that is kind of important, unless you like having your mail stuck in mail.box and spend 2 hours troubleshooting it one morning, like I just did.

I eventually figured out it was an AV issue when running SMTPDebugClient=1 and

Tell Router list run from the server console.

You see this:

Mbx NoteID          ID          State          Size Pri Count ScheduledDate           From

  1 000008FE 0028261D Wait AV        8443         1                         K Brooks/org

  2 00000902 00283C39 Wait AV       13306         1                         kbrooks@test.com

  1 00000902 002864E3 Wait AV        8749         1                         keith@gmail.com

  2 00000906 00287C9A Wait AV        8640         1                         keith@gmail.com

Oh, that makes sense after the server restarted late yesterday. Mailscan was not in tasks.

So, my time spent, is your time gained.