Coordinator is a cluster-wide management tool.
Only exits in Cluster Edition Package.
Options and Features
The options for machcoordinatoradmin are as follows. The functions described in the previous section are omitted.
mach@localhost:~$ machcoordinatoradmin -h
| Options | Description |
|---|---|
| -u, –startup | Runs the Coordinator process |
| -s, –shutdown | Terminates Coordinator process |
| -k, –kill | Stops Coordinator process |
| -c, –createdb | Creates Coordinator meta |
| -d, –destroydb | Removes Coordinator meta, Deletes the package files in $MACHBASE_COORDINATOR_HOME/package |
| -e, –check | Checks that the Coordinator process is running |
| -i, –silence | Runs without output |
| –configuration[=name] | Outputs keys and values in configuration settings (only certain keys can be output) |
| –activate | Switches Cluster status to Service |
| –deactivate | Switches Cluster status to Deactivate |
| –list-package[=package] | Lists information of registered packages (only specific packages can be output) |
| –add-package=package | Adds package |
| –remove-package=package | Deletes package |
| –list-node[=node] | Lists information of nodes (only specific nodes can be output) |
| –add-node=node | Adds node |
| –remove-node=node | Deletes node |
| –upgrade-node=node | Upgrades node |
| –startup-node=node | Runs node |
| –shutdown-node=node | Terminates node |
| –kill-node=node | Stops node |
| –cluster-status | Outputs each node status of the cluster |
| –cluster-status-full | Outputs of each node status of cluster in detail |
| –cluster-node | Outputs information of cluster |
–set-group-state=[normal | readonly] |
Changes the status of a specific warehouse group |
| –get-host-resource | Outputs host resource information where each node is located |
| –host-resource-enable | Starts collecting Host resource information of each node |
| –host-resource-disable | Stops collecting Host resource information for each node |
| Additional Options | Description | Required Options |
|---|---|---|
| –file-name=filename | File name | –add-package |
| –port-no=portno | Port number | –add-node |
| –deployer=node | Deployer node name | –add-node |
| –package-name=packagename | Package name to be the installation source | –add-package |
| –home-path=path | Based on Deployer server, installation path of current Node | –add-node |
–node-type=[broker | warehouse] |
Node type to install (choose between broker/warehouse) | –add-node |
| –group=groupname | Group name of the node to install | –add-node |
| –replication=host:port | host: port to exchange replication | –add-node |
| –no-replicate | Does not use Replication on the node to install | –add-node |
| –primary=host:port | Specifies the node name of the Primary Coordinator when installing the Secondary Coordinator | -u, –startup |
| –host=host | Specifies specific host to output Host resource information | –get-host-resource |
–metric=[cpu|memory|disk|network] |
Specifies specific metric to output Host resource information | –get-host-resource |
Check Running Status
Example:
mach@localhost:~$ machcoordinatoradmin -e
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Machbase Coordinator is running with pid(29245)!
Create / Delete Meta
Example:
mach@localhost:~$ machcoordinatoradmin -c
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Coordinator metadata created successfully.
mach@localhost:~$ machcoordinatoradmin -d
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Coordinator metadata destroyed successfully.
Output Configuration
Syntax:
machcoordinatoradmin --configuration[=name]
Example:
mach@localhost:~$ machcoordinatoradmin --configuration
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : CLUSTER
Value : 3
Name : DECISION
Value : ON
Name : HOST-RESOURCE
Value : OFF
mach@localhost:~$ machcoordinatoradmin --configuration=decision
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : DECISION
Value : ON
Format : text/plain
Change Cluster Status
Example:
mach@localhost:~$ machcoordinatoradmin --activate
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : CLUSTER
Value : 3
Format : text/plain
mach@localhost:~$ machcoordinatoradmin --deactivate
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : CLUSTER
Value : 0
Format : text/plain
List Package Information
Syntax:
machcoordinatoradmin --list-package[=package]
Example:
mach@localhost:~$ machcoordinatoradmin --list-package
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Package Name : machbase
File Name : machbase-cluster-6bab497c9.develop-LINUX-X86-64-release-lightweight.tgz
File Size : 64630670 bytes
Package Name : machbase2
File Name : machbase-cluster-e3c0717.develop-LINUX-X86-64-release-lightweight.tgz
File Size : 64677030 bytes
mach@localhost:~$ machcoordinatoradmin --list-package=machbase
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Package Name : machbase
File Name : machbase-cluster-6bab497c9.develop-LINUX-X86-64-release-lightweight.tgz
File Size : 64630670 bytes
List Node Information
Syntax:
machcoordinatoradmin --list-node[=node]
Example:
mach@localhost:~$ machcoordinatoradmin --list-node
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Node Name : 192.168.0.32:5101
Node Type : coordinator
HTTP Admin Port : 5102
Group Name : Coordinator
Desired State : primary
Actual State : primary
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497590
Last Modify Time : 421020408
Last Response Elapsed : 1006148
Node Name : 192.168.0.32:5201
Node Type : deployer
Group Name : Deployer
Desired State : normal
Actual State : normal
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497594
Last Modify Time : 404915419
Last Response Elapsed : 1006128
Node Name : 192.168.0.32:5301
Node Type : broker
Port Number : 5757
Deployer : 192.168.0.32:5201
Package Name : machbase
Home Path : /home/machbase/broker1
Group Name : Broker
Desired State : leader
Actual State : leader
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497544
Last Modify Time : 353606480
Last Response Elapsed : 1006157
Node Name : 192.168.0.32:5401
Node Type : warehouse
Port Number : 5400
Deployer : 192.168.0.32:5201
Package Name : machbase
Home Path : /home/machbase/warehouse_a1
Group Name : Group1
Desired State : normal
Actual State : normal
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497556
Last Modify Time : 332480933
Last Response Elapsed : 1006160
mach@localhost:~$ machcoordinatoradmin --list-node=192.168.0.32:5401
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Node Name : 192.168.0.32:5401
Node Type : warehouse
Port Number : 5400
Deployer : 192.168.0.32:5201
Package Name : machbase
Home Path : /home/cumulus/warehouse_a1
Group Name : Group1
Desired State : normal
Actual State : normal
Coordinator Host : 192.168.0.32:5101
Last Response Time : 648879
Last Modify Time : 419153148
Last Response Elapsed : 1005962
Output Cluster Node Status
Example:
mach@localhost:~$ machcoordinatoradmin --cluster-status
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
+-------------+-------------------+-------------------+-------------------+--------------+
| Node Type | Node Name | Group Name | Group State | State |
+-------------+-------------------+-------------------+-------------------+--------------+
| coordinator | 192.168.0.32:5101 | Coordinator | normal | primary |
| deployer | 192.168.0.32:5201 | Deployer | normal | normal |
| broker | 192.168.0.32:5301 | Broker | normal | leader |
| warehouse | 192.168.0.32:5401 | Group1 | normal | normal |
+-------------+-------------------+-------------------+-------------------+--------------+
mach@localhost:~$ machcoordinatoradmin --cluster-status-full
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
+-------------+-------------------+-------------------+-------------------+-------------------------------+-------------+
| Node Type | Node Name | Group Name | Group State | Desired & Actual State | RP State |
+-------------+-------------------+-------------------+-------------------+-------------------------------+-------------+
| coordinator | 192.168.0.32:5101 | Coordinator | normal | primary | primary | ----------- |
| deployer | 192.168.0.32:5201 | Deployer | normal | normal | normal | ----------- |
| broker | 192.168.0.32:5301 | Broker | normal | leader | leader | ----------- |
| warehouse | 192.168.0.32:5401 | Group1 | normal | normal | normal | ----------- |
+-------------+-------------------+-------------------+-------------------+-------------------------------
Output Cluster Information
Example:
mach@localhost:~$ machcoordinatoradmin --cluster-node
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Token Pid : 29245
Token Time : 1553153902646178
Modify Time : 1553154010296715
Modify Count : 8
Cluster Status : Service
Broker : 192.168.0.32:5301
Warehouse : 192.168.0.32:5401
Change Group State
Syntax:
machcoordinatoradmin --set-group-state=[ normal | readonly ] --group=group
Example:
mach@localhost:~$ machcoordinatoradmin --set-group-state=readonly --group=Group1
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Group Name: Group1
Flag : 1
mach@localhost:~$ machcoordinatoradmin --cluster-status
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
+-------------+-------------------+-------------------+-------------------+--------------+
| Node Type | Node Name | Group Name | Group State | State |
+-------------+-------------------+-------------------+-------------------+--------------+
| coordinator | 192.168.0.32:5101 | Coordinator | normal | primary |
| deployer | 192.168.0.32:5201 | Deployer | normal | normal |
| broker | 192.168.0.32:5301 | Broker | normal | leader |
| warehouse | 192.168.0.32:5401 | Group1 | readonly | normal |
+-------------+-------------------+-------------------+-------------------+--------------+
Output Host Resource
Syntax:
machcoordinatoradmin --host-resource-enable [--metric=metric] [host=host]
Example:
mach@localhost:~$ machcoordinatoradmin --host-resource-enable
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : HOST-RESOURCE
Value : ON
Format : text/plain
mach@localhost:~$ machcoordinatoradmin --get-host-resource
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Host Name : 192.168.0.32
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 14.0%
CPU IOWait Ratio : 0.0%
Memory Info :
Physical Memory Utilization : 99.1%
Virtual Memory Utilization : 98.6%
Network Info :
Receive Bytes(per second) : 42809
Receive Packets(per second) : 337
Transmit Bytes(per second) : 42885
Transmit Packets(per second) : 332
Disk Info :
/dev/sda1 : 87.4%
|-> 192.168.0.32:5101 /home/cumulus/coordinator1
|-> 192.168.0.32:5301 /home/cumulus/broker1
|-> 192.168.0.32:5401 /home/cumulus/warehouse_a1
Host Name : 192.168.0.33
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 2.0%
CPU IOWait Ratio : 0.0%
Memory Info :
Physical Memory Utilization : 46.9%
Virtual Memory Utilization : 22.8%
Network Info :
Receive Bytes(per second) : 12336
Receive Packets(per second) : 103
Transmit Bytes(per second) : 13500
Transmit Packets(per second) : 103
Disk Info :
/dev/sda1 : 64.2%
|-> 192.168.0.33:5101 /home/cumulus/coordinator2
|-> 192.168.0.33:5401 /home/cumulus/warehouse_a2
mach@localhost:~$ machcoordinatoradmin --get-host-resource --metric=cpu
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Host Name : 192.168.0.32
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 13.9%
CPU IOWait Ratio : 0.0%
Host Name : 192.168.0.33
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 1.9%
CPU IOWait Ratio : 0.0%
mach@localhost:~$ machcoordinatoradmin --get-host-resource --host=192.168.0.33
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Host Name : 192.168.0.33
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 2.0%
CPU IOWait Ratio : 0.0%
Memory Info :
Physical Memory Utilization : 46.9%
Virtual Memory Utilization : 22.8%
Network Info :
Receive Bytes(per second) : 12588
Receive Packets(per second) : 106
Transmit Bytes(per second) : 13330
Transmit Packets(per second) : 100
Disk Info :
/dev/sda1 : 64.2%
|-> 192.168.0.33:5101 /home/cumulus/coordinator2
|-> 192.168.0.33:5401 /home/cumulus/warehouse_a2
mach@localhost:~$ machcoordinatoradmin --host-resource-disable
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : HOST-RESOURCE
Value : OFF
Format : text/plain