Wiki incomplete / vague / incorrect? > Server update

[renaud.counhaye]

Hello everyone (it's me again),

I would like to understand why the server update is not so simple in the end.
On the Wiki:
https://www.wapt.fr/fr/doc-1.6/waptserv ...ebian.html

apt-get update && apt-get upgrade
apt-get install apt-transport-https lsb-release
wget -O - https://wapt.tranquil.it/debian/tiswapt-pub.gpg | apt-key add -
echo "deb https://wapt.tranquil.it/debian/wapt-1.6/ $(lsb_release -c -s) main" > /etc/apt/sources.list.d/wapt.list

Why not permanently add the TranquilIT repository to Debian? It doesn't seem to work here...

Then you write:

If you upgrade your distribution with `apt-get dist-upgrade`, be sure to update your `lsb_release` in `/etc/apt/sources.list.d/wapt.list` (example: Jessie -> Stretch).

`apt-get update` `apt-get install tis-waptserver` `tis-waptsetup`

which means that the part apt-get update apt-get install tis-waptserver tis-waptsetup is somewhat "hidden" from the rest.
Furthermore, the command syntax is incorrect... this forces the user to execute the entire command, which is not correct.
Running `apt-get update` and then `apt-get upgrade` would be more logical, but here we're talking about `apt-get install` (probably because the WAPT TranquilIT repository isn't in the list?) (I'm not a Linux user either)

Finally, I was previously on version 1.5 and after updating to 1.6, the documentation for the update is missing:

Update from 1.5 to 1.6.
The update is performed as a minor update.

If you are using Debian Jessie, it is recommended to upgrade to Debian Stretch. This is mandatory for the Enterprise edition with Windows Update support. When upgrading to Debian Stretch, the PostgreSQL database must be upgraded to version 9.6.

No instructions were given, leading one to believe that a simple 'apt-get update' followed by 'apt-get upgrade' would suffice, but that wasn't the case. A link to the WAPT server minor update procedure would be clearer. ^^"

Finally, I see that on the changelog you mention 1.6.2.8, however no matter how many times I do apt-get install, it tells me that I am on the latest version.

root@wapt # apt-get install tis-waptserver tis-waptsetup
Reading package lists... Done
Building dependency tree
Reading state information... Done
tis-waptserver is already the newest version (1.6.2.7-tisdeb9-5538-962880c0).
tis-waptsetup is already the newest version (1.6.2.7-tisdeb9-5538-962880c0).
0 upgraded, 0 newly installed, 0 to remove and 5 not upgraded.

This would mean that version 1.6.2.8 is published elsewhere or is an Enterprise-only version; again, the documentation is vague. As a Community customer, I'm not given priority in my requests, but I'm not asking for anything other than clearer communication

By the way, regarding the database update, the database version number isn't always the same as the server version. Is that a problem? Should we run a command to upgrade it? Nothing about that either. :/

PS: The forum search function is really unreliable; when I searched for 'server update 1.6.2.8':
The following words from your search were ignored because they are too common: server update to 1628.
You must enter at least one word to perform a search. Each word must be at least 3 characters long and no more than 14 characters, excluding wildcards.

[dcardon]

Hello renaud.counhaye,

I would like to understand why the server update is not so simple in the end.

Of course, everything is relative.

Why not permanently add the TranquilIT repository to Debian? It doesn't seem to work here...

If you have maintainer status, you can take care of it.

Then you write:

If you upgrade your distribution with `apt-get dist-upgrade`, be sure to update your `lsb_release` in `/etc/apt/sources.list.d/wapt.list` (example: Jessie -> Stretch).
`apt-get update` `apt-get install tis-waptserver` `tis-waptsetup`

which means that the part apt-get update apt-get install tis-waptserver tis-waptsetup is somewhat "hidden" from the rest.
Furthermore, the command syntax is incorrect... this forces the user to execute the entire command, which is not correct.
Running `apt-get update` and then `apt-get upgrade` would be more logical, but here we're talking about `apt-get install` (probably because the WAPT TranquilIT repository isn't in the list?)

If you had looked at the RST source code, you would have seen that it was on two lines. There was a formatting error. It's fixed in the Git repository, and the build should follow soon. Thanks for pointing it out, even if the wording is a bit awkward.

(I'm not a Linux user either)

No worries, WAPT is a tolerant and inclusive community.

Finally, I was previously on version 1.5 and after updating to 1.6, the documentation for the update is missing:

Update from 1.5 to 1.6.
The update is performed as a minor update.

If you are using Debian Jessie, it is recommended to upgrade to Debian Stretch. This is mandatory for the Enterprise edition with Windows Update support. When upgrading to Debian Stretch, the PostgreSQL database must be upgraded to version 9.6.

No instructions were given, leading one to believe that a simple 'apt-get update' followed by 'apt-get upgrade' would suffice, but that wasn't the case. A link to the WAPT server minor update procedure would be clearer. ^^"

I confess I didn't quite understand.

Finally, I see that you mention version 1.6.2.8 in the changelog, however, no matter how many times I run `apt-get install`, it tells me I'm already on the latest version.
...
Which would mean that 1.6.2.8 is published elsewhere or is an Enterprise Only version; again, the documentation is vague. As a Community customer, I'm not given priority in my requests, but I'm not asking for anything except clearer communication.

The code is up to date on GitHub. You can test the build documentation and provide constructive feedback.

By the way, regarding the database update, the database version number isn't always the same as the server version. Is that a problem? Should we run a command to upgrade it? Nothing about that either :/

Perhaps it's time for you to start your own blog and include the details you wish you had found. Nobody's perfect, not even the WAPT maintainers.

PS: The forum search is really buggy. When I searched for 'server update 1.6.2.8':
The following words in your search were ignored because they are too common: server update to 1 6 2 8.
You must enter at least one word to perform a search. Each word must be at least 3 characters long and no more than 14 characters, excluding wildcards.

Google is your friend, the site is well indexed.

Sincerely,

Denis

PS: Regarding the title of your post, the documentation is not based on a wiki but on Sphinx / RST.

[renaud.counhaye]

Hello Denis,

Thank you for all your replies and the minor corrections. My apologies if my message seemed abrupt or harsh; that was far from my intention.
Regarding the blog, I don't think I have enough experience with your system for that.

As for the part you didn't quite understand, I see why; I wasn't clear either.
I meant to say: The text indicates to perform the update as a minor update, which, at first glance, could be misinterpreted, so I simply suggest adding a link to the procedure.

I'm becoming increasingly interested in the Enterprise version, in any case.

Have a good day,
Renaud