Installation

4. Installation

4.0 Install Overview

Use following table for the installation process of SATHC, download the specific installation
package and prepare the CLI drivers needed.

4.1 Download SAT Package

There is a prerequisite to download the Storage Automation Tool package zip file at
https://w3.kyndryl.net/w3publisher/sat find section “Latest version”

4.2 SAT on Linux – Fresh install

This chapter describes steps to prepare Linux before installing CLI drivers and later SAT package.

All commands below must be prefixed with sudo if not able to become root.

1. Get Red Hat® Enterprise Linux® server, running x86-64 version 7.x “Infrastructure Server”
 Check version and type

www.ibm.com Licensed Material – Property of IBM Corporation 1

 Installation

 cat /etc/os-release

2. Register the server

 subscription-manager register
3. Attach a subscription
 subscription-manager attach --auto
4. Add Red Hat Optional Repository, if not added:
 To check existing run
 yum repolist
i. look for “rhel-7-server-optional-rpms/7Server/x86_64”
 To add Red Hat Optional Repository
 subscription-manager repos --enable rhel-7-server-optional-rpms
 subscription-manager repos --enable rhel-7-server-ansible-2.9-rpms
5. Install PERL dependencies, broken into multiple lines to make Cut’n’Paste easy
yum -y install perl-Archive-Extract perl-Archive-Zip
yum -y install perl-Authen-SASL perl-Capture-Tiny perl-Config-Tiny perl-DBI
yum -y install perl-Data-Dumper perl-Devel-StackTrace perl-File-Copy-Recursive
yum -y install perl-JSON perl-List-MoreUtils perl-Module-Runtime perl-Sub-Exporter
yum -y install perl-Switch perl-TermReadKey perl-Test-Exception perl-Test-Simple
yum -y install perl-Time-Piece perl-Try-Tiny perl-XML-Simple perl-Text-CSV
6. Install non-Perl dependencies, broken into multiple lines to make Cut’n’Paste easy
yum -y install sqlite-tcl expect lsof libgdiplus unixODBC dos2unix
7. Install Ansible binaries for Unified Data Collection
 yum -y install ansible python2-jmespath
8. Optionally, install 7zip and unzip/zip if not already present
 https://kyndryl.box.com/s/kz1ct0rbf3ezvvcay4frhx7oujffu7h6
 Download, unzip on SAT server and place “7za” into directory “/usr/bin”
cp package/linux/x64/7za /usr/bin
 NOTE: Without 7za present, SAT will not be able to send reports via email as encrypted
atchments .

9. Firewall is enabled on RHEL Server, open port 9443 for external access

www.ibm.com Licensed Material – Property of IBM Corporation 2

 Installation

 To check if firewall is running

systemctl status firewalld
 Add permanent rule:
firewall-cmd --permanent --zone=public --add-port=9443/tcp
firewall-cmd --reload

Now Server is ready for installing SAT, either

a. install CLI drivers not being SSH or REST, go to section “4.2.2 Installing CLI drivers
(Linux)”
b. install SAT, go to section “4.2.3 Installing SAT”

www.ibm.com Licensed Material – Property of IBM Corporation 3

 Installation

4.2.3 Installing SAT (Linux)

During install you will be prompted to enter

 TPC server details. If the username, password, or server is left blank, TPC server interaction will
be disabled.
 SMTP server details, if left blank sending of reports to local team and HWSWCMS will be disabled
 Account information for SAT, requiring BlueID which can be found at:
https://blueidp1.boulder.ibm.com:8443/BlueID/ListAccounts.html
 Organisation Name, which part of GTS this SAT install is used by.
 Additional Driver enablement required for devices not using SSH or REST. This is optional and can
be reconfigured later, see later in this section about install CLI drivers.
 Administrative UserID, those UserIDs who can manage and add more Users to SAT Web UI
All selections can be changed afterwards reconfiguration utility. For more details on reconfiguration, see
SAT User Guide Chapter 5.1 Reconfiguring SATHC (Web Gui Configuration Tool).

Quick Guidance:
 Chip/BlueID: BAC9999999
 Account name: SDE
 Location: Kyndryl
 Press enter to
o “identifier for this SATHC Health Check installation”
o “e-mail address reports should be sent from”
o Port to use, default to 9443
 Do you want to enable Storage Dashboard reporting: enter N, and configure post-install
 Select Geography where deployed
 Select EcuRep Server, 2, 4 or 5
 Commercial account: SDE
 Chip/BlueID: BAC9999999
 Select organization, typically IS

Detailed guidance with screenshots, to install SAT, you must perform:

1. Download latest ‘SAT’ package for Linux from SAT home page, either:
a. https://w3.kyndryl.net/w3publisher/sat
i. Scroll down to “SAT Guides and Releases”
b. Direct link to BOX: https://kyndryl.box.com/s/p4ld5b5qkhak3ltb4xi7w03t3rczxm0i
2. Push downloaded SAT install package to SAT Server
3. Go to /tmp and make a directory “SAT”.

www.ibm.com Licensed Material – Property of IBM Corporation 4

 Installation

a. cd /tmp
b. mkdir SAT
4. Extract SAT Linux package
a. cd SAT
b. unzip ../<SAT package name>
5. Go to TPCHealthCheck directory:
a. cd TPCHealthCheck
6. Install SAT by running
a. sh ./InstallSAT.sh

NOTE: Installer will check and verify dependencies have been met, if any pre-requisite are missing there
will be shown, and must be remediated before install is possible, see Section “4.3 SAT on Linux – Fresh
install”

NOTE: It is recommended to leave path as /opt/IBM/SAT, and not include any spaces in directory names,
which is not supported and might break SAT.

7. Enter Details of Spectrum Control (SC) and other specification as shown below, if having SC, if not,
press enter to skip

www.ibm.com Licensed Material – Property of IBM Corporation 5

 Installation

8. Enter port number for PDT web server OR select the default one (9443)

IBM PDT Web Server is also known as SAT Web GUI from which SAT is configured and controlled.

9. Select the geographic location of SATHC installation and ECUREP server for the selected geolocation.

Enter the commercial account and Blue ID.

Blue ID can be found: https://blueidp1.boulder.ibm.com:8443/BlueID/ListAccounts.html

www.ibm.com Licensed Material – Property of IBM Corporation 6

 Installation

10. Additional features of SAT being installed

www.ibm.com Licensed Material – Property of IBM Corporation 7

 Installation

11. Enter the user name(s) for role “SAT administrator”

a. Can be adjusted after install by running
i. /opt/IBM/SAT/bin/tools/satadmin.pl

NOTE:
User name(s) assigned to admin role during install, including domain must be entered in exactly
the same way as used when logging in to SAT Web interface. Below are examples of three
different users account, they may look the same, but they are not. SAT treats them as three
individual accounts:

robert@client_domain
client_domain\robert
robert (without any domain)

If needed, users can be corrected afterwards from CLI running /opt/IBM/SAT/bin/tools/satadmin.pl

12. Ensure installation is successful by running the following command

a. /opt/IBM/SAT/bin/tools/postcheck.pl script with root privileges to check known installation
issues, will be expanded on every release to check for known issues and provide guidance to
fix.
b. If entering wrong usernames during install it is possible to fix/correct running command
/opt/IBM/SAT/bin/tools/satadmin.pl tool

www.ibm.com Licensed Material – Property of IBM Corporation 8