Skip to main content

Updating BlueMind

The BlueMind subscription includes a simplified, tried and tested update system.

Updating BlueMind to a higher corrective or adaptive version is then simplified, safer and faster thanks to the integrated tools.

Updating BlueMind 4 to BlueMind 5

If you are upgrading to a major version of BlueMind, be sure to first consult the dedicated page to validate the particular requirements and points to watch out for: Upgrading BlueMind 4 to BlueMind 5.

Prerequisites​

Saving the whole system​

BlueMind makes every effort to provide reliable updates. However, no one is immune to particular untested cases or external factors that may lead to data loss. BlueMind may not be held responsible for any possible update failure leading to system corruption.

It is therefore your responsibility to protect you from this risk by performing a complete backup of your system.

Updating Linux distribution​

Upgrading your Linux distribution to a higher major version (Debian 10 to Debian 11 for example) should not be done with automatic distribution update mechanisms (changing package sources and using the aptitude dist-upgrade command). Indeed, BlueMind dependencies can be modified and BlueMind services may be impacted.

For a major version upgrade of the distribution, please contact your integrator provider or contact us via our ticketing platform.

Subscriptions​

To access BlueMind update tools, you must have a valid and current subscription installed.

Access to the installation wizard​

In order to update, the installation wizard access must be effective.

⇒ Check access by connecting to the address http://your.server.com/setup with the login admin and the password provided during the installation of BlueMind.

In case of loss, this password can be reset in two ways: via the administration console or on the command line.

Reset via admin console​

  • log in as global administrator admin0
  • go to System Management > System Configuration > 'Proxy Server' tab
  • fill in the new password
  • save

Command Line Reset​

  • connect to the BlueMind server as root and type the following command: 
    bm-cli sysconf set sw_password -v MyAdminSetupWizardP@sswordAndMustBeChanged
    Note: the password is shown here as an example, it should be personalized
  • connect to the URL http://your.server.com/setup
    • login: admin
    • password MyAdminSetupWizardP@sswordAndMustBeChanged (or other if customized in previous step)

      ❗ This step is imperative, even if you are not yet updating BlueMind.

Repository signature​

The repositories are signed for all supported Ubuntu/Debian distributions. It is possible, if necessary or necessary, to manually import the key to all these via the following command:

curl https://pkg.bluemind.net/bluemind-deb.asc -o /etc/apt/trusted.gpg.d/bluemind.gpg

Otherwise, a warning message may occur when updating without it being caught.

Updating procedure​

Since the software repositories are taken into account by the system from the subscription installation, BlueMind can be automatically updated during system updates.

note

If you've made changes to configuration files manually, make sure you back them up. For more information, see in Appendices: note on configuration files

Preparing for the update​

For an update of a BlueMind already in version 5, the update process must be initiated by an administrator. This allows for greater version control and limits the risk of error: the target version can now be opened, in order to always update to the latest published version, or conversely frozen, to prevent unintentional updates. This also helps ensure that the server's major version as well as additional packages are conformed to.

This preparation can be done in two ways: via the administration console or on the command line.

Preparation via admin console​

  • go to System management > Update BlueMind
  • Click "Setup": the latest available version will be installed.

Command Line Preparation​

Contrary to the administration console, the command line tool allows to target the version to update the installation to:

To update to the latest available version use latest :

bm-cli setup version latest
Availability of bm-cli commands

The commands of the bm-cli tool must have been installed during the implementation of the subscription.

Updating packages​

Multiserver installation

The BlueMind update process starts with the update of packages on all servers in the installation. Then the upgrade phase itself will only be played once.

  1. Log in as root on each of the servers in the installation

  2. Update the packages on each of them:

    💡 Limit the service interruption time The update command can be launched with the download-only option to only download the packages without causing any interruption or slowing down of services. This action can therefore be performed at any time. The upgrade command for effective package update can then be launched at the most appropriate time.

    aptitude update
aptitude --download-only upgrade
    aptitude update
aptitude upgrade

Updating BlueMind​

BlueMind update can be performed either via command line using the bm-cli tool or by using the graphical interface of the Setup Wizard.

Via command line with bm-cli​

Once the packages are updated on the server(s) (see above), launch the update command:

bm-cli setup upgrade

Updating BlueMind using the graphical assistant​

Once the packages are updated on the server(s) (see above):

  1. Go with a browser to the management interface of updates http://your.server.com/setup:

    💡 This step requires the access password to the installation assistant - see Accessing the Installation Assistant above

  2. Launch the automatic procedure of configuring BlueMind by clicking on the button " Update this installation "

  3. Once the process has been completed, a message informs you of the correct movement: ⇒ Access to BlueMind is possible at its usual URL

Error logs

In case of problems, errors are written in the logs of bm-core and bm-webserver.

Appendices​

Notes on configuration files​

Postfix​

Postfix configuration is overwritten only during the installation phase. From then on, this configuration can be updated using the command postconf. Configuration files can be customized as required, except for:

  • Remove BlueMind maps: maps can however be added.
  • Edit mynetwork from the admin console.
  • Edit relayhost from the admin console.

Nginx​

The virtual host is overridden with each update.
All VHosts are disabled during an update and only those of BlueMind (bm-client-access and bm-webmail) are reactivated. Others can be reactivated by following, but this must be provided by administrators as part of a custom update process, which complements the one provided by BlueMind.

BlueMind's virtual host can also be extended through the /etc/nginx/bm-local.d/*.conf files`.

Last updated on