fixed incorrect apt-get invocation in upgrade manuals

[ugenk]

In upgrade manuals, in all debian/ubuntu examples there is incorrect apt-get command used.
apt-get upgrade by itself does not requires any parameters.
Upgrade of particular package is done by apt-get install package-name

---

📚 Documentation preview 📚: https://cloudstack-documentation--428.org.readthedocs.build/en/428/

[DaanHoogland]

@ugenk I think the proper way is to apt-get update <package> actually, what do you think? apt-get install <package> would assume it is a new package.

[ugenk]

nope, you can check the man page, and also actual results (see the list of the packages going to be upgraded):

ns1:~# apt upgrade
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Calculating upgrade... Done
The following packages were automatically installed and are no longer required:
  ftp g++-10 libaom0 libatk1.0-data libbpf0 libcbor0 libclamav9 libdav1d4 libdns-export1110 libevent-core-2.1-7 libevent-pthreads-2.1-7 libexporter-tiny-perl libgcrypt20-dev libgpg-error-dev libgs9-common
  libicu67 libidn11-dev libilmbase25 libisc-export1105 liblist-moreutils-perl liblist-moreutils-xs-perl liblua5.1-0 libmpdec3 libnet-ip-perl libnetpbm10 libnetwork-ipv4addr-perl libopenexr25 libopts25
  libperl5.32 libprocps8 libpython3.9 libpython3.9-minimal libpython3.9-stdlib libstdc++-10-dev libtfm1 libwmf-0.2-7 libwmf0.2-7 libx265-192 nagios-plugins-basic ntpsec-ntpdig perl-modules-5.32 pigz
  python3-ntp python3-ply python3-requests-toolbelt python3-zope.component python3-zope.event python3-zope.hookable python3-zope.interface python3.9 python3.9-minimal ruby2.7 sntp unbound-anchor
Use 'apt autoremove' to remove them.
The following packages will be upgraded:
  apache2-doc apache2-utils base-files curl gtk-update-icon-cache imagemagick imagemagick-6-common imagemagick-6.q16 initramfs-tools initramfs-tools-core ipmitool libc-bin libc-dev-bin libc-devtools
  libc-l10n libc6 libc6-dev libcurl3-gnutls libcurl4 libcurl4-gnutls-dev libgail-common libgail18 libgtk2.0-0 libgtk2.0-bin libgtk2.0-common libmagickcore-6.q16-6 libmagickcore-6.q16-6-extra
  libmagickwand-6.q16-6 libnss-systemd libpam-systemd libssl-dev libssl3 libsystemd-shared libsystemd0 libudev1 linux-libc-dev locales locales-all openssl systemd systemd-sysv udev
42 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Need to get 51.4 MB of archives.
After this operation, 4,537 kB of additional disk space will be used.
Do you want to continue? [Y/n] n
Abort.

ns1:~# apt upgrade libpam-systemd
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Calculating upgrade... Done
The following packages were automatically installed and are no longer required:
  ftp g++-10 libaom0 libatk1.0-data libbpf0 libcbor0 libclamav9 libdav1d4 libdns-export1110 libevent-core-2.1-7 libevent-pthreads-2.1-7 libexporter-tiny-perl libgcrypt20-dev libgpg-error-dev libgs9-common
  libicu67 libidn11-dev libilmbase25 libisc-export1105 liblist-moreutils-perl liblist-moreutils-xs-perl liblua5.1-0 libmpdec3 libnet-ip-perl libnetpbm10 libnetwork-ipv4addr-perl libopenexr25 libopts25
  libperl5.32 libprocps8 libpython3.9 libpython3.9-minimal libpython3.9-stdlib libstdc++-10-dev libtfm1 libwmf-0.2-7 libwmf0.2-7 libx265-192 nagios-plugins-basic ntpsec-ntpdig perl-modules-5.32 pigz
  python3-ntp python3-ply python3-requests-toolbelt python3-zope.component python3-zope.event python3-zope.hookable python3-zope.interface python3.9 python3.9-minimal ruby2.7 sntp unbound-anchor
Use 'apt autoremove' to remove them.
The following packages will be upgraded:
  apache2-doc apache2-utils base-files curl gtk-update-icon-cache imagemagick imagemagick-6-common imagemagick-6.q16 initramfs-tools initramfs-tools-core ipmitool libc-bin libc-dev-bin libc-devtools
  libc-l10n libc6 libc6-dev libcurl3-gnutls libcurl4 libcurl4-gnutls-dev libgail-common libgail18 libgtk2.0-0 libgtk2.0-bin libgtk2.0-common libmagickcore-6.q16-6 libmagickcore-6.q16-6-extra
  libmagickwand-6.q16-6 libnss-systemd libpam-systemd libssl-dev libssl3 libsystemd-shared libsystemd0 libudev1 linux-libc-dev locales locales-all openssl systemd systemd-sysv udev
42 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Need to get 51.4 MB of archives.
After this operation, 4,537 kB of additional disk space will be used.
Do you want to continue? [Y/n] n
Abort.

[ugenk]

       upgrade
           upgrade is used to install the newest versions of all packages currently installed on the system from the sources enumerated in /etc/apt/sources.list. Packages currently installed with new
           versions available are retrieved and upgraded; under no circumstances are currently installed packages removed, or packages not already installed retrieved and installed. New versions of
           currently installed packages that cannot be upgraded without changing the install status of another package will be left at their current version. An update must be performed first so that
           apt-get knows that new versions of packages are available.

actually, the best solution would be to merge both packages to one command, and specify their versions, like

apt-get install cloudstack-usage=4.19.1.1 cloudstack-management=4.19.1.1

[DaanHoogland]

@ugenk not upgrade, but update is the proper command.

[ugenk]

again nope, update just updates the cache of package lists. proper command is install.