This file is readable and signed.
The information about the subscription is visible.
The file is signed in the headings with the subscriber's details, as a result it must not be modified (except for url repositories), otherwise it risks being invalidated.
If you're using an evaluation subscription, you can modify repository access urls to change distributions.
If you're using a Prod, Pre-Prod or Free subscription, do not edit the subscription file. You must request it from us in advance, e.g. if you want to change server distributions. We will provide you with a new subscription valid for your new environment.
Do not distribute or give this file to any third parties; access to repositories are subscriber-specific and tracked.
System updates and migration
The subscription file contains the addresses of BlueMind's repositories and can be accessed by the system depending on its version. The file must therefore be updated when the system or BlueMind is updated in order to install the corresponding versions of BlueMind packages as well as the new additional packages.
The process is the same as for installation, it is not a simple file update.
Installing subscriptions
BlueMind must be installed before installing your install the subscription using the installer available for download on the BlueMind website.
To activate a subscription and additional components, proceed as follows:
install the subscription file
update packages to get new components
configure BlueMind using the new interactive tool
Perform a complete system backup
BlueMind makes every effort to provide reliable updates. In some special untested cases or due to external factors, however, data may be lost unexpectedly. BlueMind may not be held responsible for any possible update failure leading to system corruption.
It is your responsibility to prevent this risk by performing a complete backup of your system.
Installing the dedicated package
First, install the dedicated package:
sudo aptitude install bm-plugin-core-subscription sudo bmctl restart
yum install bm-plugin-core-subscription bmctl restart
Installing the subscription file
From May 2018, subscriptions are provided as .zip archivers which contains files for all supported versions. You don't need to extract the files, the system will automatically identify what it needs.
On the main server
Connect to the BlueMind administration console as global administrator admin0 (username: admin0@global.virt)
Go to System Management > Subscription management
Using the "Update Subscription" button, search your computer for the subscription archive and open it.
BlueMind installs the subscription.
The effect is immediate and doesn't require a service restart.Even when a subscription is installed, the form remains active in order to allow replacements, e.g. when the subscription expires.
On other servers
The subscription file must be copied on other BlueMind installation servers (archiving server, etc.).
To do this, connect as root to the main server and copy the file remotely:
scp /etc/apt/sources.list.d/bm.list root@<machine2>:/etc/apt/sources.list.d/bm.list
scp /etc/yum.repos.d/bm.repo root@<machine2>:/etc/yum.repos.d/
Updating software packages
The subscription file contains the addresses of BlueMind repositories and allows them to access the system. As a result, it must be updated in order to install the latest package versions as well as additional packages.
To do this, connect to the server and type in the following commands:
This operation must be performed on every BlueMind server related to the subscription (production, test or evaluation).
sudo aptitude update sudo aptitude upgrade
yum makecache yum upgrade
Installing new packages
The following packages are now available:
- bm-setup-wizard: full-featured version of the Setup and Update Wizard
- bm-connector-outlook* and bm-plugin-core-outlook*: Outlook connector
- bm-plugin-core-ad-import*: ActiveDirectory import tool
* optional packages, depending on your needs
On the core server (the one where the BlueMind installation has been performed), install the new packages and restart BlueMind:
sudo aptitude install bm-setup-wizard bm-connector-outlook bm-plugin-admin-console-ad-import bm-plugin-core-ad-import sudo bmctl restart
rpm -e --nodeps bm-installation-wizard yum install bm-setup-wizard bm-setup-wizard bm-connector-outlook bm-plugin-admin-console-ad-import bm-plugin-core-ad-import bmctl restart
Post-update setup
The update manager tool – Setup Wizard – is now available.
Connect to the wizard with your web browser at https://[your_server_ip]/setup.
The Setup wizard loads up and displays the prerequisite status checklist.
- If the Setup Wizard blocks installation, correct the prerequisite and start the installation again
- If the Setup Wizard displays warnings:
- Resolve the warnings and reload the page /setup in your web browser (access https://[your_server_ip]/setup again)
- or click "Continuer en ignorant les problèmes" ("Keep ignoring problems"). (This choice isn't recommended, unless you know exactly what you are doing).
If the packages were already up to date, a message indicating that the system is ready for use is displayed. Otherwise, go on to the step below:
Click "Mise à jour" ("Update").
Next to this button the current version of the data and the new version to which the update will be performed is displayed.
During the update process, access to the BlueMind application is no longer possible and a warning page informs any users who might try to access it.
The update is executed and when it is complete, the Setup Wizard displays a page "Configuration réussie" ("Setup successful") with links to BlueMind.
Checking installation
Go back to the Administration console > System Management > Subscription Management installation and check that the information contained in the subscription appears correctly.
Update Notices
BlueMind subscriptions include updates. Make sure to subscribe to our dedicated newsletter to be kept informed of new versions – updates and upgrades: https://lists.bluemind.net/mailman/listinfo/bluemind
Attribuer le rôle de gestion
When the subscription's maximum number of users has been reached (or is close to) or when the subscription's expiry date approaches, information banners will appear in the admin console as well as the BlueMind application.
To see these banners, users must have the subcription management role. To manage this, go to the user's administration page and grant them the "Manage the subscription" role.
Users may encounter two situations:
- they do not have access to the admin console, they will receive notification emails.
- they do have access to the admin console, they will receive notification emails and access the to the administration page that enables them to install and update the subscription
For more information about this, go to the dedicated page: BlueMind Subcription
The Outlook connector
Once the subscription and the packages are installed, you can provision users with the Outlook connector so that they can fully synchronize their BlueMind mail and contacts as well as calendars.
ActiveDirectory Import
If you've installed the package, you can also use the AD import feature. Please go to ActiveDirectory Synchronization for further details.
Updating subscriptions
Outside system or BlueMind version updates, once a subscription is installed and effective, there is no need to install new packages. Only the new subscription file needs to be installed.
From May 2018, subscriptions are provided as .zip archivers which contains files for all supported versions. You don't need to extract the files, the system will automatically identify what it needs.
Updating the new subscription file
On the main server
- Connect to the BlueMind Administration console as admin0 (login: admin0@global.virt)
- Go to System Management > Subscription Management
Using the "Update Subscription" button, search your computer for the subscription archive and open it.
BlueMind installs the subscription.
The effect is immediate and doesn't require a service restart.
On other servers
The subscription file must be copied on other BlueMind installation servers (archiving server, etc.).
To do this, connect as root to the main server and copy the file remotely:
scp /etc/apt.sources.list.d/bm.list root@<machine2>:/etc/apt.sources.list.d/bm.list
scp /etc/yum.repos.d/bm.repo root@<machine2>:/etc/yum.repos.d/
Deleting a subscription
When a subscription expires or for any other reason, you can delete subscriptions and go back to using BlueMind subscription-free:
- Log into the BlueMind admin console as admin0 (user login: admin0@global.virt )
- go to System management > Manage subscription
- Click "Remove subscription":
- Confirm when prompted after having read the terms and conditions
Restart BlueMind:
bmctl restart