This is a read-only copy of the MariaDB Knowledgebase generated on 2024-12-18. For the latest, interactive version please visit https://mariadb.com/kb/.

ColumnStore Administrative Console

The MariaDB ColumnStore Management Console allows you to configure, monitor, and manage the MariaDB ColumnStore system and servers. Once you have a running ColumnStore cluster, you can invoke the console from any of the UM or PM nodes. The console utility is called mcsadmin

[myuser@srv1~]# mcsadmin
MariaDB Columnstore Admin Console
   enter 'help' for list of commands
   enter 'exit' to exit the MariaDB Columnstore Command Console
   use up/down arrows to recall commands
Active Alarm Counts: Critical = 0, Major = 0, Minor = 0, Warning = 0, Info = 0
Critical Active Alarms:

mcsadmin> quit

You can use one of the following commands in the console

Command                           Description
------------------------------    --------------------------------------------------------
?                                 Get help on the Console Commands
addDbroot                         Add DBRoot Disk storage to the MariaDB Columnstore System
addModule                         Add a Module within the MariaDB Columnstore System
alterSystem-disableModule         Disable a Module and Alter the MariaDB Columnstore System
alterSystem-enableModule          Enable a Module and Alter the MariaDB Columnstore System
assignDbrootPmConfig              Assign unassigned DBroots to Performance Module
assignElasticIPAddress            Assign Amazon Elastic IP Address to a module
disableLog                        Disable the levels of process and debug logging
disableMySQLReplication           Disable MySQL Replication functionality on the system
enableLog                         Enable the levels of process and debug logging
enableMySQLReplication            Enable MySQL Replication functionality on the system
exit                              Exit from the Console tool
findObjectFile                    Get the name of the directory containing the first file of the object
getActiveAlarms                   Get Active Alarm list
getActiveSQLStatements            Get List Active SQL Statements within the System
getAlarmConfig                    Get Alarm Configuration Information
getAlarmHistory                   Get system alarms
getAlarmSummary                   Get Summary counts of Active Alarm
getLogConfig                      Get the System log file configuration
getModuleConfig                   Get Module Name Configuration Information
getModuleCpu                      Get a Module CPU usage
getModuleCpuUsers                 Get a Module Top Processes utilizing CPU
getModuleDisk                     Get a Module Disk usage
getModuleHostNames                Get a list of Module host names (NIC 1 only)
getModuleMemory                   Get a Module Memory usage
getModuleMemoryUsers              Get a Module Top Processes utilizing Memory
getModuleResourceUsage            Get a Module Resource usage
getModuleTypeConfig               Get Module Type Configuration Information
getProcessConfig                  Get Process Configuration Information
getProcessStatus                  Get MariaDB Columnstore Process Statuses
getSoftwareInfo                   Get the MariaDB Columnstore Package information
getStorageConfig                  Get System Storage Configuration Information
getStorageStatus                  Get System Storage Status
getSystemCpu                      Get System CPU usage on all modules
getSystemCpuUsers                 Get System Top Processes utilizing CPU
getSystemDirectories              Get System Installation and Temporary Logging Directories
getSystemDisk                     Get System Disk usage on all modules
getSystemInfo                     Get the Over-all System Statuses
getSystemMemory                   Get System Memory usage on all modules
getSystemMemoryUsers              Get System Top Processes utilizing Memory
getSystemNetworkConfig            Get System Network Configuration Information
getSystemResourceUsage            Get System Resource usage on all modules
getSystemStatus                   Get System and Modules Status
help                              Get help on the Console Commands
monitorAlarms                     Monitor alarms in realtime mode
movePmDbrootConfig                Move DBroots from one Performance Module to another
quit                              Exit from the Console tool
redistributeData                  Redistribute table data accross all dbroots to balance disk usage
removeDbroot                      Remove DBRoot Disk storage from the MariaDB Columnstore System
removeModule                      Remove a Module within the MariaDB Columnstore System
resetAlarm                        Resets an Active Alarm
restartSystem                     Restarts a stopped or shutdown MariaDB Columnstore System
resumeDatabaseWrites              Resume performing writes to the MariaDB Columnstore Database
setAlarmConfig                    Set a Alarm Configuration parameter
setModuleTypeConfig               Set a Module Type Configuration parameter
setProcessConfig                  Set a Process Configuration parameter
shutdownSystem                    Shuts down the MariaDB Columnstore System
startSystem                       Starts a stopped or shutdown MariaDB Columnstore System
stopSystem                        Stops the processing of the MariaDB Columnstore System
suspendDatabaseWrites             Suspend performing writes to the MariaDB Columnstore Database
switchParentOAMModule             Switches the Active Parent OAM Module to another Performance Module
system                            Execute a system shell command
unassignDbrootPmConfig            Unassign DBroots from a Performance Module
unassignElasticIPAddress          Unassign Amazon Elastic IP Address

Help command

The help command displays supported commands. You can view brief help definitions or verbose definitions. You can also enter partial command names with the help command to view verbose definitions.

For example, type help enableLog to get the verbose definition of the enableLog command as shown below.

mcsadmin> 
mcsadmin> help enableLog
help   Fri Jun 10 19:26:26 2016

   Command:     enableLog

   Description: Enable the levels of process and debug logging

   Arguments:   Required: 'system' or Module-name where logging is being enabled
                Required: 'all' or the specific level to enable
                    Levels: critical, error, warning, info, and debug

mcsadmin> 

Case sensitivity

Commands are not case sensitive; however parameters and device names, like server and processes, are case sensitive.

Recall command history

Use the up and down arrow keys on your keyboard to scroll through the command history.

Command repeat option

Commands can be run continuously using the “-r” option. The repeat option repeats a command every 5 seconds. You can change the repeat interval to be between 1 and 60 seconds by adding the number of seconds after the command.

This is useful to check status in real-time mode. For example to repeat the GetProcessStatus command every 2 seconds:

mcsadmin> getProcessStatus -r2
repeating the command 'GetProcessStatus' every 2 seconds, enter CTRL-D to stop

getprocessstatus   Fri Jun 10 19:31:28 2016

MariaDB Columnstore Process statuses

Process             Module    Status            Last Status Change        Process ID
------------------  ------    ---------------   ------------------------  ----------
ProcessMonitor      pm1       ACTIVE            Fri Jun 10 01:50:04 2016        2487
ProcessManager      pm1       ACTIVE            Fri Jun 10 01:50:10 2016        2673
SNMPTrapDaemon      pm1       ACTIVE            Fri Jun 10 01:50:16 2016        3534
DBRMControllerNode  pm1       ACTIVE            Fri Jun 10 01:50:20 2016        3585
ServerMonitor       pm1       ACTIVE            Fri Jun 10 01:50:22 2016        3625
DBRMWorkerNode      pm1       ACTIVE            Fri Jun 10 01:50:22 2016        3665
DecomSvr            pm1       ACTIVE            Fri Jun 10 01:50:26 2016        3742
PrimProc            pm1       ACTIVE            Fri Jun 10 01:50:28 2016        3770
ExeMgr              pm1       ACTIVE            Fri Jun 10 01:50:32 2016        3844
WriteEngineServer   pm1       ACTIVE            Fri Jun 10 01:50:36 2016        3934
DDLProc             pm1       ACTIVE            Fri Jun 10 01:50:40 2016        3991
DMLProc             pm1       ACTIVE            Fri Jun 10 01:50:45 2016        4058
mysqld              pm1       ACTIVE            Fri Jun 10 01:50:22 2016        2975

Unix Command Line entry

mcsadmin commands can be run from the linux command line prompt

# mcsadmin getSystemInfo

Command Name Short-cutting

mcsadmin commands can be short-cutted. This example would execute getSystemInfo. The is the first command it would find alphabetically with 'getsystemi'

# mcsadmin getsystemi
Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.