opsi-utils: Now with manpages! (Again!)

Do you know that feeling when you are sure certain things exist but others don't? I had that exact feeling a short while ago during a discussing with one of our support staff. I thought it would be a good idea to show the documentation so I told him to just open the manpages.

After a short silence he said that there are no manpages and he'd be surprised if there would be. But I was certain, I did bring them into the build process and the files are there! We checked and he was right: no manpages existed. There weren't even appropriate files to be found on the server. That seemed impossible!

After I checked the script used for creating the packages everything seemed good. But it began to dawn on me why there were no manpages installed.

The old building process all took place on one machine where we would manually update the working copy of the repository and then run a script that gave us three files we would then load into OBS. That script did also include the manpages.

Because there are usually only few changes on the options of the utility script the creation of the manpages was a separate script. Our manpages are written in asciidoc and then converted into the required format. This makes writing them very easy. After they are converted to the manpage format we use them for all the different distributions we support.

This was not a problem as long as we kept building on that machine and only updated the files in our working copy. But a while ago we switched to Jenkins to fulfill this task whenever we push something new onto the repository. The switch was successful but one thing was forgotten: running the script that creates the manpages!

The fix was a small one and since opsi-utils 4.0.7.14-2 the manpages are installed alongside the programs. Again.

Upcoming: CeBIT 2017

The current week was for nearly all of us under the sign of CeBIT which will take place at Hannover, Germany the next week. The technology fair is an important date for the company and we use it not only to talk to users old and new but also to show new features.

We will be in the Open Source Park in hall 3 at D35 and we'd love to talk to you!

For presentations we bring some machines with us that hold complete demo environments. The demo environments feature various virtual clients all equipped with different operating systems and a complete Samba 4 AD DC. Of course all these were set up using opsi! Admittedly it took us some time to be able to set up the machines through opsi like this but we end up with multiple machines set up to feature the exact same installations and data. And now all it takes to set up a machine like this just requires a few clicks.

People from the dev team will be present the whole week and there will be a talk about our testing environment on friday. I've even heard some rumors about opsi swag... ;)

So if you are at CeBIT come and visit us!