Skip to end of metadata
Go to start of metadata

Introduction

The subscription

BlueMind's software is Open Source. The BlueMind subscription is a professional offering designed to simplify and ensure production use and provide better connectivity with Outlook and ActiveDirectory.

The subscription file

The BlueMind subscription is provided as a readable text file, which provides a unique key that integrates the subscriber's characteristics, including:

  • number of users (for SAAS offerings, the notion of user profiles is also included)

  • operating system:

    • Debian Squeeze 64bits

    • Debian Wheezy 64bits

    • Ubuntu 10.04 64bits

    • Ubuntu 12.04 64bits

    • RedHat 6 64bits

  • subscription type:

    • production (Prod et Pre-Prod)
    • évaluation (Eval)
    • particuliers et associations OpenSource (Free)
    • partenaires technologiques (Dev)
  • expiry date

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 and Free subscription, do not modify 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 beforehand using the installer available to download on the BlueMind website.

To activate a subscription and additional components, proceed with the following 3 steps:

  1. install the subscription file

  2. update packages to get new components

  3. 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:

Debian/Ubuntu
sudo aptitude install bm-plugin-core-subscription
sudo bmctl restart
Debian/Ubuntu
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 file and open it.
    BlueMind installs the subscription.
    The effect is immediate and doesn't require a restart of service.

    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:

Debian/Ubuntu
scp /etc/apt.sources.list.d/bm.list root@<machine2>:/etc/apt.sources.list.d/bm.list
RedHat
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).

Debian/Ubuntu
sudo aptitude update
sudo aptitude upgrade
RedHat
yum makecache
yum upgrade

Installing new packages

The following packages are now available:

  • bm-setup-wizard: special version of the set up 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:

Debian/Ubuntu
sudo aptitude install bm-setup-wizard bm-connector-outlook bm-plugin-admin-console-ad-import bm-plugin-core-ad-import
sudo bmctl restart
RedHat
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.

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 file and open it.
    BlueMind installs the subscription.
    The effect is immediate and doesn't require a restart of service.

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:

Debian/Ubuntu
scp /etc/apt.sources.list.d/bm.list root@<machine2>:/etc/apt.sources.list.d/bm.list
RedHat
scp /etc/yum.repos.d/bm.repo root@<machine2>:/etc/yum.repos.d/

Enregistrer

Enregistrer

Enregistrer

Enregistrer

  • No labels