Harvest 14.5 and 14.5.01 installation on AIX, Linux and zLinus

Products

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

Issue/Introduction

What are the exact steps to install SCM v14.5 and 14.5.01 on an AIX, Linux and zLinus platforms?

Environment

Harvest Software Change Manager v14.5 and 14.5.01

Resolution

Create the “cascm” user and group
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”.
NOTE: Be sure to update these folder names to conform to your system requirements. Especially, your ORACLE_HOME environment variable should reflect the home folder for your Oracle installation. Harvest SCM v14.5 is only available as a 32-bit application for AIX, so for AIX the 32-bit version of Oracle Client or Server will be needed.

Example (Copy and paste everything from the "cat >" line to the "EOF" line 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 ORACLE_HOME=/app/oracle/product/19.0.0/dbhome_1
export ORACLE_SID=orcl
export PATH=\$ORACLE_HOME/bin:\$PATH
export LIBPATH=\$ORACLE_HOME/lib:$LIBPATH
export CAPKIHOME=\$CASHCOMP/CAPKI
export PATH=\$CABIN:\$PATH
export LIBPATH=\$CALIB:\$LIBPATH
export ODBC_HOME=/opt/CA/odbc
export RTHOME=/opt/CA/pec
export PATH=\$RTHOME:\$PATH
export LIBPATH=\$RTHOME/lib/rs6000_aix:\$LIBPATH
export CA_SCM_HOME=/opt/CA/scm
export PATH=\$CA_SCM_HOME/bin:\$PATH
export LIBPATH=\$CA_SCM_HOME/lib:\$LIBPATH
EOF

# Once you have the new script, you must change ownership and permissions to make it executable
chown cascm:cascm /home/cascm/set_env.sh
chmod a+x /home/cascm/set_env.sh

# After this you will need to add a line to the cascm user's .bash_profile to execute this script at startup. 
# (Copy and paste everything from the "cat >>" line to the "EOF" line as one block)
cat >> /home/cascm/.bash_profile <<EOF
. /home/cascm/set_env.sh
EOF

Create the directories we'll need for installation and set ownership and permissions.

Example:

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

Install CAPKI

Example:

cd /tmp/scm/ETPKI
tar xvf etpki_aix.tar 
cd etpki_aix/
./setup install caller=SCMSERVER verbose env=all

Install ODBC

Example:

# Make sure umask is set correctly and set the needed environment variables.  As with the setEnv.sh script above, 
# ensure that the folder names for these variables are correct for your environment.
umask 0022
export ODBC_HOME=/opt/CA/odbc
export ORACLE_HOME=/app/oracle/product/19.0.0/dbhome_1
export ORACLE_SID=orcl

# This step is different from installations of prior versions of Harvest.  You will ocpy the odbc.tar.gz file to the folder that 
# you want to become the parent of the new "odbc" folder, extract it there, and then run the installation.
cd /tmp/scm/odbc
tar xvf odbc.tar
cd odbc
./install.sh
chown -R cascm:cascm /opt/CA/odbc

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

Switch to the “cascm” user

Example:
```
su - cascm
umask 0022
```
Check to make sure Oracle database is accessible via TNS

Example:
```
sqlplus <userid>@<tns service name>
```

Install PEC

Example:

cd /tmp/scm/pec
tar xvf pec.tar 
./INSTALL.SH configure_rtserver=false

Move the SCM installation tar file to “/opt/CA/scm”, unzip and install. At the end of the installation, answer "N" (no) to the question of whether to automatically start the hdbsetup utility.

Example:
```
cd /tmp/scm/
mv scm.tar /opt/CA/scm
cd /opt/CA/scm
tar xvf scm.tar 
cd install/
./install.sh
```
NOTE: Select option 1 for a new installation
Unzip the v14.5.01 Cumulative patch zip file.

Example:
```
cd /tmp/scm/
unzip Aix32.zip
```

Install the v14.5.01 Cumulative patch Server Module

Example:

tar xvf CAHarvestSCMV145_01Patch_Server.tar
cd CAHarvestSCMV145_01Patch_Server/
umask 0022
./ApplyServerPATCH.sh

Now we can run “hdbsetup” to configure the ODBC datasource (options CO, CR, EP, LP, and LF options)

Example:
```
cd /opt/CA/scm/bin/
./hdbsetup
```
Try to start the broker to see if it runs. Run a command line utility to confirm it can connect.

Example:
```
./bkrd
ps -ef | grep "bkrd\|hserver\|rtserver"
hgetusg -b <broker hostname> -prompt -cu ; cat hgetusg.log
```

Additional Information

Note that on AIX, Harvest is built as a 32-bit application. While this does not prevent it running on a 64-bit AIX server, it does mean that the Oracle client installed as a prerequisite must also be the 32-bit version of the software for the version of Oracle you need. See Oracle documentation for downloading details.

Release notes for the Harvest 14.5 installation can be found here: Release Notes

A "Getting Started" guide is found here: Get Started with CA Harvest SCM Implementation

Additional installation details can be found here: Install CA Harvest SCM on UNIX, Linux, and zLinux