2.1System requirements (mdm 1.16.0)
No version of the "mdm installer for Windows" is provided for mdm 1.16.0, so that mdm 1.16.0 can no longer be installed on a Windows system.
An update to mdm 1.16.0 is likewise not supported on a Windows system.
To be able to continue to run mdm 1.16.x on a Windows system, you can use the virtual machine „mdm VA“ (VA = Virtual Appliance), provided by Phoenix Contact, running a preinstalled Ubuntu operating system (see Section 2.1.3).
mdm 1.16.0 can only be installed under the operating system Ubuntu 22.04 LTS (Server).
For this purpose, mdm 1.16.0 can be installed either
–in the virtual machine "mdm-VA" provided by Phoenix Contact (see Section 2.1.3) or
–installed under the native operating system Ubuntu Server (see Section 2.1.4).
The virtual machine „mdm VA“ is provided as an OVA file and run using a virtualization software program. The mdm VA is preconfigured by means of a configuration file provided by Phoenix Contact and is an easy way of installing mdm 1.16.x.
Basically, the following steps must be performed to install mdm 1.16.x in a virtual environment and use it as usual:
1.Download VirtualBox and install it in Windows
2.Download the mdm VA and import it into VirtualBox
3.Download the configuration file and add it to the mdm VA
4.Start the mdm VA and install mdm 1.16.x in the mdm VA
5.Migrate the mdm databases from mdm (1.13.x to 1.15.x) to mdm 1.16.x
The installation and operation of mdm 1.16.0 in the virtual machine is described in detail in the user manual „Using mdm 1.16.x in the mdm VA“ (AH EN MDM VA - 110903_en_02). (Download at: phoenixcontact.net/product/2981974.)
System requirements of the mdm VA:
–Memory (RAM): min. 4096 MB
–Hard disk space: min. 10 GB
System requirements mdm client:
–Operating system: Ubuntu / Windows
–Java platform (JRE): OpenJDK 11 or later
–Memory (RAM): 512 MB at least
–Hard disk space: 500 MB at least
In addition to installing mdm 1.16.0 under the Ubuntu operating system in the mdm-VA (see Section 2.1.3), it is also possible to install mdm 1.16.0 under the native operating system Ubuntu 22.04 (Server).
Please proceed with the following steps:
1.Download and install Ubuntu 22.04 (Server).
2.Create user vadmin.
3.Make the sudo program available.
4.Make the mdm repository available.
5.Install mdm-cockpit.
6.Install mdm 1.16.x
7.Migrate mdm databases from mdm (mdm 1.13.x to 1.15.x) to mdm 1.16.x.
Proceed as follows (requires root permissions):
•Install Ubuntu 22.04 (Server).
•If possible, create the user vadmin with the user ID 1000 during the installation.
•Log in to the Ubuntu operating system.
•Update the system:
–apt update && apt upgrade
Making user "vadmin" available if necessary (requires root permissions)
•Check whether the vadmin user already exists on the system:
–Log in as user vadmin.
–Check the user ID of the vadmin user:
id-a
The command should return the following response: uid=1000(vadmin)
•Depending on whether the user exists, you must perform one of the following actions.
1.If the vadmin user exists, proceed with “Making the program "sudo" available”.
2.If the vadmin user exists but does not have the user ID 1000, assign the user ID 1000 to it as follows:
–usermod --uid 1000 vadmin
–Proceed with “Making the program "sudo" available” .
3.If another user (example-user) with the user ID 1000 is present on the system, carry out one of the following measures:
a)Remove the user.
–Proceed with point 4 (see below).
b)Change the user ID of the user to something other than 1000:
–usermod --uid 2000 example-user
–Proceed with point 4 (see below).
c)Rename the user to vadmin:
–id example-user
uid=1000(example-user)
–usermod -d /home/vadmin -m -c vadmin -l vadmin example-user
–id vadmin
uid=1000(vadmin)
–Proceed with “Making the program "sudo" available” .
4.If the user vadmin does not exist on the system, create it:
–useradd --home-dir /home/vadmin --create-home --uid 1000
--user-group vadmin
–Proceed with “Making the program "sudo" available” .
Making the program "sudo" available
•Check whether the sudo program is installed:
–dpkg -l sudo
•If sudo is not installed, proceed as follows (root permissions):
–apt install sudo
–visudo
Add the following entry at the end of the sudoers file:
# User rules for vadmin
vadmin ALL=(ALL) NOPASSWD:ALL
Save the file.
–Test whether the vadmin user can use the sudo command:
sudo cat /etc/sudoers (log in and execute as user vadmin)
Making the mdm repository available
•Log in as the vadmin user.
•Create the directory in which the repository keys are stored.
–sudo mkdir -p /etc/apt/keyrings
•Make the mdm repository key available on the system:
–curl -s -S -O https://repositories.mguard.com/pubkey.gpg
•Check the fingerprint of the public key
–gpg -finger pubkey.gpg
–The fingerprint must have the following value:
AD3E B1F9 473D 5CC7 2ED4 2D4C 0571 79A3 CC0F FA55
•Save the public key (public key):
–sudo gpg --dearmor --yes -o /etc/apt/keyrings/mdm.gpg pubkey.gpg
•Make the mdm repository with the keys available:
–echo "deb [signed-by=/etc/apt/keyrings/mdm.gpg] http://repositories.mguard.com/mdm <version>/" | sudo tee /etc/apt/sources.list.d/pxccs.list
Installing base component and WBM for the mdm-VA "mdm-cockpit"
•Update the software repositories (Ubuntu and mdm):
–sudo apt update
•Remove all files in the /etc/netplan directory or change their file extension from
.yaml to another file extension.
•Install the base component mdm-cockpit:
–sudo apt install mdm-cockpit
•Reboot the system:
–sudo reboot
Installing mdm 1.16.x in the mdm-VA
•Install the desired mdm components as described in the mdm-VA user manual (see 110903_en_xx at phoenixcontact.net/product/2981974):
–For example with the command: pxccs-install-mdm
Migrating mdm databases from mdm (mdm 1.13.x to 1.15.x) to mdm 1.16.x
•Proceed as described in the user manual 110903_en_xx at phoenixcontact.net/product/2981974.