machcoordinatoradmin
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