Install SCM Agent component on Linux

Products

CA Harvest Software Change Manager CA Harvest Software Change Manager - OpenMake Meister

Issue/Introduction

What are the exact steps to install the SCM Agent on a Redhat Linux computer?

Environment

CA Harvest SCM v13.x, v14.x, Redhat Linux

Resolution

This example assumes a new Redhat Linux (or Oracle Linux). The SCM install files will be pulled from the ISO disk image and will be copied to a temporary folder “/tmp/scm” from which the installation files will be staged.

Perform the first part of this installation while logged in as the “root” user.

Do a yum update and install prerequisite packages

Example:

yum update -y
yum install -y pam.*
yum install -y libstdc++.*
yum install -y libstdc++-devel.*
yum install -y ncurses.* 
yum install -y ncurses-libs.*
yum install -y ncurses-devel.*

# Note: When installing to RedHat v8.x and v9.x, you can use the "dnf" utility instead of "yum"

Mount the DVD image and copy the server install files to a temp folder.

Example:

mkdir /tmp/scm
cd /run/media/<userid>/<Installation DVD root folder name>/client/linux_x86_64/
cp *.gz /tmp/scm

Create the “cascm” user and group (or substitute your preferred "owner" userid for SCM instead of "cascm")

Example:
```
umask 0022
groupadd cascm
useradd -g cascm cascm
passwd cascm
```

Create a script that sets the environment variables and hook that into the “.bash_profile”. Check carefully the folder names listed in the example and change any of them to your preferred installation locations.

Example:

# Copy all lines from "cat >" to "EOF" and paste as one block.
cat > /home/cascm/set_env.sh <<EOF
#!/bin/bash

export CASHCOMP=/opt/CA/SharedComponents
export CABIN=\$CASHCOMP/bin
export CALIB=\$CASHCOMP/lib

export CAPKIHOME=\$CASHCOMP/CAPKI
export PATH=\$CABIN:\$PATH
export LD_LIBRARY_PATH=\$CALIB:\$LD_LIBRARY_PATH

export RTHOME=/opt/CA/pec
export PATH=\$RTHOME:\$PATH
export LD_LIBRARY_PATH=\$RTHOME/lib/i86_64_linux24:\$LD_LIBRARY_PATH

export CA_SCM_HOME=/opt/CA/scm
export PATH=\$CA_SCM_HOME/bin:\$PATH
export LD_LIBRARY_PATH=\$CA_SCM_HOME/lib:\$LD_LIBRARY_PATH
EOF
# -------------------------------------

# Change ownership and execute permissions for the setenv.sh script.  
# Again, if your preferred "owner" userid is not "cascm" make the needed adjustments.
chown cascm:cascm /home/cascm/set_env.sh
chmod a+x /home/cascm/set_env.sh

# Add a line to the end of the "owner" userid's .bash_profile (or .profile for Unix and AIX) to execute the set_env.sh script.
# Again, if your preferred "owner" userid is not "cascm" make the needed adjustments.
# Copy all lines from "cat >>" to "EOF" and paste as one block.
cat >> /home/cascm/.bash_profile <<EOF

. /home/cascm/set_env.sh
EOF
# -------------------------------------
# Note: When installing to Unix or AIX, change this last cat command to update the .profile instead of .bash_profile, like this:
# cat >> /home/cascm/.profile <<EOF
#
# . /home/cascm/set_env.sh
# EOF

Create the directories we'll need for installation and set ownership and permissions. Check carefully the folder names listed in the example and change any of them to your preferred installation locations.

Example:

mkdir -p /opt/CA/scm /opt/CA/pec /opt/CA/SharedComponents/lib /opt/CA/SharedComponents/bin
chown -R cascm:cascm /opt/CA/scm /opt/CA/pec /opt/CA/SharedComponents /tmp/scm
chmod -R 755 /opt/CA/scm /opt/CA/pec /opt/CA/SharedComponents /tmp/scm

6. *** For RHEL 8.x and 9.x *** Add a symbolic link from libncurses.so.6 to libncurses.so.5 for each occurrence of “libncurses.so.6”.

Example:

# Locate all copies of “libncurses.so.6”
find / -name "libncurses.so.6"

# Then, for each copy of “libncurses.so.6” that was found, cd to the folder it is in and execute 
ln -s libncurses.so.6 libncurses.so.5

Install CAPKI. Check carefully the folder names listed in the example and change any of them to your preferred installation locations.

Example:

export CASHCOMP=/opt/CA/SharedComponents
export CABIN=$CASHCOMP/bin
export CALIB=$CASHCOMP/lib

cd /tmp/scm/
mkdir etpki
mv etpki.tar.gz etpki
cd etpki/
gunzip etpki.tar.gz 
tar xvf etpki.tar 
cd etpki_linux/
./setup install caller=SCMAGENT verbose env=all

Perform the rest of this installation as the “cascm” user

Switch to the “cascm” user (or your preferred "owner" userid for SCM)

Example:
```
su - cascm
umask 0022
```

Install PEC. Check carefully the folder names listed in the example and change any of them to your preferred installation locations.

Example:

cd /tmp/scm/
mkdir pec
mv pec*.tar.gz pec
cd pec/
gunzip pec*.tar.gz 
tar xvf pec*.tar 
# If installing SCM v14.5 to RedHat v9.x, please see the note in "Additional Information" below.
# This next step fixes a glitch in the INSTALL.SH so that it runs under c-shell instead of korn shell.
sed -i 's/ksh/sh/g' INSTALL.SH
./INSTALL.SH configure_rtserver=false

Move the SCM agent installation tar file to “/opt/CA/scm”, unzip and install. Check carefully the folder names listed in the example and change any of them to your preferred installation locations.

Example:
```
cd /tmp/scm/

mv agentonly.tar.gz /opt/CA/scm
cd /opt/CA/scm
gunzip agentonly.tar.gz 
tar xvf agentonly.tar 
cd install/
./setup.sh
```

Additional Information

When installing SCM Agent and/or Client to Redhat v9.x, all of the above steps will work with one addition. You will need to login to the https://support.broadcom.com website, then navigate to this page: Redhat 9.x certification - Harvest V14.5 and download the file named "V145_linux.tar" file. Inside that archive is a file named INSTALL.SH. In step 9 above, after unzipping and untarring the pec474_64.tar.gz file, please replace the INSTALL.SH file there with the one from the "V145_linux.tar" file.