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

USL Setup on Single Node Deployment on VM

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

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=/')

  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.1-node
    • Replace template fields with their corresponding values:
      • Replace TMPL_MACHINE_ID with machine-id of node. Refer Step 3.
      • Replace TMPL_CLUSTER_ID with with UUID of node.
    • Sample template for reference: usl.prepare.tmpl.1-node.sample

    b. config

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

    b. init

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

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

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

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

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