Installing Miradore client for Linux

You can install Miradore's Linux Client either from a local drive or from a client repository at the HTTP installation point. This article describes both methods.

We recommend to install clients from the repository, because it has certain information security benefits regarding client upgrades and also because it makes it easier to upgrade the clients automatically.

Steps for installing Miradore client from a local drive

Miradore client can be installed without the repository from a local drive using rpm or dpkg package files. See the provided steps for explanation.

Select the correct .rpm or .deb archive for the particular distribution.
- The .rpm or .deb archives can be found from the following location at the installation point "http://<installation_point_address>/<installation_point_directory>/_System/Miradore/Linux/Current" or from the installation directory of Miradore at the following location "Setup\_System\Miradore\Linux\Current".
Run the following command as superuser (with root privileges):

rpm -i miradoreclient-<version>.<architecture>.rpm

or

dpkg -i miradoreclient_<version>.<architecture>.deb
1. - Replace the version and architecture with the ones your client is using, for example rpm -i miradoreclient-1.3.1-4.2.i686.rpm or dpkg -i miradoreclient_1.3.1_i386.deb.
Check client configuration.

Usually, a configuration file is used for setting the initial client configurations, but if the configuration file is missing or corrupt, the configuration can be performed using Miradore client configurator. Enter the following command to use the configurator:

/var/lib/miradore/miradoresetup.sh

Miradore configuration file (miradore.conf) can be found from /etc/miradore.conf. See more information about the configuration options from Configuring Miradore Client for Linux.

Steps for installing Miradore client from the repository

Installation steps depend on the used software management tool. Debian and Ubuntu distributions use 'apt-get' command line tool for software management whereas SUSE Linux Enterprise and openSUSE distributions use 'zypper', and RedHat Enterprise Linux, CentOS and Fedora use 'yum'.

In the following guides, replace '<installation_point_address>' with the hostname of the HTTP installation point, '<installation_point_directory>' with the installation point root directory at the HTTP installation point, and the '<repository_directory>' with distribution-specific directory name

All these operations require superuser (root) privileges. Depending on system setup, use command 'sudo -i' or 'su -' to gain root access before continuing with distribution-specific installation steps.

Repository directory names for different distributions

The naming of different distributions follows the format DistributionName_versionNbr .

There are some examples of repository directory names for different distributions in the next table (also exceptions are commented there):

Distribution	Repository directory name	Comment
CentOS version 7.x	CentOS_7
Debian version 6.0.x	Debian_6.0	This is exception to other Debian names.
Debian version 8.x	Debian_8
Debian version 9.x	Debian_9
Debian version 10.x	Debian_10
Debian version 11.x	Debian_11
Fedora version 18	Fedora_18
Fedora version 19	Fedora_19
openSUSE version 11.4	openSUSE_11.4
openSUSE version 12.3	openSUSE_12.3
RedHat Enterprise Linux version 6.x	RHEL_6
RedHat Enterprise Linux version 7.x	RHEL_7
SuSE Linux Enterprise Desktop and Server version 11	SLE_11
SuSE Linux Enterprise Desktop and Server version 12	SLE_12
Ubuntu 12.10	Ubuntu_12.10
Ubuntu 18.04	Ubuntu_18.04
Ubuntu 20.04	Ubuntu_20.04

Client installation steps for Ubuntu and Debian Linux

Use the following command to add Miradore client repository as software source:

echo "deb http://<installation_point_address>/<installation_point_directory>/_System/Miradore/Linux/Current/<repository_directory> ./" >/etc/apt/sources.list.d/miradoreclient.list

Installing repository signing into apt program handler as trusted keys is done by downloading the key with 'wget' and adding the key to the trusted key store of apt key management.

For Debian 11 and Ubuntu 20.04.1 LTS (or newer), use this command:

wget http://<installation_point_address>/<installation_point_directory>/_System/Miradore/Linux/Current/<repository_directory>/Release.key -O /etc/apt/trusted.gpg.d/miradoreclient.asc

For Debian 10 (or older) and Ubuntu 20.04 LTS (or older), use the following:

wget http://<installation_point_address>/<installation_point_directory>/_System/Miradore/Linux/Current/<repository_directory>/Release.key -O- | apt-key add -

The client can be installed with the commands:

apt-get update

apt-get -y install miradoreclient

Client installation steps for RedHat Enterprise Linux, CentOS, and Fedora

Software management tool 'yum' doesn't support adding repositories, so adding repository must be done manually.

In order to add repository manually, copy, modify, and paste the following lines as single command (up to and including the line 'EOF'):

IPHOST=<installation_point_address> IPDIR=<installation_point_directory> REPODIR=<repository_directory> && cat <<EOF >/etc/yum.repos.d/miradoreclient1.repo

[miradoreclient1]

name="Repository for Miradore client"

baseurl=http://${IPHOST}/${IPDIR}/_System/Miradore/Linux/Current/${REPODIR}

enabled=1

gpgcheck=1

gpgkey=http://${IPHOST}/${IPDIR}/_System/Miradore/Linux/Current/${REPODIR}/repodata/repomd.xml.key

EOF

Install Miradore client package and import the gpg signing key for the repository automatically by using the following command:

yum -y install miradoreclient

Client installation steps for SuSE Linux Enterprise and openSUSE

Use the following command to add Miradore client repository as software source:

zypper addrepo --type rpm-md --refresh --name "Repository for Miradore client" http://<installation_point_address>/<installation_point_directory>/_System/Miradore/Linux/Current/<repository_directory> miradoreclient1

It is recommended to add repository signing key for the repository. Use the following commands to add the signing key:

echo "gpgcheck=1" >>/etc/zypp/repos.d/miradoreclient1.repo

eval `grep baseurl /etc/zypp/repos.d/miradoreclient1.repo` && echo "gpgkey=${baseurl}/repodata/repomd.xml.key" >>/etc/zypp/repos.d/miradoreclient1.repo

The following command starts the installation of Miradore client from the repository:

zypper -n --gpg-auto-import-keys install miradoreclient

1. - Option --gpg-auto-import-keys imports the repository signing key automatically as trusted signing key. Without the option, choice for approving the key will be asked. Option -n acts non-interactively, answering default answers to questions. Omitting this option asks user to respond to questions about installing required packages.

Client configuration

Installation of package doesn't include configuration file. See Configuring Miradore client for Linux for more information about specifying required configuration file /etc/miradore.conf.