/
(1) MWA Installation

(1) MWA Installation

Owned by jake shin (Unlicensed)
Jul 04, 2022

Cluster Edition Installation (MWA) 


To install MWA, you need to unzip the package in the command-line environment.

Configuration

First, connect to the server, assuming you have the machbase / machbase account.

After that, configure environment for installation directory and path information.

export MACHBASE_HOME=~/coordinator
export PATH=$MACHBASE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$MACHBASE_HOME/lib:$LD_LIBRARY_PATH

Index



Create and Unzip Coordinator Directory

Create a directory set as $MACHBASE_HOME and unzip the package file into that directory.

# Create directory.
mkdir $MACHBASE_HOME

# Download installation package and copy to MACHBASE_HOME.
cp -f machbase-ent-x.x.x.official-LINUX-X86-64-release.tgz $MACHBASE_HOME

# Go to MACHBASE_HOME and unzip.
cd $MACHBASE_HOME
tar zxvf machbase-ent-x.x.x.official-LINUX-X86-64-release.tgz


MWA Settings for Cluster Edition Installation

The Cluster Edition installation requires many entries. MWA provides default values ​​for these items at installation time. 

This default value can be changed to the value you want.
Modify the necessary parts of the file $MACHBASE_HOME/webadmin/flask/MWA.conf and restart the MWA.

The default values ​​set in MWA.conf are as follows.

#################################################################################
# Default value in the node installation of cluster admin.
# - You can use $, # for the DEFAULT_[BROKER|WAREHOUSE]_HOME_PATH.
#   $ : Group Name
#   # : Warehouse index in same group
# - PORT_INCREMENT_VALUE           : When installing to a new group,
#                                    increase the port number by this value.
# - PORT_INCREMENT_VALUE_IN_GROUP  : When installing to an existing group,
#                                    increase the port number by this value.
# - CLUSTER_ADMIN_REFRESH_INTERVAL : Information update interval
#                                    for Cluster Admin (second)
#################################################################################
DEFAULT_COORDINATOR_SERVICE_PORT = 5100
DEFAULT_COORDINATOR_LINK_PORT    = 5101
DEFAULT_COORDINATOR_ADMIN_PORT   = 5102
DEFAULT_COORDINATOR_HOME_PATH    = /home/machbase/coordinator

DEFAULT_DEPLOYER_SERVICE_PORT    = 5200
DEFAULT_DEPLOYER_LINK_PORT       = 5201
DEFAULT_DEPLOYER_ADMIN_PORT      = 5202
DEFAULT_DEPLOYER_HOME_PATH       = /home/machbase/deployer

DEFAULT_BROKER_SERVICE_PORT      = 5656
DEFAULT_BROKER_LINK_PORT         = 5301
DEFAULT_BROKER_HOME_PATH         = /home/machbase/broker

DEFAULT_WAREHOUSE_SERVICE_PORT   = 5400
DEFAULT_WAREHOUSE_LINK_PORT      = 5401
DEFAULT_WAREHOUSE_REPL_PORT      = 5402

# Use if there is no same group in the server
DEFAULT_WAREHOUSE_HOME_PATH      = /home/machbase/warehouse_$
PORT_INCREMENT_VALUE             = 10
PORT_INCREMENT_VALUE_IN_GROUP    = 0

# Use if there is a same group in the server
#DEFAULT_WAREHOUSE_HOME_PATH      = /home/machbase/warehouse_$_w#
#PORT_INCREMENT_VALUE             = 100
#PORT_INCREMENT_VALUE_IN_GROUP    = 10

DEFAULT_SSH_USER_ID              = machbase
CLUSTER_ADMIN_REFRESH_INTERVAL   = 5
  • Installation folders for BROKER and WAREHOUSE can use $ and # as default values. 
  • $ Is replaced by the Group name, and # is replaced by the number of Warehouses in the Group.
  • PORT_INCREMENT_VALUE is the increment value of the port number when a Group is added. 
    If PORT_INCREMENT_VALUE is 10, each port number is increased by 10 each time a Group is added.
  • PORT_INCREMENT_VALUE_IN_GROUP is increment value of the port number when a Warehouse in the group is added. 
    If PORT_INCREMENT_VALUE_IN_GROUP is 10, each port number is incremented by 10 whenever a warehouse is added in the same group. 
    In practice, the Warehouse of the same Group are rarely installed on one server, so it is mainly used for testing purposes.
  • DEFAULT_SSH_USER_ID is the default value of the ID used for SSH connection. 
    Since Coordinator and Deployer installation requires SSH connection, the default SSH ID and Password are used during installation.
  • CLUSTER_ADMIN_REFRESH_INTERVAL is the number of seconds to check the status of the cluster in Cluster Admin. 
    MWA connects to the coordinator on this value basis to retrieve the status of the cluster.

If it starts with #, it is recognized as a comment.


Run WMA Service

If the following command is used to run the MWA service, the service connection address will be output.

# Move to directory
cd $MACHBASE_HOME/bin

# Run MWA service
MWAserver start


MWA Service Connection

Open the browser and connect to the output address and port.

The initial web login account information is admin / machbase.