Skip to content

Latest commit

 

History

History
139 lines (91 loc) · 4.6 KB

index.md

File metadata and controls

139 lines (91 loc) · 4.6 KB

Update CSM Product Stream

The software included in the CSM product stream is released in more than one way. The initial product release may be augmented with patches, documentation updates, or hotfixes after the release.

The CSM documentation is included within the CSM product release tarball inside the docs-csm RPM. After the RPM has been installed, the documentation will be available at /usr/share/doc/csm.

Download and Extract CSM Product Release

Acquire a CSM software release tarball for installation on the HPE Cray EX supercomputer.

  1. Download the CSM software release tarball for the HPE Cray EX system to a Linux system.

    linux# export ENDPOINT=URL_SERVER_Hosting_tarball
linux# export CSM_RELEASE=csm-x.y.z
linux# wget ${ENDPOINT}/${CSM_RELEASE}.tar.gz

  2. Extract the source release distribution.

    If doing a first time install, this can be done on a Linux system, but for an upgrade, it may be done on one of the NCNs, such as ncn-m001.

    linux# tar -xzvf ${CSM_RELEASE}.tar.gz

  3. Before using this software release, check for any patches available for it. If patches are available, see Apply Patch to CSM Release.

Apply Patch to CSM Release

Apply a CSM update patch to the release tarball. This ensures that the latest CSM product artifacts are installed on the HPE Cray EX supercomputer.

  1. Verify that the Git version is at least 2.16.5 on the Linux system which will apply the patch.

    The patch process is known to work with Git version 2.16.5 or higher. Older versions of Git may not correctly apply the binary patch.

    linux# git version

    Example output:

    git version 2.26.2

    If the Git version is less than 2.16.15, update Git to at least that version.

  2. Download the compressed CSM software package patch csm-x.y.z-x.z.a.patch.gz for the HPE Cray EX system.

    linux# export ENDPOINT=URL_SERVER_Hosting_tarball
linux# export CSM_RELEASE=csm-x.y.z
linux# export PATCH_RELEASE=x.z.a
linux# wget ${ENDPOINT}/${CSM_RELEASE}-${PATCH_RELEASE}.patch.gz

    Run the remaining steps from the node to which the original $CSM_RELEASE release was downloaded and extracted.

  3. Uncompress the patch.

    linux# gunzip -v ${CSM_RELEASE}-${PATCH_RELEASE}.patch.gz

  4. Apply the patch.

    linux# git apply -p2 --whitespace=nowarn \
                     --directory=${CSM_RELEASE} \
                     ${CSM_RELEASE}-${PATCH_RELEASE}.patch

  5. Set a variable to reflect the new version.

    linux# export NEW_CSM_RELEASE="$(./${CSM_RELEASE/lib/version.sh)"

  6. Update the name of the CSM release distribution directory.

    linux# mv -v $CSM_RELEASE $NEW_CSM_RELEASE

  7. Create a tarball from the patched release distribution.

    linux# tar -cvzf ${NEW_CSM_RELEASE}.tar.gz "${NEW_CSM_RELEASE}/"

This tarball can now be used in place of the original CSM software release tarball.

Check for Latest Documentation

Acquire the latest documentation RPM. This may include updates, corrections, and enhancements that were not available until after the software release.

  1. Check the version of the currently installed CSM documentation.

    linux# rpm -q docs-csm

  2. Download and upgrade the latest documentation RPM.

    linux# rpm -Uvh --force https://artifactory.algol60.net/artifactory/csm-rpms/hpe/stable/sle-15sp2/docs-csm/1.2/noarch/docs-csm-latest.noarch.rpm

    If this machine does not have direct internet access, then this RPM will need to be externally downloaded and copied to the system. This example copies it to ncn-m001.

    linux# wget https://artifactory.algol60.net/artifactory/csm-rpms/hpe/stable/sle-15sp2/docs-csm/1.2/noarch/docs-csm-latest.noarch.rpm -O docs-csm-latest.noarch.rpm
linux# scp -p docs-csm-*rpm ncn-m001:/root
linux# ssh ncn-m001
ncn-m001# rpm -Uvh --force docs-csm-latest.noarch.rpm

  3. Repeat the first step in this procedure to display the version of the CSM documentation after the update.

Check for Field Notices about Hotfixes

Collect all available field notices about hotfixes which should be applied to this CSM software release. Check with HPE Cray service for more information.