The ACM Control Command (acmctl)
You can use acmctl to diagnose and configure ACM.
Overview of the ACM Control Command (acmctl)
The acmctl command controls the ACM. Running it with the
–h (Help) option displays the available command
options:
# /opt/aspera/acm/bin/acmctl -h
Aspera Cluster Manager Control Command
Version: 0.5
Usage: acmctl {option}
List of options:
-i: Display the current state of ACM
-s: Perform a sanity check of ACM
-D: Disable ACM globally
-E: Enable ACM globally
-d: Disable ACM locally
-e: Enable ACM locally
-b: Back up the MySQL database (active node only)
-A: Display information about the version
Check that ACM works correctly
You can use the ‐i option to display the current status of ACM on a node
output shown from the active
node:
Aspera Cluster Manager status
-----------------------------
Local hostname: con2
Active node: con2 (me)
Status of this node: active
Status file: current
Disabled globally: no
Disabled on this node: no
Database configuration file
---------------------------
Database host: 10.0.115.102
Console active/passive services status
------------------------------------
Apache: running
MySQL: running
Console: running
AsperaBackground::SshTunnelManager running
AsperaBackground::Controller running
AsperaBackground::MongrelManager running
AsperaBackground::DatabaseIngest running
AsperaBackground::SessionDataCollector running
AsperaBackground::NodeInfoCollector running
AsperaBackground::FileDataCollector running
AsperaBackground::DataCanonicalizer running
AsperaBackground::CustomField running
AsperaBackground::DatabaseUtility running
AsperaBackground::TransferInitiator running
AsperaBackground::Email running
AsperaBackground::Report running
The following is an example of the acmctl –i output on the passive node:
Aspera Cluster Manager status
-----------------------------
Local hostname: con1
Active node: con2
Status of this node: passive
Status file: current
Disabled globally: no
Disabled on this node: no
Database configuration file
---------------------------
Database host: 10.0.115.102
Console active/passive services status
------------------------------------
Apache: stopped
MySQL: stopped
Console: stopped
Data Provided by acmctl -i
On both the active and passive systems, the output of the
acmctl -i command provides useful information about the
status of the Shares servers:
| Output Element | Definition |
|---|---|
| Hostname | The name of the local system. |
| Active node | The name and IP address of the node that is currently the active node. |
| Status [of] file | Whether the /opt/aspera/acm/run/acm4console.status file is current or has expired. A status of expired usually indicates a fail-over situation. The status file may not be available for a short period during fail-over, and the Status file may report as Unable to find. |
| Disabled globally | Answers the question: Is ACM disabled for all Shares servers? |
| Disabled on this node | Answers the question: Is ACM disabled on this node? |
| Database host | The system that is currently managing the MySQL database files. |
| Console active/passive service status | The active Console should show Apache, MySQL, and Console services running, as well as all Console background processes. If run on the passive system, all services should be shown as “stopped”. |