If you haven't updated BlueMind to the latest published version, there may be a conflict between the packages installed because bm-cli will install its latest available version.
To avoid this, you can:
- either update your BlueMind installation beforehand (recommended solution)
or force the version number in the subscription before installing bm-cli in the same version as your BlueMind.
To do this, edit the file
/etc/apt/sources.list.d/bm.listand remplace "3.5" by the version number you want to use in the url:
Note: we recommend that you copy the command line – as above – and comment the first version by adding # at the beginning of the line. This will make going back easier.
when you do this, the version for your entire BlueMind installation is frozen. Once the packages are installed, remember to change the version number back to the generic number so that you can update BlueMind in due course.
The bm-cli client is installed through a dedicated package on the server – available from BlueMind 3.5.10:
No restart is required, the commands are effective immediately.
Using the client
Commands are passed using a terminal straight onto the server, connected via ssh for instance.
For example, the following command can help you find out a user's address books:
Commands are improved with every version of BlueMind. You may have more or fewer commands depending on the version you have installed.
Make sure you check the "bm-cli help" command to find out which commands are available.
This installation – version 3.5.11 – includes calendar, contacts and user commands which did not exist in earlier versions.
You can get help on a command, sub-command, how to use it and its options using "help" at any time.
E.g. "help maintenance" shows the maintenance command and the actions it can perform:
For more details about a sub-command, type it to get help, e.g. about index consolidation:
Administration and Maintenance
Performing a domain-wide check&repair
The following command is used to perform a "check and repair" on all domain users using 4 threads:
Changing the admin0 password
For multiple reasons – technical or practical, e.g. in case of loss -- you may need to change the admin0 user's password without logging into BlueMind.
The following command allows you to do this without knowing the old password:
Updating Tick configuration
When the Bm-Tick monitoring tool is installed, you can use it to perform administration tasks. E.g. you can roll out the configuration on all domain servers again using the following command:
--dry is added to test the command: the operation is merely simulated
Operations on users
Deleting archived (suspended) domain users
"bm-cli user" command will be available from BlueMind 3.5.11.
Commands can be coupled to perform several operations at once.
E.g. the command below is used to look for the email addresses of suspended users:
You can then couple this command's return with a "delete" command to remove all the users it returns:
Operations on calendars
Sharing all user calendars with one user
It may be useful for one user to have access privileges on all user calendars without being given an administrator role (e.g. a secretary might be able to view/create events for all other employees). To avoid having to go through each user's page to enable sharing, this can be done in command line.
This cannot be done with a single command, but you can create a loop which picks up all domain users and enables sharing for each of them:
Operations on contacts
The procedure below can be used to clean a user's collected address book and transfer their contacts to their personal address book (and testing the import process beforehand):