Глава 10. Средства конфигурирования
В этой главе описываются утилиты, поставленные с MySQL Enterprise Service
Manager и MySQL Enterprise Monitor Agent.
10.1. Средства конфигурирования Service Manager
Параметры, перечисленные здесь, за исключением четырех параметров связи
с хранилищем, соответствуют показанным на странице
Welcome to MySQL Enterprise Monitor,
используемой для начальной настройки. Для получения дополнительной информации
посмотрите
раздел 13.1.
Эти параметры позволяют вам формировать MySQL Enterprise Service Manager
из скрипта или командной строки и должны использоваться только в то время,
как MySQL Enterprise Service Manager остановлен.
Скрипт config.sh /
config.bat используется, чтобы сформировать
хранилище MySQL Server Repository для Service Monitor.
Его местоположение по умолчанию:
Таблица 10.1. Местоположение по умолчанию
средства конфигурирования агента
OS |
Где искать |
Microsoft Windows |
C:\Program
Files\MySQL\Enterprise\Monitor\bin\config.bat
|
UNIX/Linux |
/opt/mysql/enterprise/monitor/bin/config.sh
|
Mac OS X |
/Applications/mysql/enterprise/monitor/bin/config.sh
|
Параметр --help покажет опции.
Средство конфигурирования Service Manager
содержит следующие наборы команд:
Service Manager Configuration Utilities
Скрипт config позволяет
определить или изменить любой из параметров конфигурации системы, таких как
параметры соединения с хранилищем, детали настройки прокси и авторизацию
пользователя MySQL Enterprise Service Manager.
Таблица 10.2. Средства конфигурирования Service Manager
Имя |
Описание |
--mysql-user=<value>
--mu=<value>
|
Имя пользователя MySQL для хранилища Service Manager.
Пароль требуют через STDIN, когда выполняется команда. Значение по умолчанию
service_manager . |
--mysql-port=<value>
--mp=<value>
|
Порт MySQL для хранилища Service Manager. Порт, который слушает
целевой сервер MySQL, по умолчанию 13306. |
--mysql-db=<value>
--md=<value>
|
База данных MySQL для хранилища Service Manager.
Название базы данных, которая используется для хранилища.
По умолчанию mem . |
--mysql-server=<value>
--ms=<value>
|
Сервер MySQL для хранилища Service Manager.
Это должно быть разрешимым именем или IP-адресом сервера. |
--mysql-check-requirements |
Проверяет ваше хранилище, чтобы гарантировать совместимость с
MySQL Enterprise Service Manager. Для получения дополнительной информации о
выполненных проверках посмотрите
раздел 3.2.4.
|
--mysql-upgrade
|
Выполняет mysql_upgrade
на хранилище, определенном в --mysql-basedir .
|
--mysql-basedir
|
Основной каталог установки MySQL. |
--sm-admin-user=<value> |
Имя пользователя администратора Service Manager.
Пользователь, определенный здесь, добавляется к роли менеджера. |
--sm-agent-user=<value> |
Имя пользователя агента Service Manager.
Пользователь, определенный здесь, добавляется к роли агента. |
--auto-update
|
Позволить автоматическую проверку обновления онлайн. |
--purge-quan=<value> |
Определяет политику хранения данных Query Analyzer.
Данные Query Analyzer, более старые, чем число дней, определенное здесь,
удалены. Умолчание составляет 28 дней. |
--purge-data=<value> |
Определяет историческую политику хранения данных. Исторические данные,
более старые, чем число дней, определенное здесь, удалены.
Умолчание составляет 28 дней. |
--proxy-host=<value> |
Хост HTTP Proxy. |
--proxy-port=<value> |
Порт HTTP Proxy. |
--proxy-user=<value |
Пользователь HTTP Proxy. |
Пароли всегда требуют через STDIN в порядке менеджер, агент и прокси,
независимо от порядка, в котором они определяются в командной
строке или скрипте.
Следующий пример приказывает MySQL Enterprise Service Manager
использовать локальный сервер на порту 3306, базу данных
mem и пользователя
service_manager :
config.sh --mysql-server=localhost --mysql-port=3306 --mysql-db=mem \
--mysql-user=service_manager
Ниже приведен пример основной установки, определяя только
пользователей администратора и агента:
config.sh --sm-admin-user=admin --sm-agent-user=agent
Все другие параметры устанавливаются в их значения по умолчанию.
Будет запрос, чтобы определить пароли для каждого из определенных
пользователей. Пароли приняты только через STDIN.
Пароли всегда требуют в менеджере в порядке менеджер, агент и прокси,
независимо от порядка, в котором они определяются в командной
строке или скрипте.
Все другие значения установлены по умолчанию.
Ниже приведен пример полной установки, определяя
все доступные параметры:
config.sh --sm-admin-user=admin --sm-agent-user=agent --purge-quan=7 \
--purge-data=14 --proxy-host=localhost --proxy-port=9190 \
--proxy-user=proxy --auto-update
Service Manager Certificate Utilities
Утилиты сертификата позволяют вам изменить, возобновить, импортировать и
модернизировать свои сертификаты SSL.
Сильно рекомендуется, чтобы вы использовали эту утилиту, чтобы изменить
ваши сертификаты SSL и не пытаться изменить их любым другим инструментом.
Таблица 10.3. Сертификатные утилиты Service Manager
Имя |
Описание |
--tomcat-backup-path=<value>
--tbp=<value>
|
Резервный путь Tomcat, который будет использоваться,
чтобы выполнить модернизацию. |
--upgrade
--upg
|
Обновляет сертификаты на платформах не OS X. То есть, в
Microsoft Windows, Linux и прочих. |
--upgrade-osx
--upgo
|
Обновляет сертификаты в OS X. |
--new-install
--ni
|
Производит хранилище ключей с новым самоподписанным сертификатом
для новой установки. |
--accept-keystore-password
--akp
|
Если определено, пользователь должен ввести пароль хранилища
сертификатов. Если не определено, испольуется пароль по умолчанию
changeit . |
--renew
|
Возобновите существующий, самоподписанный сертификат.
Если он не самоподписан, ошибка возвращена. |
--import-certificate=<value> |
Импортирует указанный сертификат, например:
--import-certificate=/path/to/client.crt
|
--import-key=<value> |
Импортирует указанный закрытый ключ. Например:
--import-certificate=/path/to/client.key
|
10.2. Средство конфигурирования агента
Скрипт agent.sh /
agent.bat используется, чтобы формировать агента.
В следующей таблице перечислены местоположения по умолчанию для каждой
поддержанной операционной системы:
Эти параметры позволяют вам формировать агента MySQL Enterprise Monitor
из скрипта или командной строки и должны выполняться только
в то время как агент MySQL Enterprise Monitor остановлен.
Таблица 10.4. Местоположение средства конфигурирования
агента по умолчанию
OS |
Где искать |
Microsoft Windows |
C:\Program
Files\MySQL\Enterprise\Agent\bin\agent.bat
|
UNIX/Linux |
/opt/mysql/enterprise/agent/bin/agent.sh
|
Mac OS X |
/Applications/mysql/enterprise/agent/bin/agent.sh
|
Параметр --help
показывает возможные опции.
Средство конфигурирования Service Manager
содержит следующие наборы команд:
Невозможно выполнить agent.sh
из командной строки как root , только как
mysql .
Agent Connection Utilities
Следующие параметры позволяют вам создать, проверить, и отредактировать
связи агента MySQL Enterprise Monitor.
Таблица 10.5. Утилиты связи агента
Имя |
Описание |
--test-credentials
-T
|
Проверьте параметры подключения MySQL. |
--test-privileges
|
Проверьте привилегии пользователя администратора, чтобы
управлять другими пользователями. |
--create-connection
-c
|
Создайте или измените подключение MySQL. |
--delete-connection
-d
|
Завершить и удалить подключение MySQL, требует
--connection-id . |
--show
-s
|
Покажите информацию обо всех подключениях MySQL
на этом агенте. |
--auto-manage-extra-users
-m
|
Автоматически создать общего/ограниченного пользователя
(действия: Create, Modify). |
--host=<value>
-h <value>
|
Хост сервера MySQL (действия: Create, Modify). |
--port=<value>
-P <value>
|
Порт сервера MySQL (действия: Create, Modify). |
--socket=<value>
-S <value>
|
Сокет сервера MySQL (действия: Create, Modify). |
--limited-user=<value>
-l <value>
|
Пользователь ограниченного уровня (действия: Create, Modify).
|
--general-user=<value>
-k <value>
|
Параметры обычного пользователя. |
--admin-user=<value>
-j <value>
|
Параметры для администратора. |
--connection-id=<value>
-i <value>
|
Connection ID. |
--connection-group=<value>
-g <value>
|
Определите имя группы, чтобы добавить эту связь.
Если названная группа не существует, она создается и связь будет добавлена
к ней. Этот параметр может использоваться многократно в команде
--create-connection .
Связь добавляется к каждой названной группе. |
--force-plain-stdin ,
-f
|
Использование STDIN для вводов пароля (ввод пароля не замаскирован,
этот выбор полезен только для очень определенного использования этих утилит,
например, из скрипта). |
--disable-topology-discovery |
Отключите открытие топологии репликации. Используйте этот параметр,
если вы не используете репликацию или хотите обнаружить топологию позже.
Открытие топологии может быть отнимающим много времени. |
--mysql-identity-source=<value> |
Источник идентичности для сервера MySQL для этой связи,
default или
host_plus_datadir .
default использует переменную
server_uuid , если есть, или
производит новый uuid. host_and_datadir
использует хэш имени хоста и пути к каталогу данных MySQL, чтобы
создать уникальную идентичность. |
--require-encryption
|
Потребовать использования TLS для подключения MySQL. |
--allow-self-signed-certs |
Используя --require-encryption , разрешить
самоподписанные сертификаты TLS. |
--ca-file-path=<value> |
Используя --require-encryption ,
но применяя частный центр сертификации, путь к файлу CA.
|
Следующий пример проверяет параметры входа пользователя root на
localhost:3306 :
agent.bat --test-credentials --admin-user=root --host=localhost --port=3306
Следующий пример создает связь, используя только пользователя
администратора для localhost:3306:
agent.bat -c --admin-user=root --host=localhost --port=3306
Следующий пример создает связь, используя только пользователя
администратора, к localhost:3306 и запрашивает пароль с STDIN:
agent.bat -c --admin-user=root --host=localhost --port=3306 -f
Следующий пример создает связь, используя только пользователя
администратора, с localhost:3306 и добавляет к группам
Standard, Special и Third:
agent.bat -c --admin-user=root --host=localhost --port=3306 \
--connection-group=Standard --connection-group="Special Group" \
--connection-group="Third Group"
Agent Configuration Utilities
Следующие параметры позволяют вам формировать или отредактировать связь
MySQL Enterprise Monitor Agent с MySQL Enterprise Service Manager.
Таблица 10.6. Cредство конфигурирования агента
MySQL Enterprise Monitor
Имя |
Описание |
--agent-user=<value>
-u <value>
|
Установите параметры входа агента для связи с Service Manager
|
--url=<value>
-U <value>
|
Установите URL для Service Manager |
--uuid=<value>
-I <value>
|
Установите Agent UUID |
--agent-group=<value>
-G <value>
|
Установите MEM Group, которую использовать для всех подключений
MySQL от этого агента |
--force-plain-stdin
-f
|
Использование ввода пароля с STDIN (ввод пароля не замаскирован, этот
выбор полезен только для очень определенного использования этих утилит,
например, из скриптов) |
--run-collection-tests
-t
|
Узнать и попытаться собрать связанные с OS активы. Вывести их
(для отладки) в STDOUT |
Следующий пример устанавливает имя пользователя и URL, используемый
агентом, чтобы соединяться с MySQL Enterprise Service Manager:
agent.sh --agent-user=agent --url=https://localhost:8443
|
|