Install the UAN Product Stream

This procedure installs the User Access Nodes (UAN) product on a system so that UAN boot images can be created.

Before performing this procedure:

  • Initialize and configure the Cray command line interface (CLI) tool. See “Configure the Cray Command Line Interface (CLI)” in the CSM documentation for more information.
  • Perform Prepare for UAN Product Installation

Replace PRODUCT_VERSION in the example commands with the UAN product stream string (2.3.0 for example). Replace CRAY_EX_DOMAIN in the example commands with the FQDN of the HPE Cray EX.

  1. Start a typescript to capture the commands and output from this installation.

    ncn-m001# script -af product-uan.$(date +%Y-%m-%d).txt 
    ncn-m001# export PS1='\u@\H \D{%Y-%m-%d} \t \w # '
    
  2. Run the installation script:

    ncn-m001# ./install.sh
    
  3. Verify that the UAN configuration was imported and added to the cray-product-catalog ConfigMap in the Kubernetes services namespace.

    1. Run the following command and verify that the output contains an entry for the PRODUCT_VERSION that was installed in the previous steps:

      ncn-m001# kubectl get cm cray-product-catalog -n services -o json | jq -r .data.uan
      PRODUCT_VERSION:
           configuration:
             clone_url: https://vcs.CRAY_EX_DOMAIN/vcs/cray/uan-config-management.git
             commit: 6658ea9e75f5f0f73f78941202664e9631a63726
             import_branch: cray/uan/PRODUCT_VERSION
             import_date: 2021-07-28 03:26:00.399670
             ssh_url: git@vcs.CRAY_EX_DOMAIN:cray/uan-config-management.git
      
    2. Verify that the Kubernetes jobs that import the configuration content completed successfully. Skip this step if the previous substep indicates that the new UAN product version content installed successfully.

      A STATUS of Completed indicates that the Kubernetes jobs completed successfully.

      ncn-m001# kubectl get pods -n services | grep uan
      uan-config-import-PRODUCT_VERSION-wfh4f                                  0/3     Completed   0          3m15s
      
  4. Verify that the UAN RPM repositories have been created in Nexus:

    PRODUCT_VERSION is the UAN release number and SLE_VERSION is the SLE release version, such as 15sp4 or 15sp3.

    Query Nexus through its REST API to display the repositories prefixed with the name uan:

    ncn-m001# curl -s -k https://packages.local/service/rest/v1/repositories | jq -r '.[] | select(.name | startswith("uan")) | .name'
    uan-PRODUCT_VERSION-sle-SLE_VERSION
    
  5. Finish the typescript file started at the beginning of this procedure.

    # exit
    
  6. Optional: Perform Merge UAN Configuration Data if a previous version of the UAN product was already installed.