collect logs [cluster_name]
This command collects log files and other related files from all
hosts. When the name of a cluster
(cluster_name
) is supplied with the
command, it collects all the log files
(.log
) as well as the configuration files
(.ini
, .cnf
), error
files (.err
), and trace files
(.trace.log.*) used by all processes belonging to the cluster,
and also all the agent log files.
When an mcmd agent receives the
collect logs
command from the
mcm agent it is connected with, it sets up a
TCP server socket using port 0 by default, and lets the
operating system assign the actual port number. All agents in
the site are then instructed to perform the copying, and each of
them spawns a TCP client, which connects to the TCP server
socket set up earlier to copy the files over.
For MySQL Cluster Manager 1.4.2 and later: To assign a
specific port manually for file copying, use the
--copy-port
option when starting
mcmd. Default value for the option is 0. The
collect logs
command times out
if, in 30 seconds, no connections can be established by any of
the clients or no incoming connections are detected by the TCP
server.
If a firewall or other networking issues prohibit the TCP
clients to connect to the TCP server socket, the
collect logs
command will
never complete.
The collected files are put under the MySQL Cluster Manager data repository
(../mcm_data
(relative to the installation
directory of MySQL Cluster Manager) by default, or specified by the option
--manager-directory
) inside a
folder named collected_files
, under which
the files are organized under a hierarchy of timestamps [for the
file collections] and then host names; below the host name
level, the file organization mimics that on the host. For
example, the agent log for the host tonfisk
,
collected on 2014-07-31 at 07:44:05
, is found
at:
/opt/mcm_data/collected-files/2014-07-31T07:44:05Z/tonfisk/opt/mysql/logs/mcmd-tonfisk-19001.log
If cluster_name
is omitted, only the
agent log files are collected.