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

To activate a subscription and additional components, proceed as follows:

1. install the subscription file

2. update packages to get new components

3. configure BlueMind using the new interactive tool

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

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:

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.

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.

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:

1. they do not have access to the admin console, they will receive notification emails. 
2. 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.

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