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

USL Setup on Three Node Deployment on VM

Udayan Yaragattikar edited this page Jun 1, 2021 · 2 revisions

Execute each command on all the three nodes

Pre-Requisites Installation:

  1. Setup and Install third party software : Refer wiki Setup and Install third party software

  2. Install UDS and dependent rpms. You can find these rpms in any latest stable or main builds.

rpm -i http://cortx-storage.colo.seagate.com/releases/cortx/github/stable/centos-7.8.2003/206/prod/cortx_iso/udx-discovery-0.1.2-3.el7.x86_64.rpm

rpm -i http://cortx-storage.colo.seagate.com/releases/cortx/github/stable/centos-7.8.2003/206/prod/cortx_iso/uds-pyi-1.3.0-1.r10.el7.x86_64.rpm

  1. Fetch Machine ID of VM using Following Command:

$ cat /etc/machine-id

  1. Generate key material required for uds configuration:
  • Create directory for key material storage with required permission

install -d -m 0700 -o cortxub -g cortxub /var/csm/tls

  • Switch to user

su - cortxub

  • Then, as user cortxub, generate native key materila with required permissions:

(umask 0177 && openssl req -x509 -newkey rsa:4096 -keyout /var/csm/tls/native.key -nodes -out /var/csm/tls/native.crt -days 365 -subj '/C=/ST=/L=/O=/OU=/CN=/')

Note: Donot generate the key material on each node sepertely. Generate key material on one node and copy to other three nodes. So all three nodes have same key material

  1. Update configuration templates for each phase as given below:

    a. post_install

    b. prepare

    • Template file path: /opt/seagate/cortx/csm/conf/usl.prepare.tmpl.3-node
    • Replace template fields with their corresponding values:
      • Replace TMPL_MACHINE_ID_1 with machine-id of node-1. Refer Step 3.
      • Replace TMPL_MACHINE_ID_2 with machine-id of node-2. Refer Step 3.
      • Replace TMPL_MACHINE_ID_3 with machine-id of node-3. Refer Step 3.
      • Replace TMPL_CLUSTER_ID with with UUID of node.
    • Sample template for reference: usl.prepare.tmpl.3-node.sample

    b. config

    • Template file path: /opt/seagate/cortx/csm/conf/usl.config.tmpl.3-node
    • Replace template fields with their corresponding values:
      • Replace TMPL_MACHINE_ID_1 with machine-id of node-1. Refer Step 3.
      • Replace TMPL_MACHINE_ID_2 with machine-id of node-2. Refer Step 3.
      • Replace TMPL_MACHINE_ID_3 with machine-id of node-3. Refer Step 3..
      • Replace TMPL_CLUSTER_ID with with UUID of node.
    • Sample template for reference: usl.config.tmpl.3-node.sample

    b. init

    • Template file path: /opt/seagate/cortx/csm/conf/usl.init.tmpl.3-node
    • Replace template fields with their corresponding values:
      • Replace TMPL_MACHINE_ID_1 with machine-id of node-1. Refer Step 3.
      • Replace TMPL_MACHINE_ID_2 with machine-id of node-2. Refer Step 3.
      • Replace TMPL_MACHINE_ID_3 with machine-id of node-3. Refer Step 3.
      • Replace TMPL_CLUSTER_ID with with UUID of node.
    • Sample template for reference: usl.init.tmpl.3-node.sample
  2. Execute usl_setup mini provisioning steps

usl_setup post_install --config json:///opt/seagate/cortx/csm/conf/usl.post_install.tmpl.3-node

usl_setup prepare --config json:///opt/seagate/cortx/csm/conf/usl.prepare.tmpl.3-node

usl_setup config --config json:///opt/seagate/cortx/csm/conf/usl.config.tmpl.3-node

usl_setup init --config json:///opt/seagate/cortx/csm/conf/usl.init.tmpl.3-node