Micetro components for Linux - Micetro - 25.2.0

Micetro Installation Guide
ft:locale
en-US
Product name
Micetro
Version
25.2.0
Important: All non-Windows Micetro components (Micetro Central, Micetro Agents, and the Web Application) require Python version 3.8 or greater to be installed on the target server.

Download the following installer packages:

  • Micetro Central: micetro-central.linux.x64.tgz
  • Micetro Agent: micetro-controllers.linux.x64.tgz
  • Micetro Web Application: micetro-web.linux.x64.tgz
  • Micetro AuthServe Agent: mm-authserve-agent.tar.gz
Note: Unless noted, all commands are run as root.

Micetro Central on Linux

Micetro Central is the central authentication server. It also serves as the metadata storage engine, containing data such as zone history logs, user accounts and permissions, etc. You must have at least one copy of Micetro Central installed in the environment. Micetro Central does not need to be installed on a DNS server.

Note: Before installing Micetro Central, decide the following:
  • What user account will own the Micetro Central process?
  • Where do you want everything stored? There are defaults provided.
Important: The installation process is designed to be fast and simple. If you want to customize your setup, such as changing the installation path for Micetro Central, make sure to follow the steps carefully.

To install Micetro Central:

Extract and run the Micetro Central installation package:

tar -xzvf micetro-central-25.2.0.linux.x64.tgz
cd micetro-central-25.2.0.linux.x64
./install

After installation has finished, check for running mmcentral:

systemctl status mmcentral

Installing Micetro Central puts the following files in your system:

Description File(s) or directory
Micetro Central daemon mmcentrald, usually in /usr/sbin or /usr/local/sbin
Data directory for Micetro Central Usually /var/mmsuite/mmcentral
Update directory update, located in the data directory
Preferences file preferences.cfg, located in the data directory
init script 1 /etc/init.d/mmcentral
Settings file used by the init script (Ubuntu Linux only) /etc/default/mmcentral

For information on preferences/configuration files, refer to Configuration files for Linux.

Removing Micetro Central

To remove Micetro Central:

  1. Use the init script to stop the service (give it the "stop" argument).
  2. Delete the daemon and the init script.
  3. Remove any references to the init script in the rest of the boot system, if necessary.
  4. (Optional). You can also delete the data directory.

Setting up cloud services on Linux

For IP address management (IPAM), Micetro connects with cloud services through the DHCP Agent. Before proceeding with any actions involving Micetro and cloud services, two critical prerequisites must be met:

  1. DNS/DHCP Agent installation and setup:

    The Micetro Agents must be installed. For instructions on installing Micetro Agents, refer to the following pages:

  2. Network connectivity
    • Make sure the machine hosting Micetro Central can connect to the designated cloud instance.
    • The connection with the cloud provider must be made by the Agent through port 443/TCP to allow secure HTTPS communication. The DNS Agent and DHCP Agent must be on the same machine and capable of connecting to Azure or AWS services through the following URLs:

      Azure:

      • https://management.azure.com
      • https://login.microsoftonline.com
      • https://management.core.windows.net

      AWS:

      • https://organizations.amazonaws.com
      • https://iam.amazonaws.com
      • https://route53.amazonaws.com
      • https://ec2.us-east-1.amazonaws.com
      • https://sts.us-east-1.amazonaws.com
    • For detailed networking requirements, refer to Networking requirements.
Note: The DHCP Agent is required for account discovery, i.e., so even if you only plan to integrate to the AWS cloud DNS service Route 53, you still need the DHCP Agent, not only the DNS Agent.

If you intend to add multiple AWS cloud accounts using a single set of credentials, refer to Configuring AWS multi-account setup.

After these prerequisites are met, you can integrate cloud services with Micetro. Refer to Integrating cloud services for instructions.

1 The shell script that can be used to control the service. Used by init during system startup.