This guide applies to the following operating systems: Windows, Solaris, Linux

Component Overview

There are three main user interfaces for the Men & Mice Suite; Management Console, Command Line Interface and the Web Interface. Multiple copies of each may be installed, and multiple copies can be logged in at once to manage your servers.

Figure 1

Please click on any of the following links for more details on a specific component.

 

This guide contains instructions to install each of these components. It is not necessary to read this entire document; but it is recommended that the relevant sections are reviewed.

Once installation is complete, you can get more detailed information from the Men & Mice Suite User's Guide.

Minimum System Requirements

Networking requirements

The following services need to be able to listen for connections on the following ports. This needs to be configured in a firewall that can either reside on the servers themselves or externally.

Service NamePortProtocolSource
DNS Server controller1337TCPCentral
DHCP Server Controller4151TCPCentral
Men & Mice Central1231TCPManagement Console, MMCLI, Web Interface
Men & Mice Updater4603TCPCentral

 

Installation Overview

If you are upgrading, please see Upgrade Notes

Installation outline

The latest version of the Men & Mice Suite components can be downloaded from the Men & Mice website.

The first connection to a new installation of Men & Mice Central must originate from Men & Mice Management Console. A connection from Men & Mice Web Interface or Men & Mice CLI will be refused until after the First Use Wizard has been completed using the Management Console

Detailed installation instructions for each OS

Additional Installation Notes

General information

Nearly all components come with installers.
Men & Mice CLI is an exception on some operating systems - it has no installer, and can be manually installed wherever convenient in the file system after it is extracted from its distribution archive.
Please note that the CLI is marked as deprecated and Men & Mice recommends to use the SOAP interface instead.

A high level overview of the installation steps can be found in the following knowledge base article: https://otrs.menandmice.com/otrs/public.pl?Action=PublicFAQZoom;ItemID=72

The first time Men & Mice Management Console connects to Men & Mice Central, a setup wizard will take you through the steps of entering licenses and configuring connections to DNS and DHCP servers.

Single Sign-On and the Men & Mice Web Interface

If you wish to use single sign-on with the Men & Mice Web Interface, in addition to enabling the feature after installation using Men & Mice Management Console, you will also need to do the following:

Upgrading the Men & Mice Suite

Back Up Beforehand

Before starting the upgrade is advisable to back up the Men & Mice Central database beforehand. You can back up the database in one of two ways:

For version 5.5 and later, the database is a single file named mmsuite.db. See this page for finding the location of the database. For previous versions, the database is made up of a series of .dbf, .cdx, and .fpt files all in one directory (e.g. /var/qdns/qdnscentral).

Automatic Updates

Starting with version 6.2, the Men & Mice Suite is able to handle the updates of each component automatically. If running a version < 6.4, make sure that the Men & Mice Updater is installed and running on each machine that is running a DNS or DHCP Controller. Also make sure that the firewall is configured to allow the Updater to communicate with Men & Mice Central. See Networking Requirements.

To check if any updates are available, in the Management Console, navigate to Tools -> Check for updates. From there an update can be initiated.

System Requirements

Please review the Supported Systems before upgrading. There might have been some changes in what software is supported in the new version.

Upgrade Procedure

To upgrade the Men & Mice Suite manually, each installer for each component should be run. The installers will upgrade the corresponding component.

 

Are more detailed description about updating the Men & Mice Suite is available in the knowledge base article Updating the Men & Mice Suite

Upgrade Notes

New Storage Format

If you are upgrading from version 5.1 or older you should be aware that Men & Mice Central 6.4 uses a new data storage format. When upgrading Men & Mice Central from version 5.1 or earlier, your data will be converted to the new format if the installer can find it. Otherwise, a new database will be created; your old data is still in its previous location, but it is not practical to merge the old data with new data.

New Access Model

If upgrading from version 5.1 or earlier, and if the DHCP module was used in the older version, note that the new access model means that the data tables for DHCP access rights in the new version are not analogous to the access rights tables in the old version. After installing version 6.4 you should review and update the DHCP access rights.

New Method of Controlling MS DHCP Servers

In version 5.6.1 and earlier, Men & Mice Central used the Microsoft API for DHCP server management, controlling DHCP servers directly. This function has now been moved to Men & Mice DHCP Server Controller, and Men & Mice Central sends all requests through this new component. This means that it is no longer necessary to configure Central to run under a user account with DHCP management privileges. Instead, it is nearly always best to let Central run as a local system service.
The account previously used to run Central can now be used for the DHCP Server Controller if it will be used to control DHCP service on servers other than the server on which the DHCP Server Controller is installed. Note that the DHCP Server Controller can run as a local system service and still control a DHCP service running locally.