# Administration

- [Deployment](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment.md): Guidelines and instructions for deploying MariaDB Enterprise Manager, including network and firewall requirements for successful installation.
- [Hardware and System Requirements](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/hardware-and-system-requirements.md): Details the hardware sizing, system prerequisites and supported OS versions for deploying the Enterprise Manager server and agents.
- [Installing MariaDB Enterprise Manager](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/installing-mariadb-enterprise-manager.md): Step-by-step instructions for deploying the Enterprise Manager Server.
- [Metrics Retention Configuration](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/installing-mariadb-enterprise-manager/metrics-retention-configuration.md): Guide to modifying the default 30-day metrics data retention period by editing the PROMETHEUS\_RETENTION\_TIME environment variable and restarting services.
- [Adding Databases](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/adding-databases.md): Guide to registering database topologies in the UI and using the integrated helper tool to generate setup commands for installing monitoring agents.
- [Agent Installation](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/adding-databases/agent-installation-t-copy.md): Instructions for installing the mema-agent application using native OS package managers, including prerequisite steps for creating a local monitor user in MariaDB.
- [Add Multiple MaxScale Monitors](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/adding-databases/add-multiple-maxscale-monitors.md): Explains how to monitor multiple logical databases or clusters managed by a single MaxScale deployment by adding or changing specific MaxScale monitors in the UI.
- [SSO to MaxScale (Single Sign-On)](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/adding-databases/sso-to-maxscale-single-sign-on.md): Instructions for configuring Single Sign-On (SSO) integration to seamlessly access the MaxScale GUI directly from MariaDB Enterprise Manager.
- [Network and Firewall Requirements](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/network-and-firewall-requirements.md): Outlines the necessary network ports and firewall configurations (such as ports 8090 and 4318) required for UI access and agent telemetry data collection.
- [User Management](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/user-management.md): Explains the Role-Based Access Control (RBAC) system, including how to create custom roles, manage base permissions (admin, edit, view, sql), and add or modify users.
- [Configure OpenID Connect Identity Provider](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/user-management/configure-openid-connect-identity-provider.md): Instructions for integrating Enterprise Manager with an OpenID Connect (OIDC) identity provider for centralized Single Sign-On (SSO) authentication.
- [Backup & Restore of Enterprise Manager](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/backup-and-restore-of-enterprise-manager.md): Procedures for backing up the Enterprise Manager configurations and metrics data, as well as steps for restoring the system in case of failure.
- [Update Enterprise Manager](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/update-enterprise-manager.md): Instructions for updating an existing Enterprise Manager deployment.
- [Change Hostname or IP Address](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/change-hostname-or-ip-address.md): Steps for safely modifying the hostname or IP address of the Enterprise Manager server and ensuring all monitored agents remain connected.
- [Security in Enterprise Manager](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/security-in-enterprise-manager.md): Overview of security best practices within Enterprise Manager, including securing the UI, managing audit logs, and enforcing strict access controls.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
