Skip to content
This repository was archived by the owner on Feb 8, 2024. It is now read-only.

cortx py utils multi node manual provisioning

Jump to bottom
Rahul Tripathi edited this page Sep 7, 2021 · 31 revisions

Pre-Requisites

Kafka Server (on all the nodes)

  • Kafka server has been installed at path /opt/kafka. Kafka configuration is complete and it is running. For more details refer Kafka setup. Note that kafka may not be installed on all the nodes in CORTX cluster.

Required python packages (on all the nodes)

Refer required python packages from list 1 and list 2 to get the list of required python packages. (Use the above mentioned requirements files in the same order).
Download these files and use below commands to install these python packages
# sudo pip3 install -r <local-path>/python_requirements.txt
# sudo pip3 install -r <local-path>/python_requirements.ext.txt

Install cortx-py-utils rpm (on all nodes in the CORTX cluster)

Get the rpm.
#yum install -y cortx-py-utils-2.0.0-90_8b3c613.noarch.rpm <== RPM name would be different

Mini Provisioning steps

Post Install (on all nodes)

  • Edit this template and store the filled in value /tmp/utils.post_install.tmpl.3-node
  • server_node>TMPL_MACHINE_ID ==> This indicates the unique machine ID of the local system.
  • server_node>TMPL_MACHINE_ID>hostname ==> This indicates the hostname of the local system.
  • server_node>TMPL_MACHINE_ID>name ==> This indicates the name of node eg. srvnode-1, srvnode-2, etc.
  • Run config command
    /opt/seagate/cortx/utils/bin/utils_setup post_install --config yaml:///tmp/utils.post_install.tmpl.3-node

Config (on all nodes)

  • Edit this template and store the filled in value /tmp/utils.config.tmpl.3-node
  • cortx>software>common>message_bus_type ==> This indicates message bus type. Currently only "kafka" is supported.
  • cortx>software>kafka>servers ==> This key holds an array of values. Each value is of type "server-FQDN":"port". Port is optional.
  • server_node>TMPL_MACHINE_ID ==> This indicates the unique machine ID of the local system.
  • server_node>TMPL_MACHINE_ID>site_id ==> A numeric string value identifies a single data center site. For ex: "1"
  • server_node>TMPL_MACHINE_ID>rack_id ==> A numeric string value that identifies a single Rack in a single site. For ex: "1"
  • server_node>TMPL_MACHINE_ID>node_id ==> A numeric string value that indicates node ID (UUID). For ex: "1"
  • Run config command
    /opt/seagate/cortx/utils/bin/utils_setup config --config yaml:///tmp/utils.config.tmpl.3-node
    NOTE: Config creates /etc/cortx/message_bus.conf and /etc/cortx/cluster.conf

Init (on a single node only)

  • Edit this template and store the filled in value /tmp/utils.init.tmpl.3-node

  • Run init command
    /opt/seagate/cortx/utils/bin/utils_setup init --config yaml:///tmp/utils.init.tmpl.3-node

Test (on a single node only)

  • Run the test command
    /opt/seagate/cortx/utils/bin/utils_setup test --plan sanity

  • In test phase, with sanity as a plan argument, it will run the sanity test cases present in py-utils-test.

refer Procedure to run tests

Reset (on a single node only)

  • Edit this template and store the filled in value /tmp/utils.reset.tmpl.3-node

  • Run the reset command
    /opt/seagate/cortx/utils/bin/utils_setup reset --config yaml:///tmp/utils.reset.tmpl.3-node

  • In reset phase:

  • It deletes all messages from all message_types from all clustered nodes
  • Clears all log files from '/var/log/cortx/utils/' directory.

Cleanup (on all the nodes)

  • Edit this template and store the filled in value /tmp/utils.cleanup.tmpl.3-node

  • Run the cleanup command
    /opt/seagate/cortx/utils/bin/utils_setup cleanup --config yaml:///tmp/utils.cleanup.tmpl.3-node

  • In cleanup phase:

  • It deletes all message_types from nodes
  • It deletes the config files created by config phase

Clone this wiki locally